通知要求
入札者は、オークションの結果、入札応答時間、および特定の入札者の入札応答によって生成されたエラー (つまり、"JSON 解析エラー") に関する通知を受け取ります。 これらの通知は、オークションが完了し、インプレッションが配信されたときに、入札者が指定した notify_URI
にサーバー側の呼び出しを介して送信されます。
Bidder Service の [notify_full_auction
] フィールドを使用して、通知で受け取る情報の量を管理できます。 通知には、送信された各入札に関する詳細が含まれます。
注意
特定のオークションの種類では、落札通知の前に、紛失または保留中の通知が生成される場合があります。 Win 通知は常に権限を持ち、そのオークションで以前に受信した他の通知をオーバーライドします。
当社が実施するすべてのオークションについて、入札者は、オークションが落札されたとき、およびエラーが発生したときに通知を受け取ります。 入札者は、 サポートリクエストを送信することで、オークションが失われたときに通知を受け取ることを選択することもできます。
第三者によって行われたすべてのオークションについて、入札者は、入札が第三者に渡されたときに保留中の通知を受け取り、オークションが落札されたときに通知を受け取ります。
フィールド | 範囲 | 種類 | 説明 |
---|---|---|---|
timestamp |
すべて | timestamp | 要求が送信された時刻。 |
user_id_64 |
幾 | int | ユーザーの ID。 "lost" 要求と "bid なし" 要求では、ユーザー ID は指定されません。 |
fail |
幾 | ブール値 | 入札応答を処理できなかった場合に true を返します (入札応答で無効な JSON が渡された場合など)。 |
error |
幾 | string | fail が true の場合、このフィールドには対応するエラー メッセージが表示されます。 以下 の「エラー一覧」を 参照してください。 |
error_id |
幾 | int | 提供される番号の詳細については、 こちらを参照してください。 |
response_time_ms |
幾 | int | 指定した場合、これは、 bid_response が返すミリ秒数です。 応答が返されない場合、このパラメーターは除外されます。 |
フィールド | 範囲 | 種類 | 説明 |
---|---|---|---|
id |
幾 | int | タグの ID。 |
auction_id_64 |
すべて | int | オークションの ID。 これは調整と不一致に役立ちます。そのため、ログに追加することをお勧めします。 |
notify_type |
すべて | 列挙 | 使用可能な値は、 kept 、 sold 、 won 、 lost 、 default 、または pending です。注: kept sold は、インベントリの所有者である場合にのみ適用されます。 |
post_pending |
すべて | ブール値 | メンバーがサード パーティのインベントリの最終オークションに勝った場合は、 true に設定します。 |
member_id |
幾 | int | 入札応答に含まれるメンバーの ID。 "lost" 要求と "bid なし" 要求では、メンバー ID は指定されません。 |
creative_id |
幾 | int | 入札応答に含まれるクリエイティブの ID。 "lost" と "no-bid" の要求では、クリエイティブ ID は指定されません。 |
price_paid |
type = won | double | 勝者によって支払われた実際の価格 (CPM)。 これは、インプレッションを獲得した場合にのみ使用できます。 |
price_sold_for |
type = sold | double | 販売時にインプレッションの所有者が受け取った収益。 販売者のみ。 |
custom_notify_data |
幾 | string | このタグのインプレッションを獲得した場合、落札に送信したカスタム通知データは、通知のタグ レベルで渡されます。 |
payment_rule_id |
幾 | int | タグが割り当てた支払ルールの ID。 |
フィールド | 範囲 | 種類 | 説明 |
---|---|---|---|
result |
すべて | string | このフラグ (ok または error ) は、有効な入札応答の受信を入札者に報告します。
error されている場合は、関連するエラー メッセージが表示されます。 |
price_bid |
幾 | double | 入札応答の価格入札。 |
error_id |
幾 | int |
result がerror されると、このフィールドにエラー コードが表示されます。 詳細については、「 要求エラー コードの通知」を参照してください。 |
error |
幾 | string |
result がerror されると、このフィールドに対応するエラー メッセージが表示されます。 詳細については、「 要求エラー コードの通知」を参照してください。 |
custom_notify_data |
幾 | string | 指定された場合、これは、通知に渡される応答で入札者が指定したデータです。 |
注意
post-pending
がtrue
されている場合、応答配列は存在しません。
オークションに対して 0 以外の入札応答を送信し、オークションに落札しなかった場合は、通知要求を送信できます。 これは、入札が禁止されていたか、入札が拒否されたために発生する可能性があります。 不適切な形式の JSON メッセージなどの技術的な理由、または売り手によってブロックされているクリエイティブの使用、取引のフロアを下回る入札価格の送信などのビジネス レベルの理由により、入札を拒否できます。 特定のクリエイティブで配信に問題がある場合は、失われた通知メッセージが、クリエイティブがより多くのインプレッションを獲得していない理由を確認するのに最適な方法です。 紛失した通知メッセージを有効にするには、 サポートリクエスト を送信してください。担当者が入札者に対してこれを有効にすることができます。
通知要求で送信される可能性があるすべてのエラーの一覧については、「 入札エラー コード」を参照してください。
Bidder Service パラメーター notify_full_auction
が true
、full_tag_info
、および bid_info
に設定されている場合は、応答に含まれます。 パラメーター full_tag_info
には、[入札要求] ページの [タグ] セクションで説明されているすべての情報が含まれますが、exclusive_default
フィールドは除きますが、bid_info
には、[入札要求] ページの [Bid_info] セクションと [セグメント] セクションのすべての情報が含まれます。
注意
保留中後の通知 (post-pending
が true
に設定されている) の場合、入札承諾コールバックがまだ受信されていないため、 full_tag_info
は使用できません。
注意
これは、プラットフォーム入札プロトコルを使用している場合にのみ使用できます。 OpenRTB の勝利は、入札応答の NURL フィールドを使用して送信されます。
{ "notify_request":{
"timestamp":"2011-02-09 00:11:44",
"response_time_ms":4,
"tags":[
{
"id":474074,
"auction_id_64":7606327141949238687,
"payment_rule_id":65930,
"price_paid":0.90000,
"member_id":670,
"notify_type":"won",
"creative_id":12345,
"user_id_64":4628364836293826
}
],
"responses":[
{
"result":"ok",
"price_bid":1.00000
}
]
}
}
{
"notify_request": {
"user_id_64": 2843838668060323000,
"responses": [
{
"price_bid": 0.06207,
"result": "ok"
}
],
"tags": [
{
"notify_type": "lost",
"id": 9373851,
"payment_rule_id": 874041,
"auction_id_64": 1177991420539445500
}
],
"timestamp": "2016-09-27 21:49:06",
"auction_timestamp": "2016-09-27 21:49:06",
"response_time_ms": 67
}
}
{
"notify_request": {
"user_id_64": 9191106446964517565,
"responses": [
{
"error_id": 408,
"result": "error",
"error": "Creative 536754694 brand 75445 banned on member's ad profile 542799"
}
],
"tags": [
{
"notify_type": "lost",
"id": 5632681,
"payment_rule_id": 821648,
"auction_id_64": 442903072350998711
}
],
"timestamp": "2016-09-27 21:48:46",
"auction_timestamp": "2016-09-27 21:48:46",
"response_time_ms": 87
}
}