전환 측정 API 연동
이 문서는 광고 전환 이벤트를 타 플랫폼과 S2S 방식으로 연동하기 위한 API 프로토콜 정의를 제공합니다.
도메인 및 Token은 별도로 제공됩니다.
기본 정보
API 연동 정보
개발
별도 제공
POST
상용
별도 제공
POST
전환 이벤트
signup
회원가입
사용자가 계정을 생성한 경우
N
view
상품 조회
상품 상세 페이지에서 상품을 본 경우
Y
purchase
상품 구매
상품 결제까지 완료한 경우
Y
install
앱 설치
사용자가 앱스토어에서 앱을 다운로드하고 설치한 경우
N
open
앱 실행
설치 후 앱을 처음 실행한 경우
N
cart
장바구니 담기
상품 상세 페이지에서 ‘장바구니 담기’ 버튼 클릭 시
Y
like
상품 찜하기
상품 상세 페이지에서 ‘찜(하트)’ 버튼 클릭 시
N
cancel
주문 취소
상품 구매 후 해당 건을 취소한 경우
Y
요청
헤더
Authorization
전달받은 토큰을 헤더에 삽입
Authorization: Bearer {TOKEN}
Y
쿼리
sub_campaign
클릭시 플랫폼으로 전달한 값을 그대로 반환
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
Y
google_aid
GAID 디바이스 식별자
7c19df6e-81ba-45f0-bee9-719a2d95236
Y
ios_ifa
IDFA 디바이스 식별자
AEBE52E7-03EE-455A-B3C4-E57283966239
Y
language
사용자 기기 언어 설정
KO
N
os_version
사용자 기기의 OS 버전
15
N
device_carrier
사용자 기기의 통신사
SKTelecom
N
device_brand
사용자 기기의 제조사
samsung
N
device_model
사용자 기기의 모델명
SM-G991N
N
device_ip
사용자 기기의 IP 주소
127.0.0.1
N
country_code
사용자 국가 코드
KR
N
package_name
앱 패키지명
com.cjmezzomedia
Y
click_timestamp
클릭 발생 시각 (UTC)
1234567890
Y
event_name
전환 이벤트명
purchase
Y
event_timestamp
전환 발생 시각 (UTC)
1234567890
Y
item_info
상품 정보 (JSON body)
아래 상품 정보 참조
Y
currency
통화 단위
KRW
N
is_reattributed
기존 설치 사용자의 재유입 여부
0(false), 1(true)
N
is_reengagement
기존 사용자의 이벤트 재참여 여부
0(false), 1(true)
N
is_retargeting
리타겟팅 캠페인을 통한 전환 여부
0(false), 1(true)
N
google_ad_tracking
광고 추적 제한 여부 (Google)
0(false), 1(true)
N
ios_ad_tracking
광고 추적 제한 여부 (iOS)
0(false), 1(true)
N
conversion_user_agent
전환 발생 user agent
Mozilla/5.0 (Linux; Android 13; SM-G981B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Mobile Safari/537.36
N
본문
item_info
상품 정보
상품과 관련된 이벤트 : 필수
( 구매, 장바구니, 상품보기, 취소 등 )
응답
200
SUCCESS
408
ERROR_TIMEOUT
501
ERROR_INVALID_TOKEN
502
ERROR_INVALID_PARAMETER
999
ERROR_SYSTEM
Last updated