Bidders のお得な情報
Xandrは、当社のプラットフォーム販売者との取引に入札する機能を提供します。 このページでは、入札プロセスについて説明します。
ヒント
取引オークションは、売り手が取引をどのように定義したかに応じて、オープンまたはプライベートにすることができます。 これらのさまざまな種類のオークションのしくみについては、「 取引オークションの仕組み」を参照してください。
注意
取引が作成された後、メンバーを変更することはできません。
入札要求で取引 ID を読み取り、適切な案件固有の入札応答を書式設定するようにシステムが構成されていることを確認します。 詳細については、「 要求/応答チェーンの例」を参照してください。 また、 取引オークションの仕組みを 確認して、Xandrがさまざまな状況でどのようにオークションを実施しているかを理解してください。
取引 ID の要求と応答を適切に処理するようにシステムを構成したら、Xandr 担当者に連絡して Xandr での取引を有効にします。 取引の有効化には、次のことが含まれる場合があります。
- 取引要求を決定して対応する方法を検証する
- Microsoft のシステムで販売者に表示されるようにする
あなたの買い手は直接売り手との取引を交渉します。 Xandr はプロセスに関与しません。 購入者が従う必要があるプロセスを次に示します。
- 購入者は、売り手と取引を交渉します。
- 購入者は Xandr メンバー ID を販売者に渡します。 メンバー ID がわからない場合は、メンバー ID の識別に役立つ必要があります。
- 販売者が UI 内で購入者との取引を設定する
- 売り手は買い手に取引IDを与えます。
- 購入者は、ターゲット設定のために入札者システムに取引 ID を入力します。
購入者が 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 | クリエイティブに関連付けられているブランドは、この取引の有効なブランドではありません。 |