쿠팡 포스트백 연동

본 가이드는 쿠팡 집행을 위한 포스트백 연동 및 리포트 API 가이드입니다.

1. 트래킹 링크

애드팝콘 SSP 사업팀이 제공하는 아래 형태의 트래킹 링크를 사용하여 캠페인 집행 시, 포스트백을 전달해 드립니다.

• https://link.coupang.com/re/AFFGOLDBOX?lptag=AF1036751&subid={subid}&subparam={bid}&publisherid={publisher_id}&adid={adid}&idfa={idfa}

Parameter	설명	필수	예시
subid	매체 구분용 코드(애드팝콘 SSP 사업팀에서 일괄 발급하여, 하드코딩하여 사용)	Y	CPSep1
bid	매체에서 포스트백 전달 받을 때, 돌려받고자 하는 unique 클릭 id	N	202010080823393754d2bf4
publisher_id	매체의 퍼블리셔 id	N	com.test.app
adid	google advertising ID	N	8C6CBCOD-5F43-4765-A6E6-84DFF3D24707
idfa	Identifier For Advertising	N	8C6CBCOD-5F43-4765-A6E6-84DFF3D24707

2. 이벤트 포스트백

위 트래킹 링크를 통해 발생한 구매, 취소 이벤트에 대해 아래와 같은 정보를 포스트백으로 전달해 드립니다.

아래 두 가지 예시 중 원하시는 포스트백 형태를 선택하신 뒤 endpoint를 전달해 주시기 바랍니다.

1) 각 상품 별 개별 포스트백

• https://{매체포스트백endpoint}?subid={subid}&bid={bid}&order_id={order_id}&product_id={product_id}&price={price}&quantity={quantity}&event_name={event_name}&datetime={datetime}&currency={currency}&adid={adid}&idfa={idfa}

파라미터	설명	필수	예시
subid	매체 구분용 코드(애드팝콘 SSP 사업팀에서 일괄 발급하여, 하드코딩하여 사용됨)	Y	CPSep1
bid	매체에서 포스트백 전달 받을 때, 돌려받고자 하는 unique 클릭 id	N	202010080823393754d2bf4
adid	클릭 발생한 adid	N	84757519-71fc-426b-89fc-97599c13fdfd
idfa	클릭 발생한 idfa	N	ABC12385-0000-45A6-1244-E7F83B5ACD15
event_name	이벤트 타입	Y	'order', 'cancel'
datetime	이벤트 발생 시간	Y	20210815
revenue	총 가격(수량x가격)	N	100000
$price	가격	Y	1000
$quantity	수량	Y	1
$currency	통화	Y	'KRW', 'USD'
$order_id	주문 번호	Y	12345678
$product_name	상품 번호	Y	614562857

2) 주문 번호 별 포스트백

• https://{매체포스트백endpoint}?subid={subid}&bid={bid}&event_items={event_items}&event_name={event_name}&datetime={datetime}&adid={adid}&idfa={idfa}

파라미터	설명	필수	예시
subid	매체 구분용 코드(애드팝콘 SSP 사업팀에서 일괄 발급하여, 하드코딩하여 사용됨)	Y	CPSep1
bid	매체에서 포스트백 전달 받을 때, 돌려받고자 하는 unique 클릭 id	N	202010080823393754d2bf4
adid	클릭 발생한 adid	N	84757519-71fc-426b-89fc-97599c13fdfd
idfa	클릭 발생한 idfa	N	ABC12385-0000-45A6-1244-E7F83B5ACD15
datetime	이벤트 발생 시간	Y	20210815
event_name	이벤트 타입	Y	'order', 'cancel'
revenue	event_items 내 수량x가격 총합	N	1000000
event_items	order_id 기준 구매 내역 리스트	Y	[{ "$product_name":"614562857", "$order_id ":"12345678", "$currency":"KRW", "$quantity":3, "$price":1000 }]
event_items.$price	event_items 내 item 가격	Y	1000
event_items.$quantity	event_items 내 item 수량	Y	1
event_items.$currency	event_items 내 item 통화	Y	'KRW', 'USD'
event_items.$order_id	event_items 내 item 주문 번호	Y	12345678
event_items$product_name	event_items 내 item 상품 번호	Y	614562857