次の方法で共有

サプライ パートナー - 入札応答

  • [アーティクル]

警告

2017 年 10 月 1 日より、サーバー側の供給統合に対して Supply Integration (ASI) プロトコル (旧称 AppNexus Supply Integration) を無効にしました。 OpenRTB プロトコルに供給を移行することを強くお勧めします。 このセクションのすべてが従来のコンテンツです。

入札要求を送信すると、Xandr は JSON 形式で入札応答を返します。 このページでは、可能な JSON フィールドとその値について説明します。 ページの下部にある例は、次の場合に返されるフィールドを示しています。

  • Xandr が入札を送信する
  • Xandr が入札を送信しない - 入札なし
  • Xandr が入札を送信しない - エラー
  • Xandr が VAST ビデオ クリエイティブを送信する (まだサポートされていません)

ヒント

Xandr の入札がオークションに勝った場合は、Web ページにタグを配置する %%pricepaid%% 前に、 の ad_tag マクロに落札価格を挿入する必要があります。

JSON フィールド

フィールド 種類 説明 例
external_auction_id string 入札要求で送信されたサプライ パートナー オークションの ID。 "A4s24536"
appnexus_auction_id int Xandr は独自のオークションを開催し、オークションに提出する入札を選択します。 これは Xandr オークション イベントの ID です。 4396943919143109134
bid decimal Xandr 入札の CPM 値。 0.206367
creative_id int Xandr がオークションに勝った場合に配信されるクリエイティブの ID。 345634
landing_page_url string クリエイティブのランディング ページ URL。 "www.landingpage.com"
brand_id int クリエイティブのブランドの Xandr ID。 ブランド ID を名前にマップするには、 ブランド サービスを使用します。 12
buyer_member_id int クリエイティブを所有するメンバーの ID。 3453
no_bid ブール値 true の場合、Xandr にはオークションの入札はありません。 false
request_error ブール値 true の場合、エラーにより Xandr が入札を送信できませんでした。 false
request_error_id int エラーの ID。 このフィールドは、request_errorが true の場合にのみ返されます。 考えられるすべてのエラー ID とその意味については、以下の 「エラー 」セクションを参照してください。 3
ad_tag string Xandr がオークションに勝った場合に Web ページに配置される広告タグ。

メモ：クリックを追跡する場合、Xandr はクリック URL のマクロを追加できます。 &pubclick=%%pub_click_url%%

この機能の詳細については、実装チームにお問い合わせください。		 以下 の例を 参照してください。

供給テンプレート

VAST ビデオ クリエイティブの場合、通常は入札応答に含まれていないカスタム パラメーターが ad_tag 必要な場合は、Xandr に供給テンプレートを作成するよう依頼できます。 次に、動作のしくみを示します。

  1. VAST ビデオ クリエイティブに返されるカスタム パラメーターについて、Xandr の担当者と直接やり取りします。
  2. Xandr が要求に同意した場合、Xandr は提供テンプレートを作成して ID を送信します。
  3. VAST ビデオ クリエイティブの入札リクエストには、フィールドにサプライ テンプレート ID を template_id 含めます。
  4. 入札応答では、供給テンプレートによって、 のセクションにカスタム パラメーターが <Extensions> 追加されます ad_tag。

例

たとえば、Xandr に VAST ビデオ クリエイティブの次の補足情報を含める必要があるとします。

  • 入札戦略 (CPM、CPC など)
  • 通貨
  • 入札のソース

Xandr が作成する供給テンプレートは、 のセクションにこの情報を<Extensions>ad_tag追加します。

