次の方法で共有

Bidders - ピクセル テンプレート サービス

  • [アーティクル]

この読み取り専用サービスを使用すると、Evidon や Brilig などの信頼された一般的に使用されるプロバイダーから Xandr が承認したクリエイティブ ピクセルに関する情報を表示できます。 Xandr で承認されたほとんどのクリエイティブ ピクセルは、再監査を行わずにクリエイティブに追加できます。

次に、動作のしくみを示します。

  1. ピクセル テンプレート サービスを使用して、クリエイティブに追加する Xandr 承認済みのピクセルを見つけます。
  2. ピクセルの ID と、必要なパラメーターをメモします。
  3. Creative Service のピクセル配列を使用して、クリエイティブにピクセルを追加し、必要なパラメーターの値を定義します。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.adnxs.com/pixel-template Xandr が承認したすべてのクリエイティブ ピクセルを表示するには。
GET https://api.adnxs.com/pixel-template/PIXEL_TEMPLATE_ID 特定の Xandr 承認済みのクリエイティブ ピクセルを表示するには。

JSON フィールド

フィールド 種類 説明
id int Xandr が承認したクリエイティブ ピクセルの ID。
name string Xandr が承認したクリエイティブ ピクセルの名前。
format 列挙 Xandr が承認したクリエイティブ ピクセルの形式。 使用可能な値: "raw-js"、、"url-html""url-js"、または "url-image"。
content string クリエイティブ ピクセルの HTML または JavaScript コンテンツ。 format が の場合は、このフィールドが "raw-js"含まれます。
secure_content string クリエイティブ ピクセルの安全な HTML または JavaScript コンテンツ。 format が の場合は、このフィールドが "raw-js"含まれます。
url string html、JavaScript、またはイメージ クリエイティブ ピクセルの URL。 このフィールドは、format が "url-html"、、 "url-js"または "url-image"の場合に含まれます。
secure_url string html、JavaScript、またはイメージ クリエイティブ ピクセルのセキュリティで保護された URL。 このフィールドは、format が "url-html"、、 "url-js"または "url-image"の場合に含まれます。
num_required_params int クリエイティブにピクセルを追加するときに定義する必要があるパラメーターの数。
require_reaudit ブール値 true の場合、クリエイティブにピクセルを追加すると、クリエイティブが監査のために再送信されます。

例

Xandr が承認したすべてのクリエイティブ ピクセルを表示する

$ curl -b cookies -c cookies 'https://api.adnxs.com/pixel-template'
{
    "response": {
        "status": "OK",
        "count": 3,
        "start_element": 0,
        "num_elements": 100,
        "pixel-templates": [
            {
                "id": 1,
                "name": "Evidon AdChoices Icon",
                "format": "raw-js",
                "content": "(function() {document.write('<sc'+'ript type=\"text/javascript\"' + ((\"https:\"
                 == document.location.protocol) ? \"https://c.betrad.com\" : \"http://c.betrad.com\") +
                 '/surly.js?;ad_wxh=${CREATIVE_SIZE};coid=${P1};nid=${P2};${P3}\"></scr'+'ipt>');}());",
                "num_required_params": 2,
                "require_reaudit": false
            },
            {
                "id": 2,
                "name": "Brilig Impression Tracker",
                "format": "url-image",
                "num_required_params": 1,
                "require_reaudit": false,
                "url": "http://p.brilig.com/contact/bct?pid=${P1}&_ct=pixel&adid=${CP_ID}&action=1"
            },
            {
                "id": 3,
                "name": "Alenty Impression Tracker",
                "format": "raw-js",
                "content": "var lnte = window.document.createElement('SCRIPT');lnte.src = 'http://js.alenty.com/
                 apnxs/l/adtrk.js'+'#customer_id=${P1}'+';advertiser=${ADV_ID}'+';campaign=${CP_ID}'+';creative=
                 ${CREATIVE_ID}'+';dimension=${WIDTH}x${HEIGHT}'+';site=${INV_SOURCE_ID}'+';sitepage=${PUBLISHER_ID}
                 _${SITE_ID}'+';external_id=-a--${SSP_DATA}-b--${PRICE_PAID}'+';url=' + encodeURIComponent
                 ('${REFERER_URL_ENC}'); lnte.type = \"text/javascript\"; window.document.body.insertBefore(lnte,
                 window.document.body.lastChild);",
                "num_required_params": 1,
                "require_reaudit": false
            },
            ...
        ],
        "dbg": {
            ...
        }
    }
}

特定の Xandr 承認済みのクリエイティブ ピクセルを表示する

$ curl -b cookies -c cookies 'https://api.adnxs.com/pixel-template/1'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "pixel-template": {
            "id": 1,
            "name": "Evidon AdChoices Icon",
            "format": "raw-js",
            "content": "(function() {document.write('<sc'+'ript type=\"text/javascript\"' + ((\"https:\"
             == document.location.protocol) ? \"https://c.betrad.com\" : \"http://c.betrad.com\") +
             /surly.js?;ad_wxh=${CREATIVE_SIZE};coid=${P1};nid=${P2};${P3}\"></scr'+'ipt>');}());",
            "num_required_params": 2,
            "require_reaudit": false
        },
        "dbg": {
            ...
        }
    }
}