Partager via

Soumissionnaires - Service de modèle de pixels

Ce service en lecture seule vous permet d’afficher des informations sur les pixels créatifs approuvés par Xandr à partir de fournisseurs approuvés et couramment utilisés, tels que Evidon et Brilig. La plupart des pixels créatifs approuvés par Xandr peuvent être ajoutés aux éléments créatifs sans provoquer de ré-audit.

Voici le principe de fonctionnement :

  1. Vous utilisez le service de modèle de pixels pour rechercher le pixel approuvé par Xandr que vous souhaitez ajouter à votre création.
  2. Vous notez l’ID du pixel ainsi que ses paramètres requis.
  3. Vous utilisez le tableau de pixels dans Creative Service pour ajouter le pixel à votre créativité et définir des valeurs pour les paramètres requis.

API REST

HTTP, méthode Endpoint Description
GET https://api.adnxs.com/pixel-template Pour afficher tous les pixels créatifs approuvés par Xandr.
GET https://api.adnxs.com/pixel-template/PIXEL_TEMPLATE_ID Pour afficher un pixel créatif approuvé par Xandr spécifique.

Champs JSON

Champ Type Description
id int ID du pixel créatif approuvé par Xandr.
name string Nom du pixel créatif approuvé par Xandr.
format enum Format du pixel créatif approuvé par Xandr. Valeurs possibles : "raw-js", "url-html", "url-js"ou "url-image".
content string Contenu HTML ou JavaScript du pixel créatif. Ce champ est inclus si le format est "raw-js".
secure_content string Contenu HTML ou JavaScript sécurisé du pixel créatif. Ce champ est inclus si le format est "raw-js".
url string URL du pixel créatif html, JavaScript ou image. Ce champ est inclus si le format est "url-html", "url-js"ou "url-image".
secure_url chaîne URL sécurisée du pixel créatif html, JavaScript ou image. Ce champ est inclus si le format est "url-html", "url-js"ou "url-image".
num_required_params int Nombre de paramètres qui doivent être définis lors de l’ajout du pixel à un élément créatif.
require_reaudit valeur booléenne Si la valeur est true, l’ajout du pixel à une création entraîne la soumission du créatif à des fins d’audit.

Exemples

Afficher tous les pixels créatifs approuvés par 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": {
            ...
        }
    }
}

Afficher un pixel créatif approuvé par Xandr spécifique

$ 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": {
            ...
        }
    }
}
  • Last updated on