サプライ パートナー - 入札要求

Xandr に入札要求を送信するには、 POST 入札要求の詳細を含む JSON 形式のファイルを次のエンドポイントに送信します。

https://ib.adnxs.com/asi?member_id=YOUR_PROD_MEMBER_ID

クライアント テスト環境でテストする場合は、エンドポイントにアクセスします POST 。

https://ib.client-testing.adnxs.net/asi?member_id=YOUR_TESTING_MEMBER_ID

要求の書式設定に関するガイダンスについては、ページの下部にある 例 を参照してください。

JSON フィールド

フィールドが内部値と外部値 (や など) で使用できる場合は、 int_blocked_categoriesext_blocked_categoriesJSON 形式のファイル内のフィールドの 1 つだけを含めます。 両方が含まれている場合は、内部値が使用されます。

書式設定の例: blocked_urls

{
"blocked_urls": [
"landingpage1.com",
"landingpage2.com"
]
}

配置マッピング

Xandr は、リクエストを Xandr のプレースメントにマップできる場合にのみ入札を送信します。 次のシーケンスで次の情報を確認します。

1. an_placement_id
2. ext_placement_code
3. ext_pub_code (発行元の既定のタグ)
4. メンバーの既定の配置 (運用ログイン資格情報が割り当てられる前に Technical Account Manager によってアカウント用に設定されます)。

上記のいずれも利用できない場合、Xandr は入札を送信しません。 Xandr ext_placement_code 内の 1 つの配置にのみマップでき、Xandr ext_pub_code 内の 1 つのパブリッシャーにのみマップできることに注意してください。

例

最小限許容される入札要求の送信

1. 必要なフィールドのみを含む JSON 形式のファイルを作成します。 この例では フィールドを an_user_id 使用しますが、代わりに を使用 ext_user_id できます。

   $ cat bid_request |
                  {
                  "an_user_id": 1089773736613054100,
                  "ext_auction_id": "395dj2j2j2dd",
                  "ad_format":"iframe",
                  "width": 300,
                  "height": 250
                  }
   

2. POST JSONフォーマットのファイルを開けます。 メンバー ID は必ずクエリ文字列に含めます。

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123'
   

Xandr 値のみを含む入札要求を送信する

1. パートナー値を指定する代わりに Xandr 値のフィールドを含む JSON 形式のファイルを作成します。たとえば、 an_user_idext_user_id ではなく、 int_blocked_technical_attributesext_blocked_technical_attributesではなく です。

   "$ cat bid_request"{
      "an_user_id":1089773736613054100,
      "ext_auction_id":"395dj2j2j2dd",
      "width":300,
      "height":250,
      "ad_format":"iframe",
      "ip_address":"38.108.249.106",
      "page_url":"publisher.com",
      "position":"above",
      "ext_pub_code":"203pub",
      "ext_site_code":"145site",
      "an_placement_id":40,
      "language":1,
      "user_agent":"Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8) Gecko/20100214 Ubuntu/9.10 (karmic) Firefox/3.5.8",
      "int_blocked_technical_attributes":[
         6,
         10,
         11
      ],
      "int_blocked_categories":[
         16,
         17,
         19
      ],
      "int_content_categories":[
         5,
         6,
         7
      ],
      "blocked_urls":[
         "landingpage1.com",
         "landingpage2.com",
         "landingpage3.com",
         "landingpage4.com",
         "landingpage5.com"
      ],
      "blocked_languages":[
         2,
         3,
         4,
         5,
         6,
         7,
         8,
         9,
         10
      ],
      "age":25,
      "gender":"male",
      "supply_type":"web"
   }
   

2. POST JSONフォーマットのファイルを開けます。 メンバー ID は必ずクエリ文字列に含めます。

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123'
   

外部値のみを含む入札要求の送信

