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

AttributeTypeDefaultDescription

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

AttributeTypeDefaultDescription

addl

string array

SKAdNetwork IDs 목록

Object : BidReponse.bid.ext.skadn

AttributeTypeDefaultDescription

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

AttributeTypeDefaultDescription

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가 없다면 요청이 제한될 수 있음)

Last updated