Xandr での取引の販売

[アーティクル]
02/26/2024

注:

当社のプラットフォームで取引を販売するには、Xandrの認定を受ける必要があります。認定を受ける方法については、サポートまたは Xandr の担当者にお問い合わせください。

サプライパートナーとして、取引を使用して Xandr 購入者に在庫やデータへの特別なアクセスを提供できます。たとえば、取引では、在庫の優遇価格、排他的在庫へのアクセス、在庫の競合の減少、またはその他の機会が提供される場合があります。

このページでは、プロセスについて説明します。

開始する前に

Xandr に取引を追加し、購入者と取引する前に、次の操作を行う必要があります。

プラットフォームで取引を販売するための認定を受ける。
Xandr から入札を要求および受信するための OpenRTB プロトコルについて説明します。
Xandr の API の使用方法について説明します。 API オンボードプロセスを参照してください。

手順 1. システムで取引を作成する

Xandr バイヤーと取引を交渉します。
取引を独自のシステムに追加します。
Xandr 購入者に Xandr メンバー ID を確認します。この ID は次の手順で必要になります。

手順 2. Xandr に取引を追加する

注:

この手順では、Xandr の API を使用して Xandr に手動で取引を追加する方法について説明します。ただし、取引が独自のシステムで作成されるたびに、取引を Xandr に同期する自動化されたメカニズムを構築することをお勧めします。

Xandr の API で認証します。
購入者が Xandr メンバー ID を指定しなかった場合は、プラットフォームメンバーサービスを使用して見つけます。

ヒント

クエリ文字列パラメーターを search 使用して、名前で購入者を検索できます。次の例は、名前に "Place" を含む購入者を検索するときに返される応答を示しています。フィールドには id メンバー ID が含まれていることに注意してください。

$curl -b cookies -c cookies 'https://api.appnexus.com/platform-member?search=Place
 
{
    "response": {
        "status": "OK",
        "count": 3,
        "start_element": 0,
        "num_elements": 100,
        "platform-members": [
            {
                "id": 1001,
                "name": "Some Place",
                "description": null,
                "primary_type": "network",
                "platform_exposure": "public",
                "email": null,
                "daily_imps_verified": null,
                "daily_imps_self_audited": null,
                "daily_imps_unaudited": null,
                "is_iash_compliant": false,
                "seller_type": "platform",
                "active": true,
                "last_modified": "2015-07-29 16:53:35",
                "default_discrepancy_pct": null,
                "bidder": {
                    "id": "2",
                    "name": "Bidder1"
                },
                "contact_info": [
                    {
                        "name": "Joe Smith",
                        "title": "VP Media Operations",
                        "email": "jsmith@example.com",
                        "phone": "",
                        "address": "",
                        "address_2": "",
                        "city": "New York",
                        "country": "US",
                        "region": "NY",
                        "postal_code": "10012",
                        "additional_info": "We use proprietary technology to...",
                        "website_url": null,
                        "types": [
                            "supply",
                            "demand"
                        ]
                    }
                ],
                "daily_imps_appnexus_seller_reviewed": 16542600,
                "daily_imps_any_audit_status": 16542600,
                "daily_imps_appnexus_reviewed": 15226100,
                "has_resold": true,
                "visibility_rules": {
                    "id": 55,
                    "expose_publishers": true,
                    "expose_tags": true,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_universal_categories": true,
                    "expose_custom_categories": "all",
                    "url_exposure": "full",
                    "custom_categories": null
                }
            },
            ...
        ],
        "dbg_info": {...
        }
    }
}

取引サービスを使用して、Xandr に取引を追加します。 JSON POST で、次のことを確認します。
- フィールドを取引の code 内部 ID に設定します。
- オブジェクトの id フィールドを buyer 購入者のメンバー ID に設定します。
- フィールドを use_deal_floor "true" に設定し、フィールドを設定して取引フロアを floor_price 構成します。が true の場合 use_deal_floor 、取引のフロア価格は、配置や収益管理プロファイルなど、他のフロアをオーバーライドします。
- 常に JSON 内の次のフィールドを除外します。
  - profile_id, package_id , created_by, payment_type
- ほとんどの取引では、JSON で次のフィールドを除外することをお勧めします。
  - size_preference, audit_status_option, brand_restrict, category_restrict, language_restrict, technical_attribute_restrict, brands, categories, languages, technical_attributes, creatives, priority, allowed_media_types, allowed_media_subtypes, media_preference

手順 3. 取引 ID を使用して入札リクエストを送信する

入札要求を作成する方法の基本的なガイドラインについては、「OpenRTB 入札要求」を参照してください。さらに、取引に関する次の要件に注意してください。

入札要求には、という名前 pmpの追加オブジェクトが含まれている必要があります。
オブジェクト内には pmp 、公開する取引コードを含む配列も含 deals める必要があります。各取引コードは、その配列内のフィールドの id 値として指定する必要があります。

取引コードの配列を含むサンプル JSON ファイルを次に示します。

cat bid_deal_request.json
 
{
 "id": "TEGY5Ate8u",
 "imp": [
  {
   "id": "4aXAJyMUJe",
   "tagid": "yvU4UdeVeT",
 "banner": {
    "w": 300,
    "h": 250
   },
 "pmp": {
   "deals": [
      {
        "id": "Deal 1"
      },
      {
        "id": "Deal 2"
       }
     ]
 },
 "minduration": 0,
 "maxduration": 3600,
    "w": 300,
    "h": 360,
 "startdelay": 0
   }
  }
 ],
 "site": {
  "id": "yvU4UdeVeT",
 "publisher": {
   "id": "AQA1udaHAB"
  }
 },
"member_id": 95
}

次に、JSON 形式のファイルを POST します。メンバー ID は必ずクエリ文字列に含めます。

$ curl -X POST -d @bid_deal_request 'https://ib.adnxs.com/openrtb?member_id=123'

手順 4. 取引 ID に対する入札応答をリッスンする

OpenRTB 入札応答で関連 dealid する値をリッスンしていることを確認します。

{
 "id": "TEGY5Ate8u",
 "seatbid": [
  {
   "seat": "57",
   "bid": [
    {
     "impid": "4aXAJyMUJe",
     "price": 0.002000,
     "id": "4715012638089865238",
     "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"2.0\"><Ad id=\"38\"></Ad></VAST>",
     "adomain": ["appnexus.com"],
     "crid": "38",
     "cid": "57",
     "iurl": "https://01-impbus-test17987.envnxs.net/cr?id=38",
     "adid": "38",
     "dealid": "Deal 1"
    }
   ]
  }
 ],
 "cur": "USD"
}

次の方法で共有