次の方法で共有

Digital Platform API - Pixel Template サービス

  • [アーティクル]

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

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

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

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/pixel-template AppNexus が承認したすべてのクリエイティブ ピクセルを表示します。
GET https://api.appnexus.com/pixel-template?id=PIXEL_TEMPLATE_ID 特定の AppNexus 承認済みのクリエイティブ ピクセルを表示します。
GET https://api.appnexus.com/pixel-template?id=1,2,3 コンマ区切りリストを使用して、ID で複数のクリエイティブ ピクセルを表示します。

JSON フィールド

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

例

AppNexus で承認されたすべてのクリエイティブ ピクセルを表示する

{code}$ curl -b cookies -c cookies 'https://api.appnexus.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
            }
        ]
    }
}
{code}

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

{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/pixel-template?id=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
        }
    }
}
{code}