Licitadores - Servicio creativo

Xandr trabaja con miembros que se preocupan profundamente por la marca y la reputación. Por este motivo, nos aseguramos de que los anuncios (creatividades) que pasan por nuestro sistema sean aceptables para todas las partes. Para garantizar la calidad, todas las creatividades que sirven en el inventario de terceros deben registrarse previamente mediante el Servicio de creatividades.

• Las creatividades se identifican por su media_url (ya sea una URL del servidor de anuncios de terceros o una URL de red de entrega de contenido para un archivo flash/GIF).
• Comprobaremos media_urls regularmente. Si un archivo desaparece, la creatividad se tratará como no auditada.
• Se enviará una solicitud de notificación de auditoría al controlador de audit_notify_uri para cada creatividad cuyo estado de auditoría haya cambiado.
• Está absolutamente prohibido cargar malware o creatividades engañosas, o etiquetar incorrectamente creatividades a propósito.
• Se recomienda encarecidamente configurar su miembro (consulte el Servicio para miembros) para recibir correos electrónicos cuando:
  • La creatividad se audita (mediante la configuración del campo audit_notify_email en el Servicio para miembros).
  • Sherlock ha escaneado la creatividad (configurando el sherlock_notify_email en el Servicio para miembros).

Permisos:

• Solo el administrador puede cambiar el audit_status campo.
• Las creatividades que se modifiquen después de haber sido auditadas volverán a un pending estado de auditoría.

API de REST

Estructura JSON

Móvil

Audio

Atributo de vídeo

El identificador de plantilla es video_attribute 6439 - Vídeo: Standard VAST (también acepta VPAID), y el objeto incluye los siguientes campos:

Contenedor de atributos de vídeo

El wrapper objeto contiene los siguientes campos:

Elemento contenedor de atributos de vídeo

La elements matriz contiene los siguientes campos:

Se debe especificar al menos un elemento.

Seguimientos de eventos de atributos de vídeo

Puedes colocar píxeles en cada evento del que realizamos un seguimiento en los informes (consulta vast_event_type_id continuación). Agregue los píxeles como trackers en la creatividad. La trackers matriz contiene los siguientes campos:

Plantilla creativa

Puede utilizar el Servicio de plantillas creativas para ver todas las plantillas de representación que se pueden asignar a las creatividades.

Aquí tienes identificadores de plantilla estándar para los formatos creativos más comunes.

Para los recursos creativos expandibles, consulta la página Expandibles y Rich Media para obtener más detalles.

Estado

Atributo nativo

El native_attribute objeto contiene los siguientes campos. Para obtener más información, consulte Agregar una creatividad nativa en los ejemplos .

Vínculo

El link objeto contiene la URL de la página de aterrizaje, la URL de reserva y los rastreadores asociados a la creatividad nativa. El link objeto es necesario para el atributo nativo.

El link objeto incluye los siguientes campos:

Rastreadores

Rastreadores de imágenes

Rastreadores de JavaScript

Recursos de datos

El data_assets objeto incluye los siguientes campos:

Recursos de imagen

El objeto de imagen_assets incluye los siguientes campos:

Imagen de recurso creativo

Recursos de vídeo

El objeto video_assets incluye los siguientes campos:

Pixels

Utilice esta matriz para agregar hasta cinco píxeles personalizados y aprobados por Xandr a una creatividad.

Los píxeles aprobados por Xandr proceden de proveedores de confianza que se usan habitualmente. La mayoría de ellos no hacen que la creatividad se vuelva a enviar para auditoría. Para añadir un píxel aprobado por Xandr a una creatividad, solo debe pasar el pixel_template_id y el número de parámetros que requiere el píxel. Consulte el ejemplo "Agregar un píxel aprobado por Xandr a una creatividad" a continuación para obtener más instrucciones. Tenga en cuenta que puede usar el servicio de plantillas de píxeles para obtener información sobre estos píxeles, incluso si activan o no una nueva auditoría.

