쿠팡 포스트백 연동

본 가이드는 쿠팡 집행을 위한 포스트백 연동 및 리포트 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	이벤트 발생 시간 (Epoch Time)	Y	1751347045
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	이벤트 발생 시간 (Epoch Time)	Y	1751347045
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

전체 매크로 리스트

매크로는 { 로 시작하고 } 로 종료되고, 변수와 함수로 구분됩니다 함수 설명은 아래에서 계속됩니다. http://my.pc.com/conversion?bid={bid}&event_name={event_name:upper}&event_items={event_items:b64_encode,url_encode}

매크로명	설명	비고
bid, bidid, bid_id	unique 클릭 ID
sub, subid, sub_id	매체 구분용 코드
adid	Google Advertising Identifier
idfa	Identifier for Advertisers
pkg, package, package_name	패키지명	com.coupang.mobile
event_name	이벤트명	order, cancel
event_items	order_id 기준 구매 내역 리스트
event_time	이벤트 발생시간	yyyyMMddHHmmss
event_time_epoch	이벤트 발생시간	epoch time
orderid, order_id	주문번호
product_name	상품명
currency	통화
revenue	구매 내역 리스트의 총 합계 금액	주문취소 시 -금액
price	상품가격
quantity	수량
adid|idfa	adid 또는 idfa
PurchaseComplete|Cancel	PurchaseComplete 또는 Cancel

함수 사용 시 매크로명 뒤에 :함수명 , , 로 구분하여 여러번 함수 호출 가능 (순서대로 호출) {event_items:b64_encode,url_encode}

함수명	설명
upper	모두 대문자로 변경	order => ORDER
lower	모두 소문자로 변경	CANCEL => cancel
b64_encode	base64로 인코딩
url_encode	url 인코딩