API de plateforme numérique - 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 AppNexus à partir de fournisseurs approuvés couramment utilisés, tels que Evidon et Brilig. La plupart des pixels créatifs approuvés par AppNexus 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 AppNexus 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.appnexus.com/pixel-template	Affichez tous les pixels créatifs approuvés par AppNexus.
GET	https://api.appnexus.com/pixel-template?id=PIXEL_TEMPLATE_ID	Affichez un pixel créatif approuvé par AppNexus.
GET	https://api.appnexus.com/pixel-template?id=1,2,3	Affichez plusieurs pixels créatifs par ID à l’aide d’une liste séparée par des virgules.

Champs JSON

Champ	Type	Description
id	int	ID du pixel créatif approuvé par AppNexus.
name	string	Nom du pixel créatif approuvé par AppNexus.
format	enum	Format du pixel créatif approuvé par AppNexus. Valeurs possibles : - "raw-js" - "url-html" - "url-js" - "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 à un créatif entraîne la soumission du créatif à des fins d’audit.

Exemples

Affichage de tous les pixels créatifs approuvés par 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}

Affichage d’un pixel créatif approuvé par AppNexus spécifique

{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}