Los píxeles personalizados los defines tú y hacen que la creatividad se vuelva a enviar para su auditoría. Para agregar un píxel personalizado, debe pasar solo el formato y, según el formato, el contenido o la URL. Consulte el ejemplo Agregar un píxel personalizado a una creatividad a continuación para obtener más instrucciones.

Segmentos

Estos campos se incluirán en la matriz Segments:

Cambios que provocan Re-Audit

Una vez que una creatividad ha superado la auditoría de Xandr (audit_status es "auditada"), el cambio de cualquiera de los siguientes campos hace que la creatividad se vuelva a enviar para la auditoría (allow_audit se establece como "pendiente"):

• width
• height
• contenido
• media_url
• click_url
• template
• custom_macros
• media_subtypes
• language
• categories
• technical_attributes
• brand_id
• pixel_url
• píxeles (si agrega o quita un píxel personalizado o un píxel aprobado por Xandr)
• text_title (si el texto es creativo)
• text_description (si el texto es creativo)
• text_display_url (si el texto es creativo)
• pop_window_maximize (si es creativo pop)
• pop_is_tag_initiated (si es pop, creativo y cambia de falso a verdadero)
• video_attribute
• media_assets

Además, si el audit_status es "no_audit", cambiar allow_audit de "falso" a "verdadero" hace que la creatividad se vuelva a enviar para la auditoría de Xandr.

Ejemplos

Agregar una creatividad

$ cat creative
{
 "creative":
  {     "width" : 300,
        "height" : 250,
        "media_url" : "https://ad.doubleclick.net/adi/ABC.Advertising.com/DEF.40;sz=300x250;click0=",
        "template":{
           "id": 1
        },
       "is_political_and_eu_targeted": false,
       "is_political_and_non_eu_targeted": false
  }
}

$ curl -b cookies -c cookies -X POST -d @creative.json "https://api.adnxs.com/creative/5"
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 703355,
    "creative": {
      "id": 703355,
      "active": true,
      "member_id": 5,
      "description": null,
      "code": null,
      "code2": null,
      "media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
      "audit_status": "pending",
      "allow_audit": true,
      "size_in_bytes": 0,
      "last_checked": null,
      "not_found": 0,
      "added_by_bidder": null,
      "campaign": null,
      "placement": null,
      "format": null,
      "width": 300,
      "height": 250,
      "click_url": null,
      "landing_page_url": null,
      "flash_click_variable": null,
      "no_iframes": false,
      "content": null,
      "original_content": null,
      "track_clicks": true,
      "audit_feedback": null,
      "created_on": "2013-10-31 21:17:17",
      "flash_backup_url": null,
      "is_self_audited": false,
      "file_name": null,
      "is_prohibited": false,
      "last_activity": "2013-10-31 21:17:17",
      "passed_sherlock_audit": true,
      "is_expired": false,
      "creative_upload_status": null,
      "backup_upload_status": null,
      "filter": null,
      "is_suspicious": false,
      "suspicious_activity_timestamp": null,
      "media_subtypes": [
        "banner"
      ],
      "no_adservers": false,
      "is_blanking": false,
      "is_rotating": false,
      "text_title": null,
      "text_description": null,
      "text_display_url": null,
      "click_action": "click-to-web",
      "click_target": null,
      "ssl_status": "disabled",
      "allow_ssl_audit": false,
      "media_url_secure": null,
      "content_secure": null,
      "original_content_secure": null,
      "flash_backup_url_secure": null,
      "is_hosted": false,
      "content_source": "standard",
      "thirdparty_creative_id": null,
      "thirdparty_campaign_id": null,
      "custom_request_template": null,
      "categories": 
     [
        {
        "id": 37,
        "name": "Politics",
        "self declared": true,
        }
     ],
      "brand": {
       "id": 1,
       "name": "Unknown",
       "category_id": 8
      },
      "language": {
        "id": 1,
        "name": "English"
      },
      "template": {
        "id": 1
      },
      "segments": null,
      "pixels": null,
      "mobile": null,
      "brand_id": 1,
      "sla": "0",
      "sla_eta": "2013-11-01 11:18:17"
    }
  }
}