1. Xandr 値ではなく、供給パートナー値のフィールドを含む JSON 形式のファイルを作成します。たとえば、 ext_placement_codean_placement_id ではなく、 ext_blocked_categoriesint_blocked_categoriesではなく です。

   $ cat bid_request
   {
       "ext_user_id": 1089773736613054100,
       "ext_auction_id": "395dj2j2j2dd",
       "width": 300,
       "height": 250,
       "ad_format": "iframe",
       "ip_address": "38.108.249.106",
       "page_url": "publisher.com",
       "position": "above",
       "ext_pub_code": "203pub",
       "ext_site_code": "145site",
       "ext_placement_code": "40placement",
       "language": 1,
       "user_agent": "Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8) Gecko/20100214 Ubuntu/9.10 (karmic) Firefox/3.5.8",
       "ext_blocked_technical_attributes": [
           3,
           5,
           8
       ],
       "ext_blocked_categories": [
           2,
           15,
           20
       ],
       "ext_content_categories": [
           2,
           9,
           13
       ],
       "blocked_urls": [
           "landingpage1.com",
           "landingpage2.com",
           "landingpage3.com",
           "landingpage4.com",
           "landingpage5.com"
       ],
       "blocked_languages": [
           2,
           3,
           4,
           5,
           6,
           7,
           8,
           9,
           10
       ],
       "age": 25,
       "gender": "male",
       "supply_type": "web"
   }
   

2. POST JSONフォーマットのファイルを開けます。 メンバー ID は必ずクエリ文字列に含めます。

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123'
   

ブロックの詳細を含まない入札要求の送信

パブリッシャーの設定を適用するように広告プロファイルを設定する場合は、入札リクエストでブロックの詳細を指定する必要はありません。

1. 技術的属性、クリエイティブ カテゴリ、コンテンツ カテゴリ、URL、言語をブロックするためのフィールドを除く JSON 形式のファイルを作成します。

   $ cat bid_request
   {
       "an_user_id": 1089773736613054100,
       "ext_auction_id": "395dj2j2j2dd",
       "width": 300,
       "height": 250,
       "ad_format": "iframe",
       "ip_address": "38.108.249.106",
       "page_url": "publisher.com",
       "position": "above",
       "ext_pub_code": "203pub",
       "ext_site_code": "145site",
       "an_placement_id": "40",
       "language": 1,
       "user_agent": "Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8) Gecko/20100214 Ubuntu/9.10 (karmic) Firefox/3.5.8",
       "age": 25,
       "gender": "male",
       "supply_type": "web"
   }
   

2. POST JSONフォーマットのファイルを開けます。 メンバー ID は必ずクエリ文字列に含めます。

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123' 
   

VAST ビデオ クリエイティブの入札リクエストの送信 (まだサポートされていません)

VAST ビデオ クリエイティブを要求する場合:

• を ad_format "vast" に設定する必要があります。
• は width 1 に設定する必要があります。
• は height 1 に設定する必要があります。
• 要求は、Xandr システム内の配置にマップする必要があります。これにより、"Video" メディア タイプのクリエイティブ、または "15 秒 VAST"、"30 秒 VAST"、または "Other VAST" メディア サブタイプの任意の組み合わせが可能になります。 要求がビデオ以外の配置にマップされている場合、AppNexus はエラーで応答します (広告の形式が配置形式と一致しません)。 使用する配置を検索する方法の詳細については、上の 「配置マッピング 」を参照してください。
• 渡ext_blocked_technical_attributesしたり、必要な VAST ビデオの再生時間を定義したりしないでくださいint_blocked_technical_attributes。 代わりに、前述のように、Xandr 配置で許可される VAST ビデオの再生時間を定義する必要があります。
• 入札応答のフィールドにカスタム パラメーター ad_tag を含める供給テンプレートを設定するように Xandr に依頼した場合は、その供給テンプレートの ID に設定 template_id します。 詳細については、入札応答ドキュメントの「供給テンプレート」を参照してください。

1. 上記の要件に従って JSON 形式のファイルを作成します。 この例では、VAST ビデオ クリエイティブを許可するように定義された Xandr システムに特定の配置があることを前提としています。 この配置の ID は、 フィールドに an_placement_id 渡されます。

   $ cat bid_request
   {
       "an_user_id": 1089773736613054100,
       "ext_auction_id": "395dj2j2j2dd",
       "ad_format":"vast",
       "width": 1,
       "height": 1.
       "an_placement_id": 204,
       "tmpl_id": 4,
       "ip_address": "38.108.249.106",
       "page_url": "ibdo.com",
       "position": "unknown",
       "language": 0,
       "user_agent": "Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8) Gecko/20100214 Ubuntu/9.10 (karmic) Firefox/3.5.8",
       "age": 25,
       "gender": "female"
   }
   

2. POST JSONフォーマットのファイルを開けます。 メンバー ID は必ずクエリ文字列に含めます。

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123'