英語で読む

次の方法で共有


Bidders のお得な情報

Xandrは、当社のプラットフォーム販売者との取引に入札する機能を提供します。 このページでは、入札プロセスについて説明します。

ヒント

取引オークションは、売り手が取引をどのように定義したかに応じて、オープンまたはプライベートにすることができます。 これらのさまざまな種類のオークションのしくみについては、「 取引オークションの仕組み」を参照してください。

注意

取引が作成された後、メンバーを変更することはできません。

取引在庫の購入

手順 1. 取引を処理するようにシステムを構成する

入札要求で取引 ID を読み取り、適切な案件固有の入札応答を書式設定するようにシステムが構成されていることを確認します。 詳細については、「 要求/応答チェーンの例」を参照してください。 また、 取引オークションの仕組みを 確認して、Xandrがさまざまな状況でどのようにオークションを実施しているかを理解してください。

手順 2. Xandr の担当者に連絡する

取引 ID の要求と応答を適切に処理するようにシステムを構成したら、Xandr 担当者に連絡して Xandr での取引を有効にします。 取引の有効化には、次のことが含まれる場合があります。

  • 取引要求を決定して対応する方法を検証する
  • Microsoft のシステムで販売者に表示されるようにする

手順 3. 買い手に取引の交渉を開始するように指示する

あなたの買い手は直接売り手との取引を交渉します。 Xandr はプロセスに関与しません。 購入者が従う必要があるプロセスを次に示します。

  1. 購入者は、売り手と取引を交渉します。
  2. 購入者は Xandr メンバー ID を販売者に渡します。 メンバー ID がわからない場合は、メンバー ID の識別に役立つ必要があります。
  3. 販売者が UI 内で購入者との取引を設定する
  4. 売り手は買い手に取引IDを与えます。
  5. 購入者は、ターゲット設定のために入札者システムに取引 ID を入力します。  

手順 4. 購入者の取引を検証する

購入者が Xandr 販売者との取引を設定したら、入札者プロファイルが取引在庫に適用されるパラメーターをブロックしないようにする必要があります。 たとえば、プロフィールで、取引インベントリに適用される販売者、クリエイティブ サイズ、その他のパラメーターが除外されている場合、それらの入札リクエストは受け取りません。 入札者プロファイルの更新または作成の詳細については、 従来の Bidder プロファイル サービスに関するページを参照してください。

注意

取引購入者アクセス サービスを使用して、取引が Xandr のシステムに存在することを検証することをお勧めします。 これは、非アクティブな取引をターゲットにしないようにするのに役立ちます。予期した内容ではありません。

例:

$ curl -b cookies -c cookies  'https://api.adnxs.com/deal-buyer-access?id=63'
{
     "response" : {
         "status" :  "OK" ,
         "count" : 1,
         "deal" : 
         "deals" : {
             "id" : 63,
             "code" :  null ,
             "name" :  "Private deal for buyer 1085 with floor of $2.50" ,
             "description" :  null ,
             "active" :  false ,
             "start_date" :  "2013-12-01 00:00:00" ,
             "end_date" :  "2013-12-31 23:59:59" ,
             "floor_price" : 2.5,
             "currency" :  "USD" ,
             "use_deal_floor" :  true ,
             "last_modified" :  "2013-12-04 20:39:57" ,
             "seller" : {
                 "id" : 100006,
                 "name" :  "Seller 456"
             },
             "buyer" : {
                 "id" : 100007,
                 "bidder_id" : 2,
                 "name" :  "Buyer 456"
             },
             "type" : {
                 "id" : 2,
                 "name" :  "Private Auction"
             },
             "brands" : [
                 {
                     "id" : 1
                 }
 
             ],
             "ask_price" : 2.75,
             "suggested_min_bid_price" : 3
         }
     }
}

要求/応答チェーンの例

注意

この例は、AppNexus 入札プロトコルの Xandr 統合用です。

入札要求

{
    "bid_request": {
        "timestamp": "2014-04-18 17:00:57",
        "bidder_timeout_ms": 2000,
        "members": [
            {
                "id": 1417
            },
            {
                "id": 1625
            }
        ],
        "test": true,
        "member_ad_profile_id": 555216,
        "excluded_attributes": [
            2033
        ],
        "tags": [
            {
                "auction_id_64": 5555508250840350700,
                "size": "300x250",
                "sizes": [
                    "300x250"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "iframe",
                "site_id": 555526,
                "creative_formats_map": "111111111011",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "vast-url",
                    "unknown",
                    "unknown"
                ],
                "ad_profile_id": 555180,
                "visibility_profile_id": 5553,
                "venue_id": 407258,
                "pop_max_width": 300,
                "pop_max_height": 250,
                "pop_is_prepop": false,
                "allowed_media_types": [
                    1
                ],
                "media_subtypes": [
                    "banner"
                ],
                "estimated_clear_price": 0.913,
                "estimated_average_price": 0.456,
                "id": 5555354,
                "deals": [
                    {
                        "id": 555664,
                        "member_id": 1625,
                        "floor_cpm": 0.5,
                                                "sizes": [
                                                        "300x250", 
                                                        "300x600"
                                                ]
                    }
                ]
            }
        ],
        "bid_info": {
            "user_id_64": 5555037017052493000,
            "no_cookies": false,
            "payment_rule_id": 555018,
            "selling_member_id": 55578,
            "no_flash": false,
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.116 Safari/537.36",
            "browser": 8,
            "operating_system": 11,
            "operating_system_extended": 81,
            "operating_system_family": 4,
            "carrier": 1,
            "device_type": 1,
            "language": 1,
            "accepted_languages": "en-US",
            "session_freq": 1,
            "pub_session_freq": 1,
            "ip_address": "555.1.12.54",
            "country": "US",
            "within_iframe": false,
            "device_ids": {
                "sha1udid": "d55555c2314f3789198685914c01425034b5d502",
                "md5udid": "caf55557c5b39fb4ad68dabc9808bda1"
            },
            "publisher_id": 555547,
            "userdata_json": "{}",
            "segments": [
                {
                    "id": 1,
                    "member_id": 0,
                    "code": "cookie_birthday",
                    "provider": "Xandr",
                    "last_seen_min": 23274134
                }
            ]
        }
    }
}

入札応答

{
   "bid_response":{
      "responses":[
         {
            "member_id":1625,
            "price":0.75,
            "creative_id":11,
            "auction_id_64": 5555508250840350700,
            "deal_id": 555664
         }
      ]
   }
}

要求のエラー コードを通知する

取引固有のエラー コードについては、「 入札エラー コード」を参照してください。

Error ID **説明
NEC_DEAL_NOT_AVAILABLE 308 応答で指定した取引は現在アクティブではありません。
NEC_DEAL_NO_MEMBER 309 応答で指定した取引は、メンバーが利用できません。
NEC_DEAL_BELOW_FLOOR 310 入札は、取引の要求価格を下回っているため、オークションでは考慮されませんでした。
NEC_DEAL_BRAND_BANNED 311 クリエイティブに関連付けられているブランドは、この取引の有効なブランドではありません。