Ver el recurso creativo que se ha agregado

$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "creative":{
                "id": 6,
                "active": true,
                "member_id": 5,
                "description": null,
                "code": null,
                "brand_id": 43,
                "media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
                "audit_status": "pending",
                "allow_audit": true,
                "size_in_bytes": 18467,
                "last_checked": null,
                "not_found": false,
                "added_by_bidder": 14,
                "campaign": null,
                "placement": null,
                "format": "url-html",
                "width": 300,
                "height": 250,
                "click_url": "",
                "flash_click_variable": null,
                "pixel_url": "",
                "no_iframes": false,
                "content": null,
                "original_content": null,
                "track_clicks": true,
                "pixel_type": "image",
                "audit_feedback": null,
                "created_on": "0000-00-00 00:00:00",
                "flash_backup_url": null,
                                "is_self_audited": false,
                "last_activity": "2008-08-26 05:41:04",
                                "passed_sherlock_audit": true,
                                "is_expired": false,
                                "creative_upload_status": null,
                                "backup_upload_status": null,
                        "filter": null,
                        "is_suspicious": false,
                        "suspicious_activity_timestamp": null,
                        "media_subtypes": [
                                "banner"
                        ],
                        "no_adservers": false,
                        "is_blanking": false,
                        "is_rotating": false,
                        "text_title": null,
                        "text_description": null,
                        "text_display_url": null,
                        "click_action": "click-to-web",
                        "click_target": null,
                        "ssl_status": "disabled",
                        "allow_ssl_audit": false,
                        "media_url_secure": null,
                        "content_secure": null,
                        "original_content_secure": null,
                        "flash_backup_url_secure": null,
                        "is_hosted": false,
                        "content_source": "standard",
                        "thirdparty_creative_id": null,
                        "thirdparty_campaign_id": null,
                        "custom_request_template": null,
                        "brand": {
                                "id": 5,
                                "name": "Adobe",
                                "category_id": 27
                        },
                        "language": {
                                "id": 16,
                                "name": "Norwegian"
                        },
                        "template": {
                                "id": 1
                                },
                        "segments": null,
                        "pixels": null,
                        "mobile": null,
                        "brand_id": 5,
                        "sla": null,
                        "sla_eta": null
                        }
  }
}

Modificar una creatividad

Si luego decides añadir un nombre de campaña "Triple Play: octubre de 2008" a la creatividad con fines informativos:

$ cat creative_mod
{"creative" : {
        "campaign":"Triple Play - October 2008"
        }
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "id":6
}}

Y luego, para ver el cambio:

$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
    "response": {
        "creatives": [
            {
                "id": 6,
                "active": true,
                "member_id": 5,
                "description": null,
                "code": null,
                "brand_id": 43,
                "media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
                "audit_status": "pending",
                "allow_audit": true,
                "size_in_bytes": 18467,
                "last_checked": null,
                "not_found": 0,
                "added_by_bidder": 14,
                "campaign": "Triple Play - October 2008",
                "placement": null,
                "format": "url-html",
                "width": 300,
                "height": 250,
                "click_url": "",
                "flash_click_variable": null,
                "pixel_url": "",
                "no_iframes": false,
                "content": null,
                "original_content": null,
                "track_clicks": true,
                "pixel_type": "image",
                "audit_feedback": null,
                "created_on": "2008-08-26 05:41:04",
                "flash_backup_url": null,
                "last_activity": "2008-09-14 06:20:04"
            }
        ],
        "status": "OK"
    }
}

Enviar una creatividad para una auditoría

Si quiere solicitar una auditoría para un creativo, debe estar activa y tener el allow_audit campo establecido en true:

$ cat creative_mod
{"creative" : {
        "audit_status": "pending",
                "allow_audit" : true
        }
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "id":6
}}

