Appendix

1. Feedback - Win Notice, Loss Notice

• 특정 Auction에 참여한 여러 Bidder 중 Winner에게 Win Notice를 비동기 방식으로 발송한다. (여기서 비동기란 전체 플로우에서 Win Notice 후 응답을 기다리지 않고 무시하는 것을 의미함)

• Bid Response의 “nurl”, “lurl” 속성에 포함되는 URL로 발송한다.

• nurl, lurl 속성값에 아래 Substitution Macros가 포함되어 있다면 해당 매크로를 특정 값으로 대체(변환)해서 발송한다.

• 128 bit AES key를 반드시 설정해야 한다.

• 해당 win notice macro는 adm 속성값에 포함 가능하다.

2. Substitution Macros

Bid Response의 nurl, lurl or adm 속성값에 포함된 Macrocs를 적당한 값으로 대체합니다.

Macro	대체값
${AUCTION_ID}	ID of the bid request; from BidRequest.ID attribute
${AUCTION_PRICE}	Settlement price using the same currency and units as the bid. (소재단에서 암호화된 값으로 지원)
${AUCTION_MIN_TO_WIN}	Minimum bid to win the exchange's auction, using the same currency and units as the bid.
${AUCTION_LOSS}	Loss reason codes. Refer to List: Loss Reason Codes in OpenRTB 3.0

3. SKAdNetwork ID (iOS Only)

퍼블리셔의 info.plist에 skadnetwork ID가 등록되어야 합니다.

Object : BidRequest.imp.ext.skadn

Attribute	Type	Default	Description
version	string array	2.0,2.1,2.2,3.0,4.0	Version of SKAdNetwork
sourceapp	string	362057947	iOS app id
skadnetids	string array		퍼블리셔 App의 info.plist내 SKAdNetworkItem 하위 skadnetids 리스트
skadnetlist	object		skadnetlist를 의미, addl값 전달
productpage	integer	1

Object : BidRequest.imp.ext.skadn.skadnetlist

Attribute	Type	Default	Description
addl	string array		SKAdNetwork IDs 목록

Object : BidReponse.bid.ext.skadn

Attribute	Type	Default	Description
version	string array	4.0	Version of SKAdNetwork
network	string
sourceidentifier	string array
itunesitem	object		ID of advertiser’s app in Apple’s app store
fidelities	integer		fidelity, nonce, timestamp, signature 값 전달
sourceapp	string	362057947	iOS app id

Object : BidReponse.bid.ext.skadn.fidelities

Attribute	Type	Default	Description
fidelity	integer	0
nonce	string
timestamp	string
signature	string		SKAdNetwork signature as specified by Apple

4. Audience Matching

Web과 In-APP(미정) 은 별도 프로세스를 통해서 광고 Audience 매칭을 수행합니다.

Web Context

일반적인 웹 서비스에서의 쿠키 매칭 프로세스는 아래와 같다.

1. kakao는 Partner 사에게 아래와 같은 형태의 URL을 제공한다. (응답 형식: 1x1 이미지 OR 빈 응답값) https://analytics.ad.daum.net/match?d={dsp_id}&uid={partner_uid}

2. Partner 사는 사전에 Audience Matching이 가능한 서비스 페이지 또는 광고주 페이지 등에 미리 해당 URL을 비콘(ex> img tag) 형태로 설치한다. (RTB 연동 최소 2~3주 전)

3. 사용자 브라우저에서 해당 URL로 partner_uid 값과 함께 kakao로 요청한다. (partner_uid 값 중 특수문자가 포함되어 있다면, uid 파라미터는 urlencode 처리되어 호출되어야 함)

4. kakao는 사용자 브라우저에 kakaohost 도메인으로 partner_uid의 해당하는 쿠키를 발급한다.

5. kakao는 Partner에게 Bid Request 시에 user.id 필드에 partner_uid를 포함해서 요청한다. (cf. partner_uid가 없다면 요청이 제한될 수 있음)