ビッドレスポンス

サイズ

bid responseの最大サイズは4 KBです。

No bid（入札なし）

No-bid（入札なし）レスポンスを伝達するには、ステータスコード204の空のレスポンスを返します。

Win/loss/billing通知

AppLovin RTBは、リクエスターがリクエストのnurl、lurl、およびburlフィールドでそれぞれ提供するwin、loss、およびbilling通知URLを呼び出します。 AppLovin RTBは、オークションが完了し、AppLovinがデバイスに広告を送信するときにwin URLを呼び出します。 関連する広告の読み込みに失敗した場合（オークション中）、または別の落札広告が読み込まれた後に、loss URLを呼び出します。 デバイスが広告をレンダリングするとき（つまり、動画の再生が開始されたとき、またはグラフィック広告の場合はデバイスが広告を表示したとき）にbilling URLを呼び出します。

リクエスターは、これらの通知URLの仕様にマクロを埋め込むことができます。 AppLovin RTBは、URLをリクエストする前に、それらのマクロを適切な値に置き換えます。 以下は、リクエスターがこれらのURLに埋め込むことができるマクロの一覧です。

これらのマクロは大文字と小文字を区別します。必ずすべて大文字（ALL CAPS）で指定してください。 これらのマクロは${…}で囲んでください（例：${AUCTION_ID}）。

マクロを含むwin bid URLの例

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

広告マークアップ基準

DSP入札者は、bid responseに広告マークアップを含める必要があります。 AppLovin RTBは、win通知のレスポンスとして広告マークアップを返すことをサポートしていません。

広告マークアップは、AppLovinのRTB広告マークアップ基準に準拠している必要があります。 AppLovinのRTBサーバーは、入札を受信するとすぐに広告マークアップの準拠性をチェックします。 その後、広告マークアップに対して以下のサニティチェックを実行します。

• 広告マークアップが適切にエスケープされていること。
• VAST広告を除き、広告マークアップがURLエンコードされていること。
• 広告マークアップのHTMLがスニペットであること。
• リッチメディア広告で入札する場合は、ノードのコンテンツをCDATA構造内に配置すること。 XML内のCDATAはエンコードを一切必要としません。 ただし、JSONコンテキストでXMLドキュメントを渡す場合は、以下のJSON構文およびエスケープルールを適用してください。
  • すべてのダブルクォーテーションを\"としてエスケープする。
  • アポストロフィはエスケープしない。
  • XMLドキュメントからすべてのタブ文字と改行文字を取り除く。 （以下のVAST広告マークアップの例は、読みやすさを考慮してフォーマットされています。 実際の広告マークアップには余分な空白を送信しないでください。）

広告マークアップスニペットが（CDATAを含めて）有効なJSONコンテンツであることを確認するには、そのスニペットをオンラインのJSONLintバリデータに渡して検証できます。

SDK入札者は、SDKがすべてのクリエイティブをレンダリングするため、広告マークアップを渡す必要はありません。 SDK入札者は、admarkupフィールドを使用してカスタムデータを渡すことができます。このデータは、ロード時にアダプターを介してSDKに返されるように設定できます。

Bid responseの構成要素

bid responseには3つの構成要素があります。

bidresponse

トップレベルオブジェクト

seatbid

特定のseatに代わって入札者が行った入札のコレクション

bid

特定のビジネス条件の下で特定のインプレッションを購入するオファー

Bid responseオブジェクト

Seatbidオブジェクト

Bidオブジェクト

トラッキングフィールド

次の表は、デマンドサイドプラットフォーム（DSP）が利用できるトラッキングフィールドと、その推奨される用途を示しています。

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"
}

ネイティブ広告レスポンスの例

{
  "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"
    }
  ]
}