Anular la expiración de un recurso creativo y volver a enviarlo para auditoría

Si una creatividad ha caducado, puede actualizarla con esta configuración para establecer el estado como "pendiente" y volver a enviarla para su auditoría. Tenga en cuenta que, a partir de noviembre de 2017, las creatividades que hayan expirado hace más de un año se eliminarán permanentemente. Consulte "Directiva de creatividad caducada" en la parte superior de esta página para obtener más información.

$ cat unexpire_creative
{
    "creative": {
    "audit_status": "pending",
    "allow_audit": true,
    "status": {
        "user_ready": true
        }
    }
}

Enviar un creativo móvil para su auditoría

En este ejemplo se utiliza el nuevo mobile objeto:

$ cat mobile_creative
{
    "creative" : {
        "audit_status": "pending",
        "allow_audit" : true,
        "mobile" : {
                 "alternative_landing_page_url" : "https://..."
        }
    }
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "id":6
   }
}

Enviar un recurso creativo para una auditoría prioritaria

Si desea someterse a una auditoría prioritaria. Establezca "sla" en 2 (actualmente no se usa un valor de 1). Se le cobrará una tarifa de auditoría prioritaria según su contrato.

$ cat creative_mod
{"creative" : {
        "audit_status": "pending",
        "sla": 2
        }
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
   "response":{
        "status":"OK",
        "id":6
}}

Consulte el tiempo de auditoría estimado para la creatividad ("sla_eta")

$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
    "response": {
        "creatives": [
            {
                "id": 6,
                ...
                "audit_status": "pending",
                "sla": 0,
                "sla_eta": "2011-05-21 05:33:06"
            }
        ],
        "status": "OK"
    }
}

Agregar un creativo (etiqueta HTML de terceros)

$ cat creative
{
 "creative":
  { "width" : 300,
    "height" : 250,
    "media_url" : "https://ad.doubleclick.net/adi/ABC.Advertising.com/DEF.40;sz=300x250;click0=",
    "template":{
       "id": 1
    }
  }
}                       
$ curl -b cookies -c cookies -X POST -d @creative.json 'https://api.sand-08.adnxs.net/creative?member_id=1282'   
  
