Digital Platform API - Pixel Template サービス
この読み取り専用サービスを使用すると、Evidon や Brilig などの信頼された一般的に使用されるプロバイダーからの AppNexus 承認済みのクリエイティブ ピクセルに関する情報を表示できます。 AppNexus が承認したほとんどのクリエイティブ ピクセルは、再監査を行わずにクリエイティブに追加できます。
次に、動作のしくみを示します。
- ピクセル テンプレート サービスを使用して、クリエイティブに追加する AppNexus 承認済みのピクセルを見つけます。
- ピクセルの ID と、必要なパラメーターをメモします。
- 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}