英語で読む

次の方法で共有


通知要求

入札者は、オークションの結果、入札応答時間、および特定の入札者の入札応答によって生成されたエラー (つまり、"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 すべて 列挙 使用可能な値は、 keptsoldwonlostdefault、または pendingです。

注:keptsoldは、インベントリの所有者である場合にのみ適用されます。
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 resulterrorされると、このフィールドにエラー コードが表示されます。 詳細については、「 要求エラー コードの通知」を参照してください。
error string resulterrorされると、このフィールドに対応するエラー メッセージが表示されます。 詳細については、「 要求エラー コードの通知」を参照してください。
custom_notify_data string 指定された場合、これは、通知に渡される応答で入札者が指定したデータです。

注意

post-pendingtrueされている場合、応答配列は存在しません。

紛失した通知

オークションに対して 0 以外の入札応答を送信し、オークションに落札しなかった場合は、通知要求を送信できます。 これは、入札が禁止されていたか、入札が拒否されたために発生する可能性があります。 不適切な形式の JSON メッセージなどの技術的な理由、または売り手によってブロックされているクリエイティブの使用、取引のフロアを下回る入札価格の送信などのビジネス レベルの理由により、入札を拒否できます。 特定のクリエイティブで配信に問題がある場合は、失われた通知メッセージが、クリエイティブがより多くのインプレッションを獲得していない理由を確認するのに最適な方法です。 紛失した通知メッセージを有効にするには、 サポートリクエスト を送信してください。担当者が入札者に対してこれを有効にすることができます。

エラー一覧

通知要求で送信される可能性があるすべてのエラーの一覧については、「 入札エラー コード」を参照してください。

完全なオークションに通知する

Bidder Service パラメーター notify_full_auctiontruefull_tag_info、および bid_info に設定されている場合は、応答に含まれます。 パラメーター full_tag_infoには、[入札要求] ページの [タグ] セクションで説明されているすべての情報が含まれますが、exclusive_default フィールドは除きますが、bid_infoには、[入札要求] ページの [Bid_info] セクションと [セグメント] セクションのすべての情報が含まれます。

注意

保留中後の通知 (post-pendingtrueに設定されている) の場合、入札承諾コールバックがまだ受信されていないため、 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
         }
      ]
   }
}

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

通知要求 - FAQ