{
    "response":{
        "status":"OK",
        "count":1,
        "start_element":null,
        "num_elements":null,
        "id":816447,
        "creative":{
            "id":816447,
            "active":true,
            "member_id":1282,
            "description":null,
            "code":null,
            "code2":null,
            "media_url":"https:\/\/ad.dblclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
            "audit_status":"pending",
            "allow_audit":true,
            "size_in_bytes":0,
            "last_checked":null,
            "not_found":0,
            "added_by_bidder":null,
            "campaign":null,
            "placement":null,
            "format":null,
            "width":300,
            "height":250,
            "click_url":null,
            "landing_page_url":null,
            "flash_click_variable":null,
            "no_iframes":false,
            "content":null,
            "original_content":null,
            "track_clicks":true,
            "audit_feedback":null,
            "created_on":"2014-01-24 16:02:31",
            "flash_backup_url":null,
            "is_self_audited":false,
            "file_name":null,
            "is_prohibited":false,
            "last_activity":"2014-01-24 16:02:31",
            "passed_sherlock_audit":true,
            "is_expired":false,
            "creative_upload_status":null,
            "backup_upload_status":null,
            "filter":null,
            "is_suspicious":false,
            "suspicious_activity_timestamp":null,
            "media_subtypes":[
                "banner"
            ],
            "no_adservers":false,
            "is_blanking":false,
            "is_rotating":false,
            "text_title":null,
            "text_description":null,
            "text_display_url":null,
            "click_action":"click-to-web",
            "click_target":null,
            "ssl_status":"disabled",
            "allow_ssl_audit":false,
            "media_url_secure":null,
            "content_secure":null,
            "original_content_secure":null,
            "flash_backup_url_secure":null,
            "is_hosted":false,
            "content_source":"standard",
            "thirdparty_creative_id":null,
            "thirdparty_campaign_id":null,
            "custom_request_template":null,
            "brand":{
                "id":1,
                "name":"Unknown",
                "category_id":8
            },
            "language":{
                "id":1,
                "name":"English"
            },
            "template":{
                "id":1
            },
            "segments":null,
            "pixels":null,
            "mobile":null,
            "brand_id":1,
            "sla":"0",
            "sla_eta":"2014-01-27 00:03:31"
        }

Agregar una creatividad iframe-html

El servicio de creatividad permite crear varios tipos diferentes de creatividades. Por ejemplo, para crear una creatividad con el formato "iframe-html", deberá cargar el código HTML sin procesar que se insertará en un iframe en la página donde se publique el anuncio.

$ cat iframe-html-creative
{
   "creative" : {
        "content":"<script type=\"text/javascript\" language=\"javascript\">
                   var sample_var = 350;
                   </script>
                   <script type=\"text/javascript\" language=\"javascript\" src=\"https://sample_source.com/sample_id?ord=${CACHEBUSTER}\"</script>",
        "width":"300",
        "height":"250",
        "format":"iframe-html",
        "brand_id" : 43
        }
}
$ curl -b cookies -c cookies --data-binary @iframe-html-creative 'https://api.adnxs.com/creative/5'
{
   "response":{
        "status":"OK",
        "id":7
}}

Añadir un píxel aprobado por Xandr a una creatividad

Este ejemplo le guía por el proceso de añadir el píxel Evidon AdChoices Icon aprobado por Xandr a una creatividad.

En primer lugar, hay que averiguar el pixel_template_id y el número de parámetros que se deben definir para el píxel. Utilice el servicio de plantillas de píxeles para obtener esta información.

$ 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\" : \"https://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": "https://p.brilig.com/contact/bct?pid=${P1}&_ct=pixel&adid=${CP_ID}&action=1"
            },
            ...
        ],
        "dbg_info": {
            ...
        }
    }
}

El píxel Evidon AdChoices Icon es el primero en la respuesta. Observa que id es 1. También observa que num_required_params es 2. Esto significa que, al añadir el píxel a la creatividad, debes proporcionar valores para {P1} y {P2} en el contenido de píxeles.

A continuación, cree el archivo con formato JSON para añadir el píxel a la creatividad. En el archivo, establece pixel_template_id en 2 y establece param_1 y param_2 en los valores de {P1} y {P2} en el contenido de píxeles.

$ cat creative_update
{
    "creative": {
        "pixels": [
            {
                "pixel_template_id": 1,
                "param_1":"12",
                "param_2":"34"
            }
        ]
    }
}

Finalmente, realiza una llamada PUT para actualizar la creatividad. La matriz de píxeles de la respuesta muestra que se ha agregado el píxel. Los dos parámetros están definidos y se han rellenado en el contenido del píxel. Tenga en cuenta que, dado que el píxel Evidon AdChoices Icon no hace que la creatividad requiera una nueva auditoría, audit_status no se ha revertido a "pendiente".

$ curl -b cookies -c cookies -X PUT -d @creative_update 'https://api.adnxs.com/creative/3/503577'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "503577",
        "start_element": 0,
        "num_elements": 100,
        "creative": {
            "name": null,
            "brand_id": 1,
            "media_url": "https://creative.com/300x250",
            "id": 503577,
            "code": null,
            "code2": null,
            "state": "active",
            "click_track_result": "not_tested",
            "member_id": 3,
            ...
            "audit_status": "audited",
            ...
            "pixels": [
                {
                    "id": 163,
                    "pixel_template_id": 1,
                    "param_1": "12",
                    "param_2": "34",
                    "param_3": null,
                    "param_4": null,
                    "param_5": null,
                    "format": "url-image",
                    "content": "(function() {document.write('<sc'+'ript type=\"text/javascript\"' +
                     ((\"https:\" == document.location.protocol) ? \"https://c.betrad.com\" :
                     \"https://c.betrad.com\") + '/surly.js?;ad_wxh=${CREATIVE_SIZE};coid=12;nid=34;
                     \"></scr'+'ipt>');}());"
                }
            ],
            ...
        },
        "dbg_info": {
            ...
        }
    }
}

