Licitadores: servicio de plantilla de píxeles

Artículo
05/18/2024

Este servicio de solo lectura le permite ver información sobre los píxeles creativos aprobados por Xandr de proveedores de confianza y de uso común, como Evidon y Brilig. La mayoría de los píxeles creativos aprobados por Xandr se pueden agregar a las creatividades sin provocar una nueva auditoría.

Aquí se muestra cómo funciona:

Use el servicio de plantilla de píxeles para buscar el píxel aprobado por Xandr que desea agregar a la creatividad.
Anote el identificador del píxel, así como sus parámetros necesarios.
La matriz de píxeles de Creative Service se usa para agregar el píxel a la creatividad y definir valores para los parámetros necesarios.

API de REST

Http (método)	Endpoint	Description
`GET`	`https://api.adnxs.com/pixel-template`	Para ver todos los píxeles creativos aprobados por Xandr.
`GET`	`https://api.adnxs.com/pixel-template/PIXEL_TEMPLATE_ID`	Para ver un píxel creativo específico aprobado por Xandr.

Campos JSON

Campo	Tipo	Description
`id`	Entero	Identificador del píxel creativo aprobado por Xandr.
`name`	string	Nombre del píxel creativo aprobado por Xandr.
`format`	enumeración	Formato del píxel creativo aprobado por Xandr. Valores posibles: `"raw-js"`, `"url-html"`, `"url-js"`o `"url-image"`.
`content`	string	Contenido HTML o JavaScript del píxel creativo. Este campo se incluye si el formato es `"raw-js"`.
`secure_content`	string	El contenido HTML o JavaScript seguro del píxel creativo. Este campo se incluye si el formato es `"raw-js"`.
`url`	string	Dirección URL del píxel creativo html, JavaScript o imagen. Este campo se incluye si el formato es `"url-html"`, `"url-js"`o `"url-image"`.
`secure_url`	string	Dirección URL segura del píxel creativo html, JavaScript o imagen. Este campo se incluye si el formato es `"url-html"`, `"url-js"`o `"url-image"`.
`num_required_params`	Entero	Número de parámetros que se deben definir al agregar el píxel a una creatividad.
`require_reaudit`	booleano	Si es true, agregar el píxel a una creatividad hace que la creatividad se vuelva a enviar para la auditoría.

Ejemplos

Visualización de todos los píxeles creativos aprobados por 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": {
            ...
        }
    }
}

Visualización de un píxel creativo específico aprobado por 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": {
            ...
        }
    }
}

Compartir a través de