비드 반응

Size

bid response의 최대 크기는 4 KB입니다.

No bids

no-bid 응답을 전달하려면 상태 코드 204와 함께 빈 응답을 전달하십시오.

Win/loss/billing notifications

AppLovin RTB는 요청자가 요청의 nurl, lurl 및 burl 필드에 각각 제공한 win, loss 및 billing 알림 URL을 호출합니다. AppLovin RTB는 auction이 완료되고 AppLovin이 기기로 광고를 전송할 때 win URL을 호출합니다. auction 진행 중 연결된 광고가 제대로 로드되지 않거나, 다른 낙찰 광고가 로드된 후에 loss URL을 호출합니다. 기기에서 광고를 렌더링할 때(즉, 비디오 재생이 시작되거나 그래픽 광고의 경우 기기에 광고가 표시될 때) billing URL을 호출합니다.

요청자는 이러한 알림 URL의 사양에 매크로를 삽입할 수 있습니다. AppLovin RTB는 URL을 요청하기 전에 해당 URL의 매크로를 적절한 값으로 대체합니다. 다음 목록은 요청자가 이러한 URL에 삽입할 수 있는 매크로를 보여줍니다.

이 매크로들은 대소문자를 구분하므로 반드시 모두 대문자(ALL CAPS)로 지정해야 합니다. 이 매크로들을 ${…}로 감싸십시오 (예: ${AUCTION_ID}).

매크로가 포함된 win bid URL 예시

https://example.com/endpoint/auction=${AUCTION_ID}&price=${AUCTION_PRICE}

Ad markup standard

DSP 입찰자는 bid response에 ad markup을 포함해야 합니다. AppLovin RTB는 win 알림에 대한 응답으로 ad markup을 반환하는 것을 지원하지 않습니다.

귀하의 ad markup은 AppLovin의 RTB ad markup 표준을 준수해야 합니다. AppLovin의 RTB 서버는 bid를 받는 즉시 ad markup의 준수 여부를 확인합니다. 그런 다음 ad markup에 대해 다음과 같은 기본적인 유효성 검사(sanity check)를 수행합니다.

• ad markup이 올바르게 이스케이프 처리되었는지 여부.
• VAST 광고를 제외하고 ad markup이 URL 인코딩되었는지 여부.
• ad markup의 HTML이 snippet 형태인지 여부.
• rich media 광고로 입찰할 때는 노드의 콘텐츠를 CDATA 구조 내에 넣으십시오. XML의 CDATA는 어떠한 인코딩도 필요하지 않습니다. 그러나 JSON 컨텍스트에서 XML 문서를 전달하는 경우 다음 JSON 구문 및 이스케이프 규칙을 적용하십시오.
  • 모든 큰따옴표를 \"로 이스케이프 처리합니다.
  • 작은따옴표는 이스케이프 처리하지 않습니다.
  • XML 문서에서 모든 탭 및 줄 바꿈 문자를 제거합니다. (아래의 VAST ad markup 예시는 가독성을 위해 서식이 지정되어 있습니다. 실제 ad markup을 전송할 때는 불필요한 공백을 보내지 마십시오.)

ad markup snippet이 유효한 JSON 콘텐츠인지(CDATA 포함) 확인하려면 해당 snippet을 온라인 JSONLint 검증 도구에 입력해 볼 수 있습니다.

SDK 입찰자는 귀하의 SDK가 모든 크리에이티브를 렌더링해야 하므로 ad markup을 전달할 필요가 없습니다. SDK 입찰자는 admarkup field를 사용하여 커스텀 데이터를 전달할 수 있으며, 이 데이터는 어댑터를 통해 로드 시점에 귀하의 SDK로 반환되도록 구성할 수 있습니다.

Bid response components

bid response는 다음 세 가지 컴포넌트로 구성됩니다.

bidresponse

최상위 object

seatbid

입찰자가 특정 seat을 대신하여 제출한 bid들의 모음

bid

특정 business 조건 하에 특정 impression을 구매하겠다는 제안

Bid response object

Seatbid object

Bid object

Tracking fields

다음 표는 DSP(demand-side platform)에서 사용할 수 있는 트래킹 필드와 권장 용도를 보여줍니다.

Example bid response

{
  "id": "5e1eb292d6b7ea9cf3da74ddb385996a62d3a6e9",
  "seatbid": [
    {
      "bid": [
        {
          "id": "8JxH4DHN4KMF21Vd",
          "impid": "1",
          "price": 15,
          "adid": "1093919",
          "adm": "<a href=\"https://click.url/click/8JxH4DHN4KMF21Vd?uid=05D02DC6-0132-4C2C-A879-79BB026BE3F8&partner=applovin&ts=2018-07-09T18-19-01Z&ad=1093919\"><img src=\"https://assets.dsp.io/ad_assets/files/320x50.png\" height=\"50\" width=\"320\" alt=\"\"/></a>",
          "adomain": [
            "advertiser.com"
          ],
          "bundle": "123123123",
          "iurl": "https://assets.dsp.io/ad_assets/files/320x50.png",
          "cid": "12345",
          "crid": "crid123",
          "cat": [
            "IAB22-2"
          ],
          "h": 50,
          "w": 320,
          "ext": {
            "crtype": "HTML",
            "imptrackers": [
                "https://example.dsp.events/win/8JxH4DHN4KMF21Vd?ts=2018-07-09T18-19-01Z&ad=1093919&uid=05D02DC6-0132-4C2C-A879-79BB026BE3F8&auction=${AUCTION_ID}&price=${AUCTION_PRICE}&partner=applovin"
            ]
          }
        }
      ]
    }
  ],
  "bidid": "8JxH4DHN4KMF21Vd",
  "cur": "USD"
}

Example native ad response

{
  "bidid":"9aa2a2950894c95b9b02476a5ba5438dc6de8dc1",
  "cur":"USD",
  "id":"65de6af36e6fb32778afa94a996ec4c2b514145d",
  "seatbid":[
    {
      "bid":[
        {
          "adm":"{\"native\":{\"assets\":[{\"id\":100,\"title\":{\"text\":\"Test Ad\"}},{\"id\":200},{\"id\":300,\"img\":{\"h\":null,\"url\":\"https://assets.com/main_image.png_\",\"w\":null}},{\"id\":310,\"img\":{\"h\":80,\"url\":\"https://assets.com/icon_image.png\",\"w\":80}},{\"data\":{\"value\":\"Test Ad Subline\"},\"id\":420},{\"data\":{\"value\":\"Continue\"},\"id\":430},{\"data\":{\"value\":\"4.5\"},\"id\":410}],\"imptrackers\":[\"https://adserver.com/impression_tracker\"],\"link\":{\"url\":\"https://adserver.com/click_destination\"}}}\n",
          "adomain":[
            "somegame.com"
          ],
          "bundle":"com.game.example",
          "cat":[
            "IAB1"
          ],
          "crid":"74650.0!3ILDTypkALKe8xfw2WJLmxfNOftiOg2u3yeGIKEULAU*",
          "ext": {
            "crtype":"native"
          },
          "id": "1",
          "impid": "1",
          "iurl": "https://assets.com/preview.png",
          "price": 1.0
        }
      ],
      "seat":"A00000001"
    }
  ]
}