Añadir un píxel personalizado a una creatividad

En este ejemplo, la solicitud PUT añade un píxel url-js personalizado a la 503577 creativa. En el archivo con formato JSON, el formato se establece en "url-js" y la URL se establece en la ubicación del JavaScript que desea servir con la creatividad. Tenga en cuenta en la respuesta que audit_status está "pendiente"; Esto se debe a que, al agregar un píxel personalizado a una creatividad, la creatividad se vuelve a enviar para su auditoría.

$ cat creative_update
{
    "creative": {
        "pixels": [
            {
                "format": "url-js",
                "url":"https://50.16.221.228/render_js?cb=${CACHEBUSTER}&uid=${USER_ID}&ref=${REFERER_URL}
                 &campaign_id=147"
            }
        ]
    }
}
$ curl -b cookies -c cookies -X PUT -d @creative_update 'https://api.adnxs.com/creative/3/503577'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "503577",
        "start_element": 0,
        "num_elements": 100,
        "creative": {
            "name": null,
            "brand_id": 1,
            "media_url": "https://creative.com/300x250",
            "id": 503577,
            "code": null,
            "code2": null,
            "state": "active",
            "click_track_result": "not_tested",
            "member_id": 3,
            ...
            "audit_status": "pending",
            ...
            "pixels": [
                {
                    "id": 196,
                    "pixel_template_id": null,
                    "param_1": null,
                    "param_2": null,
                    "param_3": null,
                    "param_4": null,
                    "param_5": null,
                    "format": "url-js",
                    "url": "https://50.16.221.228/render_js?cb=${CACHEBUSTER}&uid=${USER_ID}
                     &ref=${REFERER_URL}&campaign_id=147"
                }
            ],
            ...
        },
        "dbg_info": {
            ...
        }
    }
}

Añadir un creativo de vídeo con un objeto de atributo de vídeo y un envoltorio

{
    "creative": {
        "id": 145,
        ...
        "template_id": 6439,
        "video_attribute": {
            "is_skippable": true,
            "duration_ms": 21000,
                        "wrapper": {
                "url": "http://www.doubleclick.net/...",
                "secure_url": "https://www.doubleclick.net/...",
                "elements": [
                    {
                                                "vast_element_type_id": 1,
                        "name": "linear",
                        "trackers": [
                            {
                                                                "name": "startTracker",
                                "vast_event_type_id": 2,
                                "url": "http://tracker.com/...",
                                "secure_url": "https://tracker.com/...",
                                                                "event_type": "start"
                            },
                                                        {
                                                                "name": "completionTracker",
                                "vast_event_type_id": 8,
                                "url": "http://tracker.com/...",
                                "secure_url": "https://tracker.com/...",
                                                                "event_type": "completion"
                            }
                        ]
                    }
                ]
            }
        }
    }
}

Agregar una creatividad nativa

Al agregar un recurso creativo nativo, utilice el ID de plantilla 39461.

