쿠팡 포스트백 연동

본 가이드는 쿠팡 집행을 위한 포스트백 연동 및 리포트 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

Last updated