> 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/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"
}
```