cat native
{
        "creative": {
                "description": "native_test",
                "brand_id": 1,
                "media_url": "https://mediaurl.com",
                "code": "test",
                "code2": null,
                "member_id": 4,
                "state": "active",
                "template": {
                        "id": 39461
                },
                "native_attribute": {
                        "link": {
                                "url": "https://url.com",
                                "fallback_url": "https://fallback.com",
                                "trackers": [{
                                        "url": "http://url.com",
                                        "url_secure": "https://secureurl.com"
                                }]
                        },
                        "data_assets": [{
                                "data_type": "sponsored_by",
                                "value": "a value"
                        }, {
                                "data_type": "rating",
                                "value": "8"
                        }],
                        "image_assets": [{
                                "image_type": "icon_image",
                                "creative_asset_image": {
                                        "url": "http://url.com",
                                        "url_secure": "https://secureurl.com",
                                        "height": 1,
                                        "width": 1
                                }
                        }],
                        "image_trackers": [{
                                "url": "http://url.com",
                                "url_secure": "https://secureurl.com"
                        }],
                        "javascript_trackers": [{
                                "url": "http://url.com",
                                "url_secure": "https://secureurl.com"
                        }]
                },
                "thirdparty_viewability_providers": null,
                "status": {
                        "user_ready": true
                },
                "sla_eta": null
        }
}
$ curl -b cookies -c cookies -X POST -s @native 'https://api.adnxs.com/creative/4'
{
        "response": {
                "status": "OK",
                "count": 1,
                "id": 411,
                "start_element": 0,
                "num_elements": 100,
                "dbg_info": {
                        ...
                },
                "creative": {
                        "description": "native_test",
                        "brand_id": 1,
                        "media_url": "https://mediaurl.com",
                        "id": 411,
                        "code": "test",
                        "code2": null,
                        "member_id": 4,
                        "state": "active",
                        "click_track_result": "not_tested",
                        "format": "url-file",
                        "width": null,
                        "height": null,
                        "click_url": null,
                        "flash_click_variable": null,
                        "no_iframes": false,
                        "content": null,
                        "original_content": null,
                        "file_name": null,
                        "track_clicks": true,
                        "audit_status": "pending",
                        "macros": null,
                        "profile_id": null,
                        "audit_feedback": null,
                        "is_prohibited": false,
                        "is_suspicious": false,
                        "created_on": "2017-03-09 21:54:11",
                        "flash_backup_url": null,
                        "last_modified": "2017-03-09 21:54:11",
                        "is_control": false,
                        "allow_audit": true,
                        "is_expired": false,
                        "creative_upload_status": null,
                        "backup_upload_status": null,
                        "use_dynamic_click_url": false,
                        "media_subtypes": [
                                "popunder",
                                "popup",
                                "banner"
                        ],
                        "size_in_bytes": 0,
                        "is_self_audited": false,
                        "no_adservers": false,
                        "text_title": null,
                        "text_description": null,
                        "text_display_url": null,
                        "click_action": "click-to-web",
                        "click_target": null,
                        "ssl_status": "pending",
                        "allow_ssl_audit": true,
                        "media_url_secure": "https://MEDIAURL.appnexus.com",
                        "content_secure": "document.write(\\\"\\\")",
                        "original_content_secure": null,
                        "flash_backup_url_secure": null,
                        "is_hosted": false,
                        "content_source": "standard",
                        "lifetime_budget": null,
                        "lifetime_budget_imps": null,
                        "daily_budget": null,
                        "daily_budget_imps": null,
                        "enable_pacing": null,
                        "allow_safety_pacing": null,
                        "landing_page_url": null,
                        "thirdparty_creative_id": null,
                        "thirdparty_campaign_id": null,
                        "facebook_audit_status": null,
                        "facebook_audit_feedback": null,
                        "custom_request_template": null,
                        "language": {
                                "id": 1,
                                "name": "English"
                        },
                        "brand": {
                                "id": 1,
                                "name": "Unknown",
                                "category_id": null
                        },
                        "template": {
                                "id": 329,
                                "name": "native ad",
                                "media_subtype_id": 17,
                                "format_id": 11
                        },
                        "ios_ssl_audit": null,
                        "adx_audit": null,
                        "custom_macros": null,
                        "segments": null,
                        "folder": null,
                        "campaigns": null,
                        "line_items": null,
                        "competitive_brands": null,
                        "competitive_categories": null,
                        "pixels": null,
                        "mobile": null,
                        "video_attribute": null,
                        "media_assets": null,
                        "sla": null,
                        "thirdparty_pixels": null,
                        "native": null,
                        "native_attribute": {
                                "link": {
                                        "url": "https://url.com",
                                        "fallback_url": "https://fallback.com",
                                        "trackers": [{
                                                "url": "http://url.com",
                                                "url_secure": "https://secureurl.com"
                                        }]
                                },
                                "data_assets": [{
                                        "data_type": "sponsored_by",
                                        "value": "a value"
                                }, {
                                        "data_type": "rating",
                                        "value": "8"
                                }],
                                "image_assets": [{
                                        "image_type": "icon_image",
                                        "creative_asset_image": {
                                                "url": "https://vcdn.adnxs.com/sand/creative-image/ea/f5/30/28/eaf53028-e6c6-4ac0-bcbb-ce8fe14b73ab.png",
                                                "url_secure": "https://secureurl.com",
                                                "height": 12,
                                                "width": 34
                                        }
                                }],
                                "image_trackers": [{
                                        "url": "http://url.com",
                                        "url_secure": "https://secureurl.com"
                                }],
                                "javascript_trackers": [{
                                        "url": "http://url.com",
                                        "url_secure": "https://secureurl.com"
                                }]
                        },
                        "thirdparty_viewability_providers": null,
                        "status": {
                                "user_ready": true,
                        },
                        "sla_eta": null,
                        "currency": "USD",
                        "type": "standard"
                }
        }
}

