英語で読む

次の方法で共有


入札者 - 入札応答

注意

  • サポートされていません: AppNexusBidding プロトコルはサポートされなくなりました。このドキュメントは、レガシのみを目的としています。
  • Xandr と統合する新しい入札者の場合は、 OpenRTB 2.4 Bid Protocol を参照してください。

インプレッション バスから入札リクエストを受け取った後、入札者から 入札 応答が送信されます。 入札応答には、入札者の入札 ("価格") と選択したクリエイティブ ("creative_id" または "creative_code") が含まれます。 このクリエイティブは、広告サーバーが最終的に入札を承諾した場合に配信されます。

実装

仕様

Bid_response

フィールド 種類 説明
debug_text string この省略可能なテキスト フィールドは、クエリ文字列に dongle=DONGLE を追加&、&debug BIDDER_ID&=1&dongle=DONGLE を使用して TinyTag を呼び出すと、デバッグ ログ内に表示されます。

メモ: DONGLE (入札者のデバッグ出力を保護するためのパスワード) は、入札者に設定されている場合にのみ必要です。

必須: いいえ
no_bid bool "true" の場合は、有効な応答を返したが入札しないことを選択したことをインプレッション バスに通知します。 この no_bid フィールドは、特定のタグだけでなく、応答全体を表示する no_bid 場合に最適です。
必須: いいえ

Bid_response-responses>[ ]

フィールド 種類 説明
member_id int 要求の "メンバー" 配列から入札者によってクリエイティブが選択されたメンバーの ID。
必須: はい
auction_id_64 int この応答が送信されるオークションの ID。
必須: はい
exclusive bool 所有者フェーズ: "true" の場合、この応答のクリエイティブが配信されます。 他の入札者はインプレッションを競うことが許可されません。
必須: いいえ
no_bid bool "true" の場合、有効な応答を返したが、このタグに入札しないことを選択したことをインプレッション バスに通知します。
必須: いいえ
price double 入札者がこのインプレッションに対して支払う意思がある総価格 (CPM) です。 排他的な場合、これはレポート目的でのみ使用されます。限定されていない場合は、予約価格を超える支払いを行う入札者のみがオークションに入札できます。 これは単純な 10 進数にする必要があります。 値が文字列の場合は、文字列を 0 に評価するため、値が数値であることを確認します。
必須: いいえ
userdata_js string この bidder の応答が選択されている場合にユーザーデータを変更する userdata javascript コマンド。

メモ: 入札要求 にno_cookies フィールドが true に設定されている場合、コマンドが正常に実行される保証 userdata_js はありません (AppNexus がユーザーに関する情報を格納できない可能性があるため)。

必須: いいえ
custom_notify_data string このフリーフォーム テキスト フィールドを使用して、 通知要求に情報を渡すことができます。 これは、ImpBus によって自動的に URL または Cookie でエンコードされるため、フリーテキスト形式で渡すことができます。
必須: いいえ
creative_id int 所有者フェーズ: インプレッションの新しい既定のクリエイティブとして使用するクリエイティブの ID。
所有者以外のフェーズ: インプレッションに対するメンバーの入札の一部として送信されるクリエイティブの ID。
必須: はい (コードが指定されていない場合)。
creative_code string クリエイティブ サービスに渡されるクリエイティブのカスタム コード。
必須: はい (コードが指定されていない場合)。
click_url string クリエイティブに関連付けるクリック URL。 クリエイティブに既に構成されている click_url 場合は、入札応答の値が既存の URL の前に付加されます。 クリック追跡にカスタム マクロを使用することもできます。
必須: いいえ
pixel_url string クリエイティブに関連付けるピクセル URL。 このピクセルは、セキュリティで保護されていないインベントリに使用されます。
必須: いいえ
pixel_type 列挙 使用するピクセルの種類: 'javascript' または 'image' (指定されていない場合は既定値は image)。
必須: いいえ
deal_id int このオークションに使用する取引の ID。
必須: いいえ

Bid_response-responses>[ ]->custom_macros[ ]

フィールド 種類 説明
name string クリエイティブの URL (メディア、ピクセル、クリックなど) またはコンテンツで置き換えられるマクロの名前。 名前には、カラット (^) を除く任意の文字を含め、次のように書式設定する必要があります。 ${MACRO_NAME}
クリエイティブの URL またはコンテンツ内。

メモ: システム マクロが置き換えられた後、カスタム マクロが置き換えられます。
カスタム マクロの詳細については、「 Creative Service」を参照してください。

必須: いいえ
value string マクロの置き換えに使用される値。 この値には、カラット (^) を除く任意の文字が含まれる場合があります。 スラッシュはエスケープしないでください。

メモ: 値が整数の場合でも、二重引用符内に配置する必要があります。

オークション ID

  • 各入札応答には、応答するタグのオークション ID を含める必要があります。 同じオークションに対して複数の応答を指定できます。
  • に設定trueされているno_bid入札応答には、オークション ID を含める必要があります。

カスタム データの制限 (マクロと通知データ)

AppNexus では、配列またはcustom_notify_dataフィールドにcustom_macros渡されるデータに制限はありませんが、渡されるカスタム データの合計を 1000 文字以下に制限することをお勧めします。 このデータは、リダイレクト URL の一部として特定の種類のインベントリ (外部販売者、iFrame 配置) 用にユーザーのブラウザーにエンコードして送信する必要があり、特定のブラウザーや特定の販売者では長い URL が破損する可能性があります。

1 つのタグ応答 (ピクセルでクリエイティブ ID を使用)

{
   "bid_response":{
      "responses":[
         {
            "member_id":3,
            "price":11.170,
            "creative_id":11,
            "pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
            "pixel_type":"image",
            "auction_id_64": 2345245234523
         }
      ]
   }
}

1 つのタグ、複数の入札 (ピクセルでクリエイティブ ID を使用)

{
   "bid_response":{
      "responses":[
         {
            "member_id":3,
            "price":11.170,
            "creative_id":11,
            "pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
            "pixel_type":"image",
            "auction_id_64": 2345245234523
         },
         {
            "member_id":3,
            "price":9.200,
            "creative_id":12,
            "pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
            "pixel_type":"image",
            "auction_id_64": 2345245234523
         }
      ]
   }
}

マルチ タグ応答 (クリエイティブ コードとカスタム マクロを使用)

{
   "bid_response":{
      "responses":[
         {
            "member_id":7,
            "price":3.12,
            "creative_code":"23219",
            "custom_macros":[
               {
                  "name":"CAMPAIGN_ID",
                  "value":452346
               },
               {
                  "name":"INT_CODE",
                  "value":"a352-45we-sdr3"
               }
            ],
            "userdata_js":"update_frequency(23219)",
            "auction_id_64": 2345245234523
         },
         {
            "member_id":14,
            "price":1.14,
            "creative_code":"23219",
            "custom_macros":[
               {
                  "name":"CAMPAIGN_ID",
                  "value":452312
               },
               {
                  "name":"INT_CODE",
                  "value":"c231-4sa2-css5"
               }
            ],
            "userdata_js":"update_frequency(23219)",
            "auction_id_64": 2432387423232
         }
      ]
   }
}

取引に対する応答

{
   "bid_response":{
      "responses":[
         {
            "member_id":5555,
            "price":0.75,
            "creative_id":11,
            "auction_id_64": 5555508250840350700,
            "deal_id": 555664
         }
      ]
   }
   }