入札者は、オークション結果、入札応答時間、特定の入札者の入札応答によって生成されたエラー (「JSON 解析エラー」など) に関する通知を受け取ります。 これらの通知は、オークションが完了し、インプレッションが配信された時点で、サーバー側の呼び出しを介して入札者が指定した notify_URI に送信されます。 通知で受け取る情報の量は、入札者サービスのnotify_full_auction フィールドを使用して管理できます。 通知には、送信された各入札単価の詳細が含まれます。
注:
特定のオークションの種類では、落札通知の前に損失または保留中の通知が生成される場合があります。 落札通知は常に権限があり、そのオークションに関して以前に受信した他の通知を上書きします。
内部オークション
Microsoft が実施するすべてのオークションについて、オークションが落札したとき、およびエラーが発生したときに、入札者は通知を受け取ります。 入札者は、 サポート リクエストを送信することで、オークションが落札された場合の通知を受け取ることを選択することもできます。
外部オークション
サードパーティが実施するすべてのオークションについて、入札者は自分の入札がサードパーティに渡されたときに保留中の通知を受け取り、オークションに落札したときに通知を受け取ります。
スペック
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
timestamp |
すべて | timestamp | 要求が送信された時刻。 |
user_id_64 |
some | int | ユーザーの ID。 "lost" および "no-bid" リクエストでは、ユーザー ID は指定されません。 |
fail |
some | ブール値 | 入札応答を処理できなかった場合 (例: 入札応答で渡された JSON が無効な場合) は true を返します。 |
error |
some | string | fail が true の場合、このフィールドには対応するエラー メッセージが表示されます。 以下の エラー一覧 を参照してください。 |
error_id |
some | int | 提供される番号の詳細については、 こちらをご覧ください。 |
response_time_ms |
some | int | 指定された場合、これは bid_response が返すためのミリ秒単位です。 応答が返されない場合、このパラメーターは除外されます。 |
タグ
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
id |
some | int | タグの ID です。 |
auction_id_64 |
すべて | int | オークションの ID。 これは、調整と不一致に役立つため、ログに追加することをお勧めします。 |
notify_type |
すべて | 列挙 | 指定可能な値は、 kept、 sold、 won、 lost、 default、または pending です。注: keptsold、インベントリの所有者である場合にのみ適用されます。 |
post_pending |
すべて | ブール値 | メンバーがサード パーティのインベントリの最終オークションに落札した場合は true に設定します。 |
member_id |
some | int | 入札応答に含まれるメンバーの ID。 "lost" および "no-bid" リクエストでは、メンバー ID は指定されません。 |
creative_id |
some | int | 入札応答に含まれるクリエイティブの ID。 "lost" および "no-bid" リクエストでは、クリエイティブ ID は指定されません。 |
price_paid |
type = won | double | 勝者が実際に支払った価格 (CPM)。 これは、インプレッションを獲得した場合にのみ使用できます。 |
price_sold_for |
種類 = 販売済み | double | インプレッションの所有者が販売されたときに受け取った収益。 販売者のみ。 |
custom_notify_data |
some | string | このタグのインプレッションを獲得した場合、落札用に送信したカスタム通知データは、通知内のタグ レベルで通過します。 |
payment_rule_id |
some | int | タグが割り当てた支払いルールの ID。 |
応答
| フィールド | 範囲 | 型 | 説明 |
|---|---|---|---|
result |
すべて | 文字列 | このフラグ (ok または error) は、入札者に有効な入札応答を受け取ったことを報告します。
errorの場合は、関連するエラー メッセージが表示されます。 |
price_bid |
some | double | 入札応答の価格入札。 |
error_id |
some | int |
resultがerrorの場合、このフィールドにはエラー コードが表示されます。 詳細については、「 要求エラー コードへの通知」を参照してください。 |
error |
some | string |
resultがerrorされると、このフィールドに対応するエラー メッセージが表示されます。 詳細については、「 要求エラー コードへの通知」を参照してください。 |
custom_notify_data |
some | string | 指定された場合、これは通知に渡される応答で入札者が指定したデータです。 |
注:
post-pending がtrueされている場合、応答配列は存在しません。
紛失した通知
オークションに対して 0 以外の入札応答を送信し、オークションに落札できなかった場合は、通知要求を送信できます。 これは、入札単価を上回ったか、入札が拒否されたために発生する可能性があります。 入札は、JSON メッセージの形式が不適切であるなどの技術的な理由で拒否される可能性があります。また、販売者によってブロックされているクリエイティブを使用したり、取引の下限を下回る入札価格を送信したりするなどのビジネス レベルの理由で拒否される可能性があります。 特定のクリエイティブの配信がうまくいかない場合、"失われた" 通知メッセージは、そのクリエイティブのインプレッション数に失敗している理由を知るための優れた手段です。 通知メッセージが失われるようオンにするには、 サポート リクエスト を送信してください。担当者が入札者に対してこれを有効にすることができます。
エラー リスト
通知要求で送信される可能性があるすべてのエラーの一覧については、「 入札エラー コード」を参照してください。
完全なオークションに通知する
入札者のサービス パラメーター notify_full_auction が true に設定されている場合、full_tag_info、bid_info が応答に含まれます。 パラメーター full_tag_info には、[入札要求] ページの [タグ] セクションで説明されている [exclusive_default] フィールドを除くすべての情報が含まれますが、bid_info には、[入札要求] ページの [Bid_info] セクションと [セグメント] セクションのすべての情報が含まれています。
注:
保留中の通知 (post-pending が true に設定されている) の場合、入札承認コールバックがまだ受信されていないため、 full_tag_info を使用できません。
例
1 つのタグ要求 - オークション落札
注:
これは、プラットフォーム入札プロトコルを使用する場合にのみ使用できます。 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
}
]
}
}
1 つのタグ要求 - オークション敗退
{
"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
}
}