Appendix

1. Feedback - Win Notice, Loss Notice

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

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

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

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

2. Substitution macros

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

• 128 bit AES key (AES/ECB) 를 설정하는 경우, 소재 내 포함된 url 내 ${AUCTION_PRICE} 암호화를 지원합니다.

  • AES key를 설정하여도, S2S로 호출하는 notiUrl 내 가격 macro는 암호화하지 않습니다.

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. (128 bit AES key (AES/ECB)를 설정하는 경우 소재단에서 암호화된 값으로 지원)
${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

2-1. kakao Custom Loss reason codes

500 미만의 Value는 iab에서 정의한 값을 따릅니다.

Value	Definition	kakao Definition
501	DUPLICATED_CREATIVE_ID	중복 광고 제거 설정이 켜져 있는 지면에 대해 중복 광고가 내려온 경우
502	INVALID_DYNAMIC_CREATIVE	외부 DSP의 다이나믹소재가 카리브 심사 플랫폼에 의해 반려된 경우
601	RESP_BELOW_MIN_PLACEMENT_COUNT	최소 광고수(minPlcmt) 충족하지 않은 경우
1001	BLOCKED_ADOMAIN	유저피드백 "관심없음/신고처리" 에 의해 필터된 adomain

3. Hidetrackers (비즈보드)

• 카카오톡 채팅탭, 오픈채팅탭 상단 비즈보드에 대해 사용자가 광고 숨김 처리를 하는 경우, 카카오 SDK에서 DSP가 응답한 hidetrackers를 호출 (hide 비콘을 전송) 한다.

• hidetrackers가 호출된 응답 소재의 광고 계정에 대해서는 해당 광고단위에 24시간 동안 광고 미 응답 처리가 필요하다.

• 이를 위해 DSP는 비즈보드 응답에 대해서는 DSP 응답 아래 위치에 hidetrackers를 필수로 담아 응답해야 한다.

  • (NA 1.1) BidResponse.seatbid.bid.adm.native.ext.hidetrackers

  • (NA 1.2) BidResponse.native.eventtrackers

4. 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	strings	4.0	Version of SKAdNetwork
network	string
sourceidentifier	string
itunesitem	string		ID of advertiser’s app in Apple’s app store
fidelities	object array		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

5. Eventtrackers Event Types, Methods Table

Native 1.2 ver. 응답인 경우에만 해당됨

Event Types Table

Type ID	Name	Definition	kakao Definition
1	impression	Impression	imptrakcers 에 해당
2	viewable-mrc50	Visible impression using MRC definition at 50% in view for 1 second	vimptrackers 에 해당
500	hidetrackers	비즈보드 광고 숨기기 처리	hidetrackers 에 해당

Event Tracking Methods Table

Type ID	Name	Definition
1	img	Image-pixel tracking - URL provided will be inserted as a 1x1 pixel at the time of the event.
2	js	Javascript-based tracking - URL provided will be inserted as a js tag at the time of the event.
500+	exchange specific	Could include custom measurement companies such as moat, doubleverify, IAS, etc - in this case additional elements will often be passed

6. Audience Matching

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

Web Context

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

1. kakao는 Partner 사에게 아래와 같은 형태의 URL을 제공한다. (응답 형식: 1x1 이미지 OR 빈 응답값) https://act.ds.kakao.com/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가 없다면 요청이 제한될 수 있음)