入札者 - 入札応答
注意
- サポートされていません: AppNexusBidding プロトコルはサポートされなくなりました。このドキュメントは、レガシのみを目的としています。
- Xandr と統合する新しい入札者の場合は、 OpenRTB 2.4 Bid Protocol を参照してください。
インプレッション バスから入札リクエストを受け取った後、入札者から 入札 応答が送信されます。 入札応答には、入札者の入札 ("価格") と選択したクリエイティブ ("creative_id"
または "creative_code"
) が含まれます。 このクリエイティブは、広告サーバーが最終的に入札を承諾した場合に配信されます。
フィールド | 種類 | 説明 |
---|---|---|
debug_text |
string | この省略可能なテキスト フィールドは、クエリ文字列に dongle=DONGLE を追加&、&debug BIDDER_ID&=1&dongle=DONGLE を使用して TinyTag を呼び出すと、デバッグ ログ内に表示されます。 メモ: DONGLE (入札者のデバッグ出力を保護するためのパスワード) は、入札者に設定されている場合にのみ必要です。 必須: いいえ |
no_bid |
bool | "true" の場合は、有効な応答を返したが入札しないことを選択したことをインプレッション バスに通知します。 この no_bid フィールドは、特定のタグだけでなく、応答全体を表示する no_bid 場合に最適です。必須: いいえ |
フィールド | 種類 | 説明 |
---|---|---|
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。 必須: いいえ |
フィールド | 種類 | 説明 |
---|---|---|
name |
string | クリエイティブの URL (メディア、ピクセル、クリックなど) またはコンテンツで置き換えられるマクロの名前。 名前には、カラット (^) を除く任意の文字を含め、次のように書式設定する必要があります。 ${MACRO_NAME} クリエイティブの URL またはコンテンツ内。 メモ: システム マクロが置き換えられた後、カスタム マクロが置き換えられます。 カスタム マクロの詳細については、「 Creative Service」を参照してください。 必須: いいえ |
value |
string | マクロの置き換えに使用される値。 この値には、カラット (^) を除く任意の文字が含まれる場合があります。 スラッシュはエスケープしないでください。 メモ: 値が整数の場合でも、二重引用符内に配置する必要があります。 |
- 各入札応答には、応答するタグのオークション ID を含める必要があります。 同じオークションに対して複数の応答を指定できます。
- に設定
true
されているno_bid
入札応答には、オークション ID を含める必要があります。
AppNexus では、配列またはcustom_notify_data
フィールドにcustom_macros
渡されるデータに制限はありませんが、渡されるカスタム データの合計を 1000 文字以下に制限することをお勧めします。 このデータは、リダイレクト URL の一部として特定の種類のインベントリ (外部販売者、iFrame 配置) 用にユーザーのブラウザーにエンコードして送信する必要があり、特定のブラウザーや特定の販売者では長い URL が破損する可能性があります。
{
"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
}
]
}
}
{
"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
}
]
}
}