Determining the Technical Atttributes assigned to your creative

Aunque los atributos técnicos no son algo que se pueda agregar a los informes automatizados hoy en día, se pueden recuperar a través del servicio Creative en la API del ofertante. Para obtener más información, consulte el Servicio de atributos técnicos

Se puede acceder a esto agregando el parámetro de cadena de consulta "?attributes=true" como: "adnxs.com/creative/MEMBER_ID/CREATIVE_ID?attributes=true"

"technical_attributes": [
{
 "id": 2,
 "name": "Flash"
},
{
 "id": 9,
"name": "Initial Load > 40kb"
},
 {
  "id": 13,
  "name": "Banner has AdChoices Icon"
 },
 {
  "id": 15,
  "name": "Animated: 15 seconds or less"
 }
 ]

El servicio de Meta proporciona la información más actualizada sobre la interfaz con los objetos de nuestra API.

Macros creativas

El bus de impresiones admite dos tipos de macros creativas reemplazadas en tiempo real: macros de Xandrcreative predefinidas y macros personalizadas que puede definir el ofertante. La principal diferencia entre los dos es la perspectiva. Por ejemplo, el bus de impresiones no tiene conocimiento de una campaña o una orden de inserción cuando se realiza una oferta en tiempo real, por lo que cualquier objeto compatible con el modelo de objetos interno de un ofertante y requerido en una macro debe admitirse mediante macros personalizadas.

Macros creativas de Xandr

Consulte Macros de Xandr para obtener una lista completa de las macros creativas disponibles.

Ejemplo de seguimiento de clics:

"media_url": "https://ad.doubleclick.net/adi/N5364.Ivillage.com/B2965815.5;sz=728x90;click0=${CLICK_URL};ord=${CACHEBUSTER}?"

Macros personalizadas

Con custom_macro funcionalidad de la respuesta a pujas, puede pasar dinámicamente a las creatividades previamente registradas. Por ejemplo, si quisiera devolver siempre una campaña y un código de informe determinados, podría configurar el creativo de la siguiente manera:

{
   "creative":{
       "media_url":"https://adserver.com/imp?z=300x250;camp=${CAMPAIGN_ID};int=${INT_CODE}",
       "format":"url-html",
       "width":"300",
       "height":"250"
}}

A continuación, cuando el postor responda a una subasta, la respuesta de la oferta puede especificar el nombre y el valor de las macros que se reemplazarán, incluyendo, por ejemplo:

"custom_macros":[
{
   "name":"CAMPAIGN_ID",
   "value":"452346"
},
{
   "name":"INT_CODE",
   "value":"a352-45we-sdr3"
}]

<iframe src="https://adserver.com/sz=300x250;camp=452346;int=a352-45we-sdr3" width=300 height=250/>