# 전환 측정 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.