"ad_tag":"<?xml version="1.0" encoding="UTF-8" standalone="no"?><VAST version="2.0" xmlns:xsi=
                "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd">
                <Ad id="560469"><Wrapper><AdSystem version="1.0">adnxs</AdSystem><VASTAdTagURI><![CDA
                TA[http://ib.adnxs.com/ab?enc=AAAAAAAA8D8AAAAAAADwPwAAAAAAAPA_AAAAAAAA8D8AAAAAAADwPwkWl1e
                GIxl9XgZfiHCnHw8p021QAAAAADd8CQBVBAAAVQQAAA0AAABVjQgAMmgBAAAAAQBVU0QAVVNEAAEAAQASEwAAVgAB
                BAMCAQUAAIIAaRIvXgAAAAA.&cnd=%21chngsgiT1QUQ1ZoiGAAgstAFMAA4kqYEQARI1QhQt_glWABgLmgAcAB4A
                IABAIgBAJABAZgBAaABAagBALABALkBAAAAAA AA8D_BAQA AAAAAAPA_yQEzMzMzMzMDQNkBAAAAAAAA8D_gAQA.
                &udj=uf%28%27a%27%2C+51512%2C+1349374761%29%3Buf%28%27r%27%2C+560469%2C+1349374761%29%3B&
                ccd=%212gSgJwiT1QUQ1ZoiGLLQBSAE&vpid=171&referrer=espn.com&dlo=1&pp=%%pricepaid%%]>
                </VASTAdTagURI><Impression></Impression><Creatives><Creative AdID="560469"><Linear>
                </Linear></Creative></Creatives><Extensions><Extension type="Partner Name">
                <Price model="CPM" currency="USD" source="AppNexus">1</Price></Extension>
                </Extensions></Wrapper></>"

注:

VAST ビデオ クリエイティブの完全な入札応答については、以下の 例を 参照してください。

エラー

エラーによって Xandr が入札を送信できなくなると、応答内の が request_error_id 問題の診断に役立ちます。

request_error_id 意味
1 入札要求の構文が正しくありません。
2 要求のメンバー ID を解析できませんでした。
3 要求が Xandr ユーザー ID にマップされませんでした。
4 入札要求に が含 external_auction_idまれていませんでした。
5 要求が配置にマップされませんでした。
6 Xandr オークションに失敗しました。
7 要求されたが ad_format 配置形式と一致しませんでした。
8 渡されたインベントリ (例: page_url) またはユーザー (例: ip_address) は Xandr によってブロックされます。
9 ad_formatパラメーター (必須) が要求で渡されませんでした。

注:

**エラー ID 8 は、渡されたドメインが購入メンバーのグローバル ターゲット プロファイルによって除外された場合にもトリガーされます。

例

Xandr が入札を送信する

{
    "external_auction_id": "A4s24536",
    "appnexus_auction_id": 4396943919143109000,
    "request_error": false,
    "no_bid": false,
    "bid": 0.206367,
    "creative_id": 345634,
    "landing_page_url": "http://www.landingpage.com",
    "brand_id": 12,
    "buyer_member_id": 328,
    "ad_tag": "<scriptsrc='http: //ib.adnxs.com/ab?enc=nkFD_wQXyz-iXL8FfvnHPwAAAAAAAOA_oly_BX75xz-eQUP_BBfLP0p8RFYC0OIKHKmTLdGzBl2rOWpOAAAAALGQCADLAQAAbAEAAAIAAACyGQkAmwkBAAEAAABVU0QAVVNEANgCWgC0AoMDvw4BAgUCAQQAAAAAciHhvwAAAAA.&tt_code=13394&udj=uf%28%27a%27%2C+1008%2C+1315584427%29%3Buf%28%27c%27%2C+117682%2C+1315584427%29%3Buf%28%27g%27%2C+51717%2C+1315584427%29%3Buf%28%27r%27%2C+596402%2C+1315584427%29%3Bppv%2815221%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815223%2C+%27784417993571728458%27%2C+1315584427%2C+1315670827%2C+117682%2C+67995%29%3Bppv%2815225%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815227%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815229%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815231%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3B&cnd=!VyRDEwiylwcQsrMkGAAgm5MEMAA4tAVAAEjsAlAAWABgrARoAHAAeACAAQCIAQCQAQGYAQGgAQGoAQOwAQC5AUw3iUFg5cA_wQFwscHFBhfLP8kBmpmZmZmZ8T_ZAYV80LNZ9eM_4AHkKA..&ccd=!XASOJAiylwcQsrMkGJuTBCAA&referrer=http: //www.nydailynews.com&media_subtypes=1&pp=%%pricepaid%%'></script>"
}

Xandr が入札を送信しない - 入札なし

{
   "external_auction_id":"A4s24536",
   "no_bid":true,
   "request_error":false
}

Xandr が入札を送信しない - エラー

{
   "external_auction_id":"A4s24536",
   "no_bid":true,
   "request_error":true,
   "request_error_id":2
}

Xandr が VAST ビデオ クリエイティブを送信する (まだサポートされていません)

Xandr が VAST ビデオ クリエイティブを送信する場合:

  • クリエイティブは、エスケープされた VAST XML としてフィールドに ad_tag 渡されます。
  • 入札がオークションに勝った場合は、コンテンツをページに配置する前にスケープを取り出す必要があります。
  • 入札がオークションに勝った場合は、 のマクロに落札価格 (CPM) を挿入する%%pricepaid%%ad_tag必要があります。
  • VAST クリエイティブの入札でカスタム パラメーターを渡すサプライ テンプレートを作成するように Xandr に依頼した場合、それらのカスタム パラメーターは 内の XML のタグ内にad_tag表示されます<Extensions>。 次の例では、供給テンプレートによって入札価格に関する補足情報が追加されています。 サプライ テンプレートの詳細については、上記の 「サプライ テンプレート 」を参照してください。

ヒント

業界標準のプラクティスに従って、Xandr は WIN に対する VAST の印象を記録しません。 代わりに、インプレッションはビデオが開始された後にのみ記録されます (ユーザーが再生をクリックするなど)。

{
   "external_auction_id":"A4s24536",
   "appnexus_auction_id":4396943919143109134,
   "request_error":false,
   "no_bid":false,
   "bid":2.000000,
   "creative_id":345634,
   "landing_page_url":"http://www.landingpage.com",
   "brand_id":12,
   "buyer_member_id":328,
   "ad_tag":"<?xml version="1.0" encoding="UTF-8" standalone="no"?><VAST version="2.0" xmlns:xsi=
                "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd">
                <Ad id="560469"><Wrapper><AdSystem version="1.0">adnxs</AdSystem><VASTAdTagURI><![CDA
                TA[http://ib.adnxs.com/ab?enc=AAAAAAAA8D8AAAAAAADwPwAAAAAAAPA_AAAAAAAA8D8AAAAAAADwPwkWl1e
                GIxl9XgZfiHCnHw8p021QAAAAADd8CQBVBAAAVQQAAA0AAABVjQgAMmgBAAAAAQBVU0QAVVNEAAEAAQASEwAAVgAB
                BAMCAQUAAIIAaRIvXgAAAAA.&cnd=%21chngsgiT1QUQ1ZoiGAAgstAFMAA4kqYEQARI1QhQt_glWABgLmgAcAB4A
                IABAIgBAJABAZgBAaABAagBALABALkBAAAAAA AA8D_BAQA AAAAAAPA_yQEzMzMzMzMDQNkBAAAAAAAA8D_gAQA.
                &udj=uf%28%27a%27%2C+51512%2C+1349374761%29%3Buf%28%27r%27%2C+560469%2C+1349374761%29%3B&
                ccd=%212gSgJwiT1QUQ1ZoiGLLQBSAE&vpid=171&referrer=espn.com&dlo=1&pp=%%pricepaid%%]>
                </VASTAdTagURI><Impression></Impression><Creatives><Creative AdID="560469"><Linear>
                </Linear></Creative></Creatives><Extensions><Extension type="Partner Name">
                <Price model="CPM" currency="USD" source="AppNexus">1</Price></Extension>
                </Extensions></Wrapper></>"
}

注:

以下の取引フィールドは、Xandr 従業員にのみ表示されます。

Xandr が取引の入札を送信する

{
    "external_auction_id": "A4s24536",
    "appnexus_auction_id": 4396943919143109000,
    "request_error": false,
    "no_bid": false,
    "bid": 0.206367,
    "creative_id": 345634,
    "landing_page_url": "http://www.landingpage.com",
    "brand_id": 12,
    "buyer_member_id": 328,
    "deal_code": "This is a big deal",
    "deal_id": 123456,
    "ad_tag": "<scriptsrc='http: //ib.adnxs.com/ab?enc=nkFD_wQXyz-iXL8FfvnHPwAAAAAAAOA_oly_BX75xz-eQUP_BBfLP0p8RFYC0OIKHKmTLdGzBl2rOWpOAAAAALGQCADLAQAAbAEAAAIAAACyGQkAmwkBAAEAAABVU0QAVVNEANgCWgC0AoMDvw4BAgUCAQQAAAAAciHhvwAAAAA.&tt_code=13394&udj=uf%28%27a%27%2C+1008%2C+1315584427%29%3Buf%28%27c%27%2C+117682%2C+1315584427%29%3Buf%28%27g%27%2C+51717%2C+1315584427%29%3Buf%28%27r%27%2C+596402%2C+1315584427%29%3Bppv%2815221%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815223%2C+%27784417993571728458%27%2C+1315584427%2C+1315670827%2C+117682%2C+67995%29%3Bppv%2815225%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815227%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815229%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815231%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3B&cnd=!VyRDEwiylwcQsrMkGAAgm5MEMAA4tAVAAEjsAlAAWABgrARoAHAAeACAAQCIAQCQAQGYAQGgAQGoAQOwAQC5AUw3iUFg5cA_wQFwscHFBhfLP8kBmpmZmZmZ8T_ZAYV80LNZ9eM_4AHkKA..&ccd=!XASOJAiylwcQsrMkGJuTBCAA&referrer=http: //www.nydailynews.com&media_subtypes=1&pp=%%pricepaid%%'></script>"
}