通知要求

入札者は、オークションの結果、入札応答時間、および特定の入札者の入札応答によって生成されたエラー (つまり、"JSON 解析エラー") に関する通知を受け取ります。 これらの通知は、オークションが完了し、インプレッションが配信されたときに、入札者が指定した notify_URI にサーバー側の呼び出しを介して送信されます。 Bidder Service の [notify_full_auction] フィールドを使用して、通知で受け取る情報の量を管理できます。 通知には、送信された各入札に関する詳細が含まれます。

内部オークション

当社が実施するすべてのオークションについて、入札者は、オークションが落札されたとき、およびエラーが発生したときに通知を受け取ります。 入札者は、 サポートリクエストを送信することで、オークションが失われたときに通知を受け取ることを選択することもできます。

外部オークション

第三者によって行われたすべてのオークションについて、入札者は、入札が第三者に渡されたときに保留中の通知を受け取り、オークションが落札されたときに通知を受け取ります。

仕様

タグ

応答

紛失した通知

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

エラー一覧

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

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

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

例

単一タグ要求 - オークションで落札

{   "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