> For the complete documentation index, see [llms.txt](https://docs.targetpick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.targetpick.io/targetpick_eng/measurement.md).

# 전환 측정 API 연동

{% hint style="info" %}
도메인 및 Token은 별도로 제공됩니다.
{% endhint %}

## 기본 정보 <a href="#basic" id="basic"></a>

### API 연동 정보 <a href="#api" id="api"></a>

| 환경 | URL   | 메서드  |
| -- | ----- | ---- |
| 개발 | 별도 제공 | POST |
| 상용 | 별도 제공 | POST |

### 전환 이벤트 <a href="#event" id="event"></a>

<table><thead><tr><th width="145.6484375">이벤트명</th><th width="173.18359375">설명</th><th width="386">발생 조건</th><th>필수</th></tr></thead><tbody><tr><td>signup</td><td>회원가입</td><td>사용자가 계정을 생성한 경우</td><td>N</td></tr><tr><td>view</td><td>상품 조회</td><td>상품 상세 페이지에서 상품을 본 경우</td><td>Y</td></tr><tr><td>purchase</td><td>상품 구매</td><td>상품 결제까지 완료한 경우</td><td>Y</td></tr><tr><td>install</td><td>앱 설치</td><td>사용자가 앱스토어에서 앱을 다운로드하고 설치한 경우</td><td>N</td></tr><tr><td>open</td><td>앱 실행</td><td>설치 후 앱을 처음 실행한 경우</td><td>N</td></tr><tr><td>cart</td><td>장바구니 담기</td><td>상품 상세 페이지에서 ‘장바구니 담기’ 버튼 클릭 시</td><td>Y</td></tr><tr><td>like</td><td>상품 찜하기</td><td>상품 상세 페이지에서 ‘찜(하트)’ 버튼 클릭 시</td><td>N</td></tr><tr><td>cancel</td><td>주문 취소</td><td>상품 구매 후 해당 건을 취소한 경우</td><td>Y</td></tr></tbody></table>

## 요청 <a href="#request" id="request"></a>

### 헤더 <a href="#header" id="header"></a>

<table><thead><tr><th>파라미터</th><th width="214.1484375">설명</th><th width="269.25">예시</th><th>필수</th></tr></thead><tbody><tr><td>Authorization</td><td>전달받은 토큰을 헤더에 삽입</td><td>Authorization: Bearer {TOKEN}</td><td>Y</td></tr></tbody></table>

### 쿼리 <a href="#query" id="query"></a>

<table><thead><tr><th width="164.87109375">파라미터</th><th>설명</th><th width="346.1171875">예시</th><th>필수</th></tr></thead><tbody><tr><td>sub_campaign</td><td>클릭시 플랫폼으로 전달한 값을 그대로 반환</td><td>splus2_tracking%5E1504%5E31778%5E805378%5E3%5E23191%5E11973%5E27169%5E27167%5E%5E%5E%5E%5E-%5E-%5E-1%5E-%5E14%5E1%5Esamsung%5E1%5ESM-G991N%5E778e5ef6-f063-4a37-87c2-61bd6b407112%5E0b6eeafc-47dc-4f7f-b3b4-ecc73f8b123d%241237396897%24ESFSVVWN%5E%5E%5E1%5E-%5Ecom.cjmezzomedia</td><td>Y</td></tr><tr><td>google_aid</td><td>GAID 디바이스 식별자</td><td>7c19df6e-81ba-45f0-bee9-719a2d95236</td><td>Y</td></tr><tr><td>ios_ifa</td><td>IDFA 디바이스 식별자</td><td>AEBE52E7-03EE-455A-B3C4-E57283966239</td><td>Y</td></tr><tr><td>language</td><td>사용자 기기 언어 설정</td><td>KO</td><td>N</td></tr><tr><td>os_version</td><td>사용자 기기의 OS 버전</td><td>15</td><td>N</td></tr><tr><td>device_carrier</td><td>사용자 기기의 통신사</td><td>SKTelecom</td><td>N</td></tr><tr><td>device_brand</td><td>사용자 기기의 제조사</td><td>samsung</td><td>N</td></tr><tr><td>device_model</td><td>사용자 기기의 모델명</td><td>SM-G991N</td><td>N</td></tr><tr><td>device_ip</td><td>사용자 기기의 IP 주소</td><td>127.0.0.1</td><td>N</td></tr><tr><td>country_code</td><td>사용자 국가 코드</td><td>KR</td><td>N</td></tr><tr><td>package_name</td><td>앱 패키지명</td><td>com.cjmezzomedia</td><td>Y</td></tr><tr><td>click_timestamp</td><td>클릭 발생 시각 (UTC)</td><td>1234567890</td><td>Y</td></tr><tr><td>event_name</td><td>전환 이벤트명</td><td>purchase</td><td>Y</td></tr><tr><td>event_timestamp</td><td>전환 발생 시각 (UTC)</td><td>1234567890</td><td>Y</td></tr><tr><td>item_info</td><td>상품 정보 (JSON body)</td><td>아래 상품 정보 참조</td><td>Y</td></tr><tr><td>currency</td><td>통화 단위</td><td>KRW</td><td>N</td></tr><tr><td>is_reattributed</td><td>기존 설치 사용자의 재유입 여부</td><td>0(false), 1(true)</td><td>N</td></tr><tr><td>is_reengagement</td><td>기존 사용자의 이벤트 재참여 여부</td><td>0(false), 1(true)</td><td>N</td></tr><tr><td>is_retargeting</td><td>리타겟팅 캠페인을 통한 전환 여부</td><td>0(false), 1(true)</td><td>N</td></tr><tr><td>google_ad_tracking</td><td>광고 추적 제한 여부 (Google)</td><td>0(false), 1(true)</td><td>N</td></tr><tr><td>ios_ad_tracking</td><td>광고 추적 제한 여부 (iOS)</td><td>0(false), 1(true)</td><td>N</td></tr><tr><td>conversion_user_agent</td><td>전환 발생 user agent</td><td>Mozilla/5.0 (Linux; Android 13; SM-G981B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Mobile Safari/537.36</td><td>N</td></tr></tbody></table>

### 본문 <a href="#body" id="body"></a>

<table><thead><tr><th width="199.44921875">파라미터</th><th width="202.0234375">설명</th><th>필수</th></tr></thead><tbody><tr><td>item_info</td><td>상품 정보</td><td><p>상품과 관련된 이벤트 : 필수</p><p>( 구매, 장바구니, 상품보기, 취소 등 )</p></td></tr></tbody></table>

```
{
  "item_info": {
    "order_id": "1234",                // 주문번호 (Purchase, Cancel 이 아닐 경우 키제거 or 값 공백 )
    "revenue": 30000,                // 주문 총금액 (실 유저 구매 금액 )
    "item": [
      {
        "product_id": "prd01",         // 상품코드
        "category_code": "CATE01",    // 카테고리 코드
        "brand_code": "BRAND01",        // 브랜드 코드
        "price": 10000,                // 상품 단가
        "discount": 1000,                // 할인 금액
        "qty": 1                        // 수량
      },
      {
        "product_id": "prd02",
        "category_code": "CATE02",
        "brand_code": "BRAND02",
        "price": 31000,
        "discount": 0,
        "qty": 1
      }
    ]
  }
}
```

## 응답 <a href="#response" id="response"></a>

| 코드  | 설명                        |
| --- | ------------------------- |
| 200 | SUCCESS                   |
| 408 | ERROR\_TIMEOUT            |
| 501 | ERROR\_INVALID\_TOKEN     |
| 502 | ERROR\_INVALID\_PARAMETER |
| 999 | ERROR\_SYSTEM             |

```
{
  "code": 200,
  "message": "SUCCESS"
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.targetpick.io/targetpick_eng/measurement.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.