API de plataforma digital: servicio creativo

Puedes utilizar el Servicio Creativo para añadir creatividades a nuestro sistema. Todos los recursos creativos deben estar vinculados a un anunciante o editor.

• Puede ver su identificador de anunciante llamando al Servicio de anunciantes.
• Puede ver su identificador de editor llamando al Servicio de editores.
• Puede adjuntar una creatividad a un editor para usarla como creatividad predeterminada para un emplazamiento. A continuación, adjuntaría la creatividad a un emplazamiento a través de su ID mediante el servicio de colocación.

Nota:

A partir de septiembre de 2025: declara si tu anuncio es político y está destinado a publicarse en la UE a través de los is_political_and_eu_targeted campos y is_political_and_non_eu_targeted . Para obtener más información, consulta las próximas actualizaciones de los estándares creativos de monetización con respecto a la publicidad política.

Auditoría

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, de imagen o de vídeo).
• Xandr media_urls revisa regularmente. Si un archivo desaparece, la creatividad se tratará como no auditada.
• Una vez que una creatividad ha pasado la auditoría de Xandr, ciertos cambios en la creatividad hacen que se vuelva a enviar para su auditoría. Para obtener más detalles, consulte Cambios que provocan una nueva auditoría a continuación.

API de REST

Método HTTP	Endpoint	Description
POST	https://api.appnexus.com/creative?advertiser_id=ADVERTISER_ID (JSON creativo)	Agregue un nuevo creativo a uno de sus anunciantes.
POST	https://api.appnexus.com/creative?publisher_id=PUBLISHER_ID (JSON creativo)	Agregue un nuevo creativo a uno de sus editores.
PUT	- https://api.appnexus.com/creative?id=CREATIVE_ID& advertiser_id=ADVERTISER_ID - https://api.appnexus.com/creative?id=CREATIVE_ID&p ublisher_id=PUBLISHER_ID (JSON creativo)	Modificar una creatividad existente.
GET	https://api.appnexus.com/creative	Ver todas las creatividades.
GET	- https://api.appnexus.com/creative?advertiser_id=ADVERTISER_ID - https://api.appnexus.com/creative?advertiser_code=ADVERTISER_CODE - https://api.appnexus.com/creative?publisher_id=PUBLISHER_ID - https://api.appnexus.com/creative?publisher_code=PUBLISHER_CODE	Ver todos los recursos creativos de un anunciante o editor. Nota: Puede filtrar los recursos creativos en función de cuándo se publicaron por primera vez y cuándo se publicaron por última vez. Esto es particularmente útil cuando se acerca al límite de su objeto y necesita identificar creatividades que se pueden eliminar del sistema. Para obtener más información, consulte Primera ejecución/Última ejecución a continuación.
GET	- https://api.appnexus.com/creative?id=CREATIVE_ID - https://api.appnexus.com/creative?code=CREATIVE_CODE	Ver una creatividad específica.
GET	https://api.appnexus.com/creative?id=1,2,3	Ver varias creatividades por identificador mediante una lista separada por comas.
GET	https://api.appnexus.com/creative?audit_stats=true	Ver estadísticas de auditoría creativas. Nota: La respuesta indica el número de creatividades con cada estado de auditoría de Xandr, Microsoft y Google. Para obtener el formato de respuesta, consulte los ejemplos siguientes.
DELETE	- https://api.appnexus.com/creative?id=CREATIVE_ID& advertiser_id=ADVERTISER_ID - https://api.appnexus.com/creative?id=CREATIVE_ID&p ublisher_id=PUBLISHER_ID	Eliminar un recurso creativo. Nota: No puede eliminar un recurso creativo que se utiliza como recurso creativo predeterminado para un miembro o ubicación. Las creatividades predeterminadas se pueden eliminar una vez que se desasocian de una ubicación.
GET	https://api.appnexus.com/creative/meta	Obtenga información sobre los campos por los que puede filtrar y ordenar.

Campos JSON

Campo	Tipo	Descripción
id	Entero	El identificador interno asociado a la creatividad. Valor predeterminado: Número generado automáticamente. Requerido el:PUT, en la cadena de consulta.
code	cadena (100)	El código personalizado del creativo. Nota: Es importante que este código sea único.
code2	cadena (100)	El código personalizado adicional para la creatividad. Nota: Es importante que este código sea único.
name	cadena (400)	El nombre del creativo.
type	enumeración	El tipo de creatividad. Posibles valores: - "standard" "html" - "video" Nota: Aviso de alfa-beta Este campo o característica forma parte de la funcionalidad que actualmente se encuentra en fase Alfa o Beta. Por lo tanto, está sujeto a cambios. Solo lectura.
advertiser_id	Entero	El identificador del anunciante al que está adherida la creatividad. Requerido el:POST/PUT, en la cadena de consulta, si el creativo está adjunto a un anunciante.
political	objeto	Solo lectura. Si esta creatividad es "política" y servirá en los Estados Unidos, este objeto está poblado con los elementos necesarios para las creatividades políticas de los Estados Unidos. Para obtener más información, consulte la descripción del objeto político a continuación. Valor predeterminado:null
publisher_id	Entero	El identificador del editor o la compra de medios a los que está adjuntada la creatividad. Requerido el:POST/PUT, en la cadena de consulta, si la creatividad está adjunta a un editor.
brand_id	Entero	El identificador de la marca de la empresa que anuncia el creativo. Si se incluye, será verificado por el equipo de auditoría de Xandr. Si no se incluye, será asignado por el equipo de auditoría. Para obtener una lista completa de marcas, consulte el Servicio de marca.
state	enumeración	El estado de la creatividad. Valores posibles: "active" o "inactive". Solo lectura.
status	objeto	El estado del creativo que describe si está listo para publicarse. Para obtener más información, consulte Estado a continuación.
click_track_result	enumeración	El resultado de la prueba de seguimiento de clics, una función solo disponible en la interfaz de usuario. Valores posibles: "not_tested", "passed"o "failed". Valor predeterminado:"not_tested"
campaigns	matriz de objetos	La lista de campañas a las que está asociada la creatividad. Para obtener más información, consulta Campañas a continuación. Nota: Este campo solo se devolverá si se especifica un advertiser_id en la cadena de consulta.
format	enumeración	En desuso.
template	objeto	La plantilla creativa (p. ej.: template_id6) para el formato y el tipo de medio de la creatividad (es decir, flash y expandible). La plantilla incluye código para controlar cómo se renderiza la creatividad en las páginas web. Para obtener más información, consulte Plantilla creativa a continuación. Nota: Cuando se usa una plantilla para el "raw-html" formato (HTML que no se servirá en un iFrame), todo en el content campo debe estar escaped (comillas, barras, etc.) y envuelto en una document.write(); declaración. Esto es necesario para entregar el contenido a la página. Requerido en:POST
thirdparty_page	objeto	Nota: Este campo ya no está en uso.
custom_macros	matriz de objetos	Los valores de las macros personalizadas usadas en la plantilla creativa. Para obtener más información, consulte Macros personalizadas a continuación. Requerido el:POST, si la plantilla incluye macros personalizadas necesarias.
width	Int	La amplitud de la creatividad; La cadena debe contener un int. Requerido en:POST, si la plantilla es para el "Banner" tipo de medio o "Expandable"
height	Int	Requerido en:POST, si la plantilla es para el "Banner" tipo de medio o "Expandable" El colmo de lo creativo; La cadena debe contener un int. Si la plantilla de la creatividad tiene un tipo de medio Pop, la creatividad height debe establecerse O pop_window_maximize (en el pop_values campo) ( true pero no ambas). Nota: Solo puedes enviar creatividades pop de tamaños aceptados para la auditoría Xandr. Si media_subtype_id está dentro de la template matriz hay 4 (popunder) y audit_status es "pending", height debe establecerse en 300 y width en 720. Si media_subtype_id está dentro de la template matriz hay 2 (elemento emergente) y audit_status es "pending", width y height debe ser uno de los siguientes: 250x250, 300x250, 550x480. Requerido en:POST, si la plantilla es para el "Banner" tipo de medio o "Expandable"
media_url	string (1000)	La URL de la creatividad: puede ser imagen, flash, HTML, javascript (ver formato). La dirección URL debe existir y debe estar en una red CDN o equivalente. Requerido en:POST, si no usa contenido.
media_url_secure	string (1000)	La URL de la creatividad segura (HTTPS): puede ser imagen, flash, HTML, javascript (ver formato) para ser servida en una llamada publicitaria segura. La dirección URL debe existir y debe estar en una red CDN o equivalente.
click_url	string (2000)	click_url está en desuso a favor de click_target. Nota: Este valor debe comenzar por "http://" o "https://" Requerido en:POST, si la plantilla es para el formato "imagen".
file_name	string (1000)	El nombre y la extensión de archivo de una creatividad alojada. Tipos de archivo permitidos: jpg, gif, png, swf, flv, mp4, wmv, f4v, avi, m4v, mov y mpg. Requerido en:POST, si se agrega una creatividad hospedada.
flash_click_variable	cadena (255)	La variable ClickTag en una creatividad Flash. Xandr puede ejecutar y rastrear los clics del usuario en una creatividad Flash solo si proporciona la variable exacta en el archivo (clickTAG, ClickTag, Clicktag, etc.). Puede utilizar el servicio ClickTags para identificar esta variable. Si necesita especificar más de una variable de ClickTag para una única creatividad, póngase en contacto con el soporte técnico. Nota: Este campo solo se puede actualizar (a través de POST o PUT) para creatividades Flash.
content	string	Contenido de Javascript o HTML cuando "format" es "raw-js" o "iframe-html". En el caso de una creatividad alojada, el contenido del archivo debe codificarse en base64 y enviarse como una cadena dentro del campo de contenido. Propina: Cuando se usa una plantilla (ejemplo: template_id6) para el "raw-html" formato (HTML que no se servirá en un iFrame), todo en el content campo debe estar escaped (comillas, barras, etc.) y envuelto en una document.write(); declaración. Esto es necesario para entregar el contenido a la página. Propina: Hay una longitud máxima en el campo de contenido de 65535 caracteres. Requerido en:POST, si no se usa media_url. Valor predeterminado: contenedor de etiquetas de terceros.
content_secure	string	Contenido de JavaScript o HTML cuando "format" es "raw-js" o "iframe-html" se sirve en una llamada publicitaria segura.
original_content	string	El valor que pase al campo a través de "content" la interfaz de usuario se devolverá en este campo sin cambios. El "content" campo contendrá el contenido modificado por Xandr para servir correctamente. Este campo también se puede cargar directamente a través de la API. En este caso, se hará referencia al valor cargado en este campo en la sección de contenido de la interfaz de usuario (campo Etiqueta de contenido > creativo). Requerido en:POST Cuando se envía como tipo raw-html.
original_content_secure	string	Consulte original_content. Esta es la versión segura de este contenido.
macros	string	La API extrae macros y las coloca en este campo para que el licitador sepa qué macros esperar. Solo lectura.
audit_status	enumeración	El estado de auditoría de la creatividad. Valores posibles: "no_audit", "pending", "rejected"o "audited". Nota: - Si allow_audit es false, este campo debe ser "no_audit". - Si una creatividad ha caducado, puedes reanimarla cambiando este campo. Al establecerla, se volverá a "pending" enviar para su auditoría. El campo user_ready también debe establecerse en true para reactivar una creatividad expirada. En el caso de los cambios que vuelven a enviar automáticamente la creatividad para su auditoría, consulte Cambios que provocan una nueva auditoría a continuación. - Solo puede enviar creatividades pop de tamaños aceptados para la auditoría Xandr. Si media_subtype_id está dentro de la template matriz es 4 (popunder), audit_status no se puede establecer a "pending" menos que width sea 720 y height 300. Si media_subtype_id está dentro de la template matriz hay 2 (ventana emergente), audit_status no se puede establecer en pendiente a menos que width y height sean uno de los siguientes: 250x250, 300x250, 550x480. Valor predeterminado:"pending"
audit_feedback	string	El equipo de auditoría creativa puede pasar mensajes sobre una creatividad en este campo. Solo lectura.
allow_audit	Booleano	Si true, la creatividad se enviará para auditoría. Si false, la creatividad no se enviará. Las creatividades no auditadas solo pueden ejecutarse en el inventario administrado de una red. Nota: - Si audit_status es "no_audit", este campo debe ser "false". - Si su miembro aún no está activo, puede agregar creatividades, pero no se enviarán para auditoría (allow_audit lo será false). Una vez activado el miembro, si quieres que estos creativos sean auditados, debes actualizarlos y establecerlos allow_audit en true. - Solo puede enviar creatividades pop de tamaños aceptados para la auditoría Xandr. Si media_subtype_id está dentro de la template matriz es 4 (popunder), allow_audit no se puede establecer en 1 a menos que width sea 720 y height 300. Si media_subtype_id está dentro de la template matriz hay 2 (ventana emergente), allow_audit no se puede establecer en 1 a menos que width y height sean uno de los siguientes: 250x250, 300x250, 550x480. Valor predeterminado:true
ssl_status	enumeración	El estado SSL (HTTPS) de la creatividad. Solo los creativos con ssl_status = aprobado podrán servir en el inventario seguro. Nota: Si una creatividad no supera la auditoría SSL de Sherlock, puede enviarla para una nueva prueba (una vez que haya corregido el contenido no seguro descendente) cambiando este campo a "pending". Valores permitidos: - "disabled" - "pending" - "approved" - "failed" Valor predeterminado:"disabled"
allow_ssl_audit	Booleano	Si true, la creatividad se enviará para una auditoría segura (HTTPS). Si false, la creatividad no se enviará. Si true, o media_url_securecontent_secure también es necesario. Predeterminado:true, si media_url_secure se proporciona o content_secure De lo contrario, false será el predeterminado.
msft_audit_status	enumeración	En desuso.
msft_audit_feedback	string	En desuso.
facebook_audit_status	enumeración	Nota: Este campo ya no está en uso.
facebook_audit_feedback	string	Nota: Este campo ya no está en uso.
is_self_audited	Booleano	Si true, la creatividad se audita automáticamente y, por lo tanto, no pasará por la auditoría de la plataforma Xandr. El creativo solo puede servir en el inventario que acepta tu creativo autoclasificado o en el inventario que acepta creativos no auditados. Valor predeterminado:false
is_expired	Booleano	Si el creativo (1) no se ha ejecutado y (2) no se ha modificado en 45 días, se marcará automáticamente como expirado y no aparecerá en ningún inventario. - Las creatividades expiradas deben volver a auditarse para ejecutarse en el inventario de terceros. Para anular la expiración de una creatividad para el inventario de terceros, establezca audit_status en "pending". - No es necesario volver a auditar las creatividades caducadas para ejecutarse en inventario directo. Para anular la expiración de un recurso creativo para inventario directo, establezca audit_status en "no_audit". Valor predeterminado:false Solo lectura.
is_prohibited	Booleano	Si Sherlock marca el creativo por tener malware o cargar dominios bloqueados, se establece en verdadero para evitar que se publique. Valor predeterminado:false Solo lectura.
is_hosted	Booleano	Si true, la creatividad está hospedada por Xandr. Solo lectura.
lifetime_budget	double	El presupuesto de por vida en dólares. Nota: Para incluir este campo en una GET respuesta, pase attributes=1 la cadena de consulta. Valor predeterminado:unlimited
lifetime_budget_imps	Entero	El límite de por vida del número de impresiones. Nota: Para incluir este campo en una GET respuesta, pase attributes=1 la cadena de consulta. Valor predeterminado:unlimited
daily_budget	double	El presupuesto diario en dólares. Nota: Para incluir este campo en una GET respuesta, pase attributes=1 la cadena de consulta. Valor predeterminado:unlimited
daily_budget_imps	Entero	El límite diario para el número de impresiones. Nota: Para incluir este campo en una GET respuesta, pase attributes=1 la cadena de consulta. Valor predeterminado:unlimited
enable_pacing	Booleano	Si true, el gasto diario presupuestado se distribuye uniformemente a lo largo de un día. Nota: Para incluir este campo en una GET respuesta, pase attributes=1 la cadena de consulta. Valor predeterminado:true
allow_safety_pacing	Booleano	Solo para Administración. Si true, el gasto por minuto se limita a un máximo del 1 % del presupuesto de duración y el 5 % del presupuesto diario.
profile_id	Entero	Puede adjuntar segmentaciones como el género y la geografía a una creatividad creando un perfil y asociándolo aquí.
folder	objeto	Para organizar tus creatividades en carpetas para mayor comodidad (normalmente en la interfaz de usuario), deberás crear una carpeta utilizando el servicio de carpetas creativas y asociarla aquí mediante el ID de la carpeta o en el servicio de carpetas creativas mediante el ID de la creatividad. El resultado es: {"id": "41", "name": "MyFolder"}
line_items	matriz de objetos	Las líneas de pedido asociadas a la creatividad. Para obtener más información, consulte las líneas de pedido a continuación.
pixels	matriz de objetos	Los píxeles para servir con la creatividad. Pueden ser para el seguimiento de impresiones externas, el seguimiento de clics externos u otros fines, como añadir el icono de AdChoices a una creatividad. Para obtener más información, consulte Píxeles a continuación.
pixel_url	cadena (100)	Obsoleto. En su lugar, use la matriz de píxeles. La dirección URL de un píxel de impresión que se usará con la dirección URL del contenido o la dirección URL del elemento multimedia.
pixel_url_secure	cadena (100)	Obsoleto. En su lugar, use la matriz de píxeles. La dirección URL de un píxel de impresión seguro (HTTPS) que se va a publicar con el contenido de la dirección URL multimedia en una llamada publicitaria segura.
pixel_type	enumeración	Obsoleto. En su lugar, use la matriz de píxeles. El tipo de píxel de impresión. Este campo debe establecerse si se usa pixel_url. Valores posibles: "javascript" o "image".
no_iframes	Booleano	Obsoleto. Si true, el ofertante no servirá este creativo cuando se detecte un iframe en la llamada del anuncio. Valor predeterminado:false
track_clicks	Booleano	En desuso. Valor predeterminado:true
flash_backup_content	string	En el caso de una creatividad flash, este es el contenido de la creatividad de copia de seguridad que se servirá si el navegador de un usuario no admite flash. Para un creativo de vídeo en banner, este es el contenido de la imagen del póster que se mostrará antes de que los usuarios hagan clic en reproducir y después de que el vídeo haya terminado de reproducirse. Este campo debe usarse en combinación con flash_backup_file_name. Una vez que se haya cargado la creatividad de copia de seguridad, el contenido se almacenará en la CDN y la ubicación se establecerá en el campo flash_backup_url. Ni flash_backup_content ni flash_backup_file_name se puede recuperar en GET. Requerido en:POST/PUT, si se usa flash_backup_file_name. Solo escritura.
flash_backup_file_name	string	Este campo debe usarse en combinación con flash_backup_content. Este es el nombre de archivo y la extensión del creativo de copia de seguridad. Requerido en:POST/PUT, si se usa flash_backup_content. Solo escritura.
flash_backup_url	cadena (100)	Para una creatividad flash, es la URL de una creatividad de terceros que se servirá si el navegador del usuario no admite flash. Para un creativo de vídeo en banner, se trata de la URL de la imagen del póster que se mostrará antes de que los usuarios hagan clic en reproducir y después de que el vídeo haya terminado de reproducirse.
is_control	Booleano	Esta es una marca que se utiliza para marcar esta creatividad como parte de un grupo de control/prueba en las pruebas A/B. Valor predeterminado:false
segments	matriz	Una lista de segmentos a los que se agregará un usuario al ver o hacer clic en esta creatividad. Para obtener más información, consulte Segmentos a continuación.
created_on	marca de tiempo	La fecha y hora en que se creó esta creatividad. Si se creó antes de enero de 2010, será cero. Solo lectura.
last_activity	marca de tiempo	La fecha y hora en que se modificó por última vez la creatividad. La zona horaria es UTC. Solo lectura.
media_subtypes	matriz de cadenas	En desuso.
creative_upload_status	enumeración	En desuso.
backup_upload_status	enumeración	En desuso.
use_dynamic_click_url	Booleano	Si true, la URL de la página de destino (opcional) para las creatividades flash e imágenes que no son de terceros se establece a nivel de campaña o de línea de pedido. Valor predeterminado:false
size_in_bytes	Entero	El tamaño de un recurso creativo cargado (en bytes). Solo lectura.
text_title	cadena (25)	La línea superior de texto que se muestra en una creatividad de texto. Requerido en:POST, si la plantilla es para el "text" formato.
text_description	cadena (70)	La línea inferior de texto que se muestra en una creatividad de texto. Requerido en:POST, si la plantilla es para el "text" formato.
text_display_url	cadena (35)	La URL legible que se muestra en una creatividad de texto. Requerido en:POST, si la plantilla es para el "text" formato.
click_action	enumeración	La acción que debe realizar el dispositivo cuando se hace clic en la creatividad. Actualmente, este campo se establecerá en la única acción de clic admitida, "click-to-web". Valor predeterminado:"click-to-web"
click_target	string (2000)	El destino del click_actionarchivo . Para hacer clic a la web, esto es lo de click_url la creatividad. click_url eventualmente quedará en desuso a favor de este campo. Mientras tanto, establecer click_url o click_target tendrá el mismo efecto.
categories	matriz de objetos	Las categorías que describen el tipo de creatividad y oferta. Nota: Para incluir categorías en una GET respuesta, pase attributes=1 la cadena de consulta. Para obtener una lista completa de categorías, consulte la categoría Servicio.
adservers	matriz de objetos	Los servidores de anuncios que entregan la creatividad o a los que se llama con fines de recopilación de datos durante la entrega de la creatividad. Nota: Para incluir servidores de anuncios en una GET respuesta, pase attributes=1 la cadena de consulta. Para obtener una lista completa de servidores de anuncios, consulta el servicio de servidor de anuncios. Solo lectura.
technical_attributes	matriz de objetos	Los atributos que describen las características técnicas de la creatividad, como "Expandable" o "Video". Nota: Para incluir atributos técnicos en una GET respuesta, pase attributes=1 la cadena de consulta. Para obtener una lista completa de atributos técnicos, consulte el Servicio de atributos técnicos.
language	objeto	El lenguaje de lo creativo. Para obtener una lista completa de idiomas, consulte el Servicio de idiomas.
brand	objeto	La marca de la empresa que anuncia el creativo y la categoría asociada a la marca. Para obtener más detalles, consulte la marca a continuación. Solo lectura.
pop_values	matriz	En desuso.
sla	Entero	Las creatividades que se establezcan 0 se enviarán para auditoría con un SLA estándar. Precaución: Las creatividades enviadas con cualquier número que no 0 sea darán como resultado una auditoría prioritaria (cuando esté habilitada) y las tarifas resultantes. Si tiene un contrato de servicios complementarios con Xandr para auditorías prioritarias, puede enviar una creatividad para auditoría prioritaria (auditoría dentro de las 2 horas durante el horario comercial) estableciendo este campo en 2.
sla_eta	marca de tiempo	El tiempo estimado de finalización de una auditoría prioritaria. Solo lectura.
currency	string	Solo lectura. El código que define la moneda principal del anunciante (por ejemplo, USD). Para obtener más información sobre los tipos de moneda disponibles, consulte Servicio de divisas. Valor predeterminado: Moneda predeterminada del miembro.
first_run	marca de tiempo	La fecha y hora en que se publicó por primera vez la creatividad, se actualizan cada hora. Este valor refleja la zona horaria UTC. Para incluir esta información en una GET respuesta, pase flight_info=true la cadena de consulta. Para obtener más información sobre cómo filtrar las creatividades en función de cuándo se publicaron por primera vez, consulta Primera ejecución/Última ejecución a continuación. Solo lectura.
last_run	marca de tiempo	La fecha y la hora en que se publicó por última vez la creatividad, que se actualizan cada hora. Este valor refleja la zona horaria UTC. Para incluir esta información en una GET respuesta, pase flight_info=true la cadena de consulta. Para obtener más información sobre cómo crear creatividades en función de cuándo se publicaron por última vez, consulta Primera ejecución/Última ejecución a continuación. Solo lectura.
mobile	objeto	Información necesaria para que los creativos móviles pasen la auditoría creativa. Consulta Móvil a continuación.
video_attribute	objeto	Atributos para creativos de vídeo in-stream (VAST) y de terceros alojados. Nota: Para agregar & actualizar vastos recursos creativos, utilice el /creative-vast servicio. Para obtener más detalles, consulte Creative Vast Service. Valor predeterminado:null
stats	objeto	El stats objeto ha quedado en desuso (a partir del 17 de octubre de 2016). En su lugar, utilice el servicio de informes para obtener información estadística.
content_source	string	El origen del contenido de esta creatividad. Valor predeterminado:"standard" Valores permitidos: - "standard": Esta creatividad consiste en contenido alojado en un servidor de anuncios, que generalmente se recuperará con una sola solicitud HTTP. - "mediation": este creativo es un contenedor que se usa para capturar contenido de otro servidor de anuncios con fines de mediación. Debido a la forma en que se realiza la mediación, esto puede implicar realizar múltiples solicitudes HTTP en secuencia. Para obtener más información, consulte el servicio de plantillas de solicitud personalizadas creativas. Nota: Si este campo se establece en "mediation", se producirán las siguientes acciones: - Se agregará un "mediation" atributo técnico a la matriz de la technical_attributes creatividad. Además, se realizarán las siguientes validaciones: - "audit_status" no se puede establecer en "pending"; en su lugar, siempre se establecerá en "no_audit". - allow_audit no se puede establecer en true; en su lugar, siempre se establecerá en false. - El custom_request_template multiobjeto debe definirse para la creatividad. - La custom_macros matriz debe completarse con macros definidas por los parámetros de plantilla asociados con la plantilla de solicitud personalizada. Los siguientes campos ya no serán obligatorios: - content - media_url - template
custom_request_template	Varios objetos	Si el valor del content_source campo de esta creatividad se establece en "mediation", este objeto describe la asociación entre esta creatividad y una plantilla de solicitud personalizada que se utiliza para rellenar la creatividad con contenido. Para obtener más información, consulte Plantilla de solicitud personalizada. Valor predeterminado:null Requerido en:PUT, si content_source se establece en "mediation".
competitive_brands	matriz de objetos	Los creativos asociados con las marcas de esta matriz no servirán juntos en /mtj las subastas. El ejemplo clásico de marcas competidoras es Coca-Cola vs. Pepsi. Consulte Marcas competitivas a continuación. Para obtener más información sobre las marcas de nuestro sistema, consulte el Servicio de marca.
competitive_categories	matriz de objetos	Las creatividades asociadas a las categorías de esta matriz no se publicarán juntas en /mtj las subastas, por ejemplo, "Citas" y "Educación". Consulte las categorías competitivas a continuación. Para obtener más información sobre las categorías que aplicamos a los creativos (y marcas), consulte la categoría Servicio.
thirdparty_pixels	matriz de objetos	Una matriz de píxeles de terceros asociados a la creatividad. Puede adjuntar automáticamente estos píxeles a todas las creatividades propiedad de un anunciante o miembro mediante el servicio de píxeles de terceros o adjuntarlos individualmente a nivel creativo mediante el servicio de creatividades. Valor predeterminado:null Requerido en:PUT
native	objeto	Obsoleto. Si este creativo es un anuncio nativo, este objeto se rellena con los elementos necesarios para los anuncios nativos. Para obtener más información, consulte la descripción del objeto nativo a continuación. Valor predeterminado:null Requerido en:POST y PUT para anuncios nativos. Técnicamente, nuestro sistema identifica los anuncios nativos como aquellos creativos que tienen un template con un creative_format_id de 12 que los identifica como native.
native_attribute	objeto	Este es el nuevo objeto nativo que contiene los elementos necesarios para los anuncios nativos. Para obtener más información, consulte la descripción del objeto Atributo nativo a continuación. Valor predeterminado:null Requerido en: Necesario para el anuncio nativo con la plantilla 39461.
click_trackers	matriz de objetos	Una lista de URL de seguimiento de clics de terceros destinada a utilizarse con creatividades nativas. Para obtener más información, consulta Rastreadores de clics a continuación.
impression_trackers	matriz de objetos	Una lista de URL de seguimiento de impresiones de terceros destinada a utilizarse con creatividades nativas. Para obtener más información, consulta Seguimientos de impresiones a continuación.
adx_audit	objeto	Este objeto contiene información sobre el estado y los comentarios relacionados con la auditoría de Google AdExchange de la creatividad. La información sobre si una creatividad ha sido aprobada o no se devuelve en el audit_status campo. Solo lectura.
flash_backup_url_secure	string	Esta es la versión segura de flash_backup_url, que se sirve en una llamada publicitaria segura.
msft_external_audit_feedback	string	En desuso.
msft_external_audit_status	enumeración	En desuso.
member_id	Entero	El identificador del miembro propietario de la creatividad.
media_assets	matriz de objetos	El id. de recurso del archivo original y un campo que describe para qué se debe utilizar el recurso. Se utiliza para asociar archivos alojados de Xandr a tu creatividad. Esta matriz se rellenará automáticamente al cargar archivos a través de la API. Para obtener más información, consulte Activos multimedia más abajo.
ad_type	string	Propina: Este campo solo se aplica cuando asocia creatividades a líneas de pedido aumentadas. El tipo de creatividad utilizada. Posibles valores: - banner - video (incluye tipos de audio) - native Este valor determina cómo se realiza el seguimiento de los artículos de subasta para la estrategia de compra de la línea de pedido, la estrategia de pago, las opciones de optimización, la asociación creativa y las opciones de segmentación. Nota: Todas las creatividades asociadas a una línea de pedido deben tener el mismo tipo de anuncio, que debe coincidir con el ad_type seleccionado en el servicio de línea de pedido: ALI.
is_political_and_eu_targeted	Booleano	Establézcalo en true si el creativo contiene contenido político y tiene previsto ejecutarlo en la UE. El valor predeterminado asumido es false si no se envía el campo. NOTA: La publicidad política no es compatible en la UE.
is_political_and_non_eu_targeted	Booleano	Establézcalo en true si el creativo contiene contenido político y no tiene intención de ejecutarlo en la UE. El valor predeterminado asumido es false si no se envía el campo. NOTA: La publicidad política se admite en países que no pertenecen a la UE, solo para los clientes de Microsoft Monetize Adserver.

Marca

El brand objeto contiene los siguientes campos.

Nota:

Este objeto es de solo lectura. Para establecer la marca de una creatividad, use el brand_id campo fuera de este objeto.

Campo	Tipo	Descripción
id	Entero	El identificador de la marca de la empresa que anuncia el creativo. Solo lectura.
name	string	El nombre de la marca de la empresa que anuncia la creatividad. Solo lectura.
category_id	Entero	El identificador de la categoría asociada a la marca. Solo lectura.
category_name	string	Nombre de la categoría asociada a la marca. Nota: El campo category_name solo se devuelve cuando se pasa show_category_name=true la cadena de consulta de la llamada. Solo lectura.

Campañas

Cada objeto de la campaigns matriz incluye los siguientes campos. Para obtener información para "id" nuestros "code" campos, puede utilizar el Servicio de Campaña.

Campo	Tipo (longitud)	Descripción
id	Entero	El identificador de la campaña. O "id""code" bien es necesario al actualizar la asociación de campaña. Requerido en:PUT
campaign_id	Entero	El identificador de la campaña.
creative_id	Entero	El Id. del creativo.
name	string	El nombre de la campaña. Solo lectura.
state	enumeración	El estado de la campaña. Valores posibles: "active", "inactive"o "parent_inactive". Solo lectura.
code	string	El código personalizado de la campaña. O "id""code" bien es obligatorio al actualizar la asociación de líneas de pedido. Requerido en:PUT

Marcas competitivas

Nota:

Para obtener más información sobre las marcas, consulte el Servicio de marca.

Nombre	Tipo	Descripción
id	Entero	El Id. de la marca.
name	string	El nombre de la marca.

Categorías competitivas

Nota:

Para obtener más información sobre las categorías, consulte la categoría Servicio.

Nombre	Tipo	Descripción
id	Entero	El identificador de la categoría.
name	string	Nombre de la categoría.

Plantilla creativa

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

Campo	Tipo	Descripción
id	Entero	Id. de la plantilla creativa.
name	string	El nombre de la plantilla creativa. Solo lectura.
media_subtype_id	Entero	El identificador del subtipo de medio asignado a la plantilla. Puede utilizar el servicio de subtipos de medios para ver todos los subtipos de medios admitidos. Solo lectura.
format_id	string	Nombre del formato asignado a la plantilla. Puede utilizar el servicio de formatos creativos para ver todos los formatos compatibles. Solo lectura.

Plantillas creativas más usadas

Para obtener más información, consulte Selección de la plantilla correcta para su recurso creativo.

Id. de plantilla	Tipo creativo	Requisitos
1	URL única que apunta a un fragmento de código html.	Deberá pasar la dirección URL en el media_url campo y establecer un identificador de 1 en el objeto de plantilla.
2	URL única que apunta a un fragmento de código JavaScript.	Deberá pasar la dirección URL en el media_url campo y establecer un identificador de 2 en el objeto de plantilla.
5	Recurso creativo que empieza y termina con componentes de JavaScript, incluso si el código de Javascript escribe HTML.	Deberá pasar el código Javascript en el content campo y establecer una identificación de 5 en el objeto de la plantilla.
6	Recurso creativo que empieza y termina con componentes HTML, aunque estos componentes HTML sean <script> etiquetas.	Deberá pasar el código html en el content campo y establecer una identificación de 6 en el objeto de la plantilla.

Macros personalizadas

Si la plantilla de creatividad proporciona valores predeterminados para una macro, pasar los códigos y valores aquí es opcional. Sin embargo, si la plantilla define una macro personalizada según sea necesario, debe pasar el código y el valor de la macro.

Campo	Tipo	Descripción
code	string	El nombre exacto de la macro, tal como se utiliza en el código de la plantilla creativa, por ejemplo, "BORDER_COLOR".
value	string	El valor de la macro. Nota: Este valor debe coincidir con el tipo de macro, tal como se define en la plantilla. Por ejemplo, si una macro es del tipo "entero", el valor debe ser un entero. Los tipos de macro posibles son "true/false", "string", "url", "integer""decimal", y "select_from_list".

Para obtener más información, consulte el ejemplo de Agregar un recurso creativo que utiliza una plantilla de representación personalizada en los ejemplos siguientes.

Plantilla de solicitud personalizada

Campo	Tipo	Descripción
id	Entero	La plantilla de solicitud personalizada de creatividad asociada a esta creatividad, si content_source está establecida en "mediation". Para obtener más información, consulte el servicio de plantillas de solicitud personalizadas creativas.
timeout_ms	Entero	Si se trata de una creatividad de "mediación", realizará al menos una solicitud HTTP a un servidor de anuncios externo, que a su vez puede realizar una o más solicitudes adicionales. Este es el tiempo más allá del cual no esperaremos más a que esta creatividad se llene de contenido. Para obtener más información, consulte el servicio de plantillas de solicitud personalizadas creativas.
last_activity	marca de tiempo	La fecha y hora en que se modificó por última vez la creatividad. La zona horaria es UTC. Solo lectura.

Líneas de pedido

Cada objeto de la line_items matriz incluye los siguientes campos. Para obtener información sobre "id" campos o "code" campos, puede utilizar el servicio de línea de pedido.

Campo	Tipo (longitud)	Descripción
name	string	El nombre de la línea de pedido. Solo lectura.
state	enumeración	El estado de la creatividad. Valores posibles: "active" o "inactive". Solo lectura.
id	Entero	El identificador del elemento de línea. O "id""code" bien es obligatorio al actualizar la asociación de líneas de pedido. Requerido en:PUT
code	string	El código personalizado de la línea de pedido. O "id""code" bien es obligatorio al actualizar la asociación de líneas de pedido. Requerido en:PUT

Recursos multimedia

La media_assets matriz de objetos contiene los siguientes campos:

Campo	Tipo	Descripción
media_asset_id	Entero	El identificador único del recurso creativo.
creative_field	string	Este campo indica para qué se debe utilizar ese recurso creativo concreto. Los posibles valores válidos son: - null (si el activo es VAST o HTML5) - media_url - flash_backup_url - native_icon_img_url - native_main_media - macro_CODE_FOR_MACRO: se genera dinámicamente en función de las macros de la plantilla seleccionada.

Para cada media_assets matriz, se aplican las siguientes reglas:

• Cada valor de campo solo puede utilizarse una vez por creatividad. Por ejemplo, no puede tener dos recursos "flash_backup_url".
• El valor debe ser uno de los valores válidos.
• Las creatividades VAST/HTML5 deben tener un solo activo.
• Todas las demás creatividades pueden tener 0 o más activos multimedia.

Recursos multimedia: ejemplo

"media_assets": [
    {
        "media_asset_id": 22,
        "creative_field": "media_url"
    }, 
    {
        "media_asset_id": 23,
        "creative_field": "flash_backup_url"
    }
]

Móvil

Campo	Tipo	Descripción
alternative_landing_page_url	string	Una URL de página de destino alternativa que se puede ver en un explorador de escritorio para creativos que tienen una página de destino dirigida a un dispositivo, sistema operativo o operador específico. Debe proporcionar una dirección URL auditable para que la creatividad pase la auditoría.

Atributo nativo

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

Campo	Tipo	Descripción
link	objeto	Direcciones URL asociadas a la creatividad nativa. Para obtener más información, consulte el vínculo siguiente.
image_trackers	matriz de objetos	Una lista de URL de seguimiento de impresiones de terceros destinada a utilizarse con creatividades nativas.
javascript_trackers	matriz de objetos	Una lista de URL de seguimiento de impresiones de terceros.
data_assets	matriz de objetos	Atributos del creativo nativo. Para obtener más información, consulte Activo de datos a continuación.
image_assets	matriz de objetos	Atributos de cada imagen individual. Para obtener más detalles, consulte Recurso de imagen a continuación.
privacy_url	string	Si se indicó soporte técnico en la solicitud, dirección URL de una página que informa al usuario sobre la actividad de segmentación del comprador. Xandr no proporciona un vínculo de privacidad predeterminado.
video_assets	matriz de objetos	Una lista de video_asset objetos. Para obtener más detalles, consulte Activos de vídeo a continuación.

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:

Campo	Tipo	Descripción
url	string	La página de destino del creativo nativo. Requerido en:PUT, POST
fallback_url	string	Una dirección URL de copia de seguridad si la dirección URL principal del vínculo profundo no es compatible.
trackers	matriz de objetos	Una lista de URL de seguimiento de terceros destinada a utilizarse con creatividades nativas.

Todas las creatividades nativas se envían para una auditoría de seguridad de forma predeterminada.

• Si no se ha especificado la URL segura para ningún rastreador (rastreadores de imágenes, rastreadores de javascript y rastreadores de activos de imágenes creativas), la auditoría segura está deshabilitada para esa creatividad.
• Si no se ha especificado la dirección URL segura, pero la URL tiene el prefijo https, la creatividad se enviará para una auditoría segura.

Seguimiento de vínculos

El link_tracker objeto incluye los siguientes campos:

Campo	Tipo	Descripción
url	string	Una dirección URL de seguimiento de terceros.
url_secure	string	(opcional) Una dirección URL segura de seguimiento de terceros.

Seguimiento de imágenes

El image_tracker objeto incluye los siguientes campos:

Nombre	Tipo	Descripción
url	string	Una URL de seguimiento de impresiones de terceros.
url_secure	string	Una URL de seguimiento de impresiones de terceros (que usa SSL).

Rastreador de JavaScript

El javascript_tracker objeto incluye los siguientes campos:

Nombre	Tipo	Descripción
url	string	Una URL de seguimiento de JavaScript de terceros.
url_secure	string	Una dirección URL de seguimiento de JavaScript de terceros (que usa SSL).

Activo de datos

Cada uno data_asset representa un componente de texto de la creatividad nativa. El data_assets objeto incluye los siguientes campos:

Campo	Tipo	Descripción
data_type	string	El tipo de activo para la creatividad nativa. Posibles valores: - title - description - sponsored_by - call_to_action - display_url - price - sale_price - rating - likes - downloads - phone - address - additional_description - custom_title_1 - custom_title_5 - custom_body_1 - custom_body_5 - custom_call_to_action_1 - custom_call_to_action_5 - custom_social_url_1 - custom_social_url_5 - custom_display_url_1 - custom_display_url_5 La data_type cadena debe tener comillas dobles alrededor de ella.
value	string	El contenido del data_type recurso especificado. Los valores posibles son: - title: Título del creativo. - description: descripción del producto o servicio que se anuncia. - sponsored_by: Marca del patrocinador. - call_to_action: Acción sugerida para el siguiente paso. - display_url: la dirección URL que quiere que se muestre. - price: precio de la compra en el producto, aplicación o aplicación. - sale_price: precio de venta que se puede usar junto con el precio para indicar un precio con descuento. - rating: clasificación del producto que se ofrece. - likes: Me gusta en redes sociales. - downloads: Número de descargas/instalaciones de este producto. - phone: Número de teléfono. - address: Dirección. - additional_description: La versión más larga de la descripción del anuncio. - custom_title_1 - custom_title_5: títulos adicionales que aparecerán en la creatividad nativa. - custom_body_1 - custom_body_5: texto de cuerpo adicional que aparecerá en la creatividad nativa. - custom_call_to_action_1 - custom_call_to_action_5: Llamadas a la acción adicionales que animarán al usuario a realizar las acciones necesarias después de ver la creatividad nativa (por ejemplo, inscribirse en la lista de correo). - custom_social_url_1 - custom_social_url_5: URL sociales que llevarán al usuario a las plataformas de redes sociales correspondientes. - custom_display_url_1 - custom_display_url_5: Direcciones URL públicas adicionales que pueden ser visibles o redirigir automáticamente al usuario a una página web conectada al dominio de la página de aterrizaje. La value cadena debe tener comillas dobles alrededor de ella.

Recurso de imagen

Cada uno image_asset representa un componente de imagen de la creatividad nativa. El image_asset objeto incluye los siguientes campos:

Campo	Tipo	Descripción
image_type	string	El formato de la imagen. Los valores posibles son: - main_image: imagen principal que aparecerá cuando se procese la creatividad nativa. - icon_image: Icono principal que aparecerá cuando se renderice la creatividad nativa. - custom_image_1 - custom_image_5: imágenes adicionales que aparecerán cuando se represente la creatividad nativa. - custom_icon_1 - custom_Icon_5: iconos adicionales que aparecerán cuando se renderice el creativo nativo. - custom_social_icon_1 - custom_social_icon_5: iconos de redes sociales correspondientes que aparecerán cuando se represente el creativo nativo.
media_asset_id	Entero	Id. del recurso multimedia. Necesario para creatividades nativas hospedadas. Si media_asset_id se puede recuperar, el creative_asset_image objeto se rellenará automáticamente.
creative_asset_image	objeto	El objeto que contiene los detalles del recurso creativo. Necesario para creatividades nativas de terceros. Para obtener más detalles, consulte Imagen de recurso creativo a continuación.
image_resize_setting	objeto	El objeto que contiene la configuración de cambio de tamaño de imagen. Para obtener más detalles, consulte Configuración de cambio de tamaño de imagen a continuación.

Imagen de recurso creativo

El creative_asset_image objeto incluye los siguientes campos:

Campo	Tipo	Descripción
url	string	La dirección URL de la página de destino de la imagen.
url_secure	string	La dirección URL de página de destino segura de la imagen.
width	Entero	Ancho de la imagen. El valor debe ser > 0.
height	Entero	Alto de la imagen. El valor debe ser > 0.

Configuración de cambio de tamaño de imagen

El image_resize_setting objeto incluye los siguientes campos:

Campo	Tipo	Descripción
resize_enabled	booleano	Indica si se debe cambiar el tamaño de la creatividad. Los valores posibles son: - True - False
crop_enabled	booleano	Indica si la creatividad debe recortarse para rellenar la ubicación. Los valores posibles son: - True - False
aspect_ratio_upper_bound	double	La relación de aspecto máxima permitida para la creatividad.
aspect_ratio_lower_bound	double	La relación de aspecto mínima permitida para la creatividad.
max_scale_factor	double	El valor máximo que se puede escalar el ancho y el alto de la creatividad.

Recurso de vídeo

Cada uno video_asset representa un componente de vídeo de la creatividad nativa. El video_asset objeto incluye los siguientes campos:

Campo	Tipo	Descripción
media_asset_id	Entero	El identificador del recurso multimedia de vídeo alojado. Requerido en:PUT, POST
vast_url	string	URL a un documento VAST. Debe ser seguro. Requerido en:PUT, POST
trackers	matriz	Rastreadores de eventos VAST opcionales.
media_files	matriz	Matriz de archivos multimedia disponibles. Consulte Archivo multimedia para obtener más información. Solo lectura.
duration	Entero	Duración (en milisegundos) del vídeo extraído del recurso multimedia de vídeo o documento VAST. Solo lectura.
minimum_vast_version	string	La versión VAST mínima necesaria para reproducir el vídeo. Valores posibles: - 2.0 - 3.0 - 4.0 Solo lectura.

Solo se debe rellenar uno por { media_asset_id , vast_url } solicitud.

Vast tracker

El vast_tracker objeto incluye los siguientes campos:

Campo	Tipo	Descripción
vast_event_type	string	El tipo de evento de seguimiento. Los valores posibles son: - service - start - skip - error - first_quartile - completion - impression - click
url	string	URL a un documento VAST. Debe ser seguro.

Archivo multimedia

El media_file objeto incluye los siguientes campos:

Campo	Tipo	Descripción
bitrate_kbps	Entero	Velocidad de bits del archivo multimedia.
mime_type	string	Tipo MIME del archivo multimedia.
width	Entero	Ancho del archivo multimedia.
height	Entero	Alto del archivo multimedia.

Nativa

El native objeto utilizado para contener los siguientes campos, que han quedado en desuso.

Campo	Tipo	Descripción
title	text	En desuso.
description	text	En desuso.
full_text	text	En desuso.
context	string	En desuso.
icon_img_url	string	En desuso.
main_media	matriz de objetos	En desuso.
sponsored	string	En desuso.
cta	string	En desuso.
rating	objeto	En desuso.
click_url	string	En desuso.
click_fallback_url	string	En desuso.
custom_key_values	matriz de objetos	En desuso.

Medios principales

Nombre	Tipo	Descripción
width	Entero	En desuso.
height	Entero	En desuso.
media_url	string	En desuso.
media_url_secure	string	En desuso.

Nota:

Solo puede haber un main_media objeto asociado a una creatividad nativa.

Valores de clave personalizados

Nombre	Tipo	Descripción
custom_key	string	En desuso.
custom_value	string	En desuso.

Seguimientos de clics

Nombre	Tipo	Descripción
click_tracker_url	string	En desuso.

Seguimientos de impresiones

Nombre	Tipo	Descripción
impression_tracker_url	string	En desuso.
impression_tracker_url_secure	string	En desuso.

Pixels

Utilice esta matriz para agregar píxeles personalizados y aprobados por Xandr a una creatividad. Puede agregar hasta cinco píxeles para 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. Para obtener más instrucciones, consulte el ejemplo Agregar un píxel aprobado por Xandr a una creatividad en los ejemplos siguientes.

Nota:

Puede usar el servicio de plantillas de píxeles para obtener información sobre estos píxeles, incluido 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. Para obtener más instrucciones, consulte el ejemplo Agregar un píxel personalizado a una creatividad en los ejemplos siguientes.

Precaución

Cuando realiza una PUT llamada para actualizar la matriz de píxeles, la matriz se sobrescribe completamente con la información del archivo con formato JSON. Por lo tanto, si la matriz ya incluye píxeles, asegúrese de incluir también esos píxeles en el archivo con formato JSON.

Campo	Tipo	Descripción
id	Entero	El ID asignado por Xandr de la matriz de píxeles. Asociará píxeles a través de los pixel_template_idcampos , content, o URL enumerados a continuación. Solo lectura.
pixel_template_id	Entero	El id. del píxel aprobado por Xandr. Puede usar el servicio de plantillas de píxeles para obtener esta identificación.
param_1	string	Para el píxel aprobado por Xandr: el valor del primer parámetro en el contenido del píxel o la URL. Para saber cuántos parámetros son necesarios para un píxel aprobado por Xandr, utiliza el servicio de plantillas de píxeles.
param_2	string	Para el píxel aprobado por Xandr: el valor del segundo parámetro en el contenido del píxel o la URL.
param_3	string	Para el píxel aprobado por Xandr: el valor del tercer parámetro en el contenido del píxel o la dirección URL.
param_4	string	Para el píxel aprobado por Xandr: el valor del cuarto parámetro en el contenido del píxel o la URL.
param_5	string	Para el píxel aprobado por Xandr: el valor del quinto parámetro en el contenido del píxel o la URL.
format	enumeración	El formato del píxel. Valores posibles: "raw-js", "url-html", "url-js"o "url-image".
content	cadena (255)	Si el formato de píxel es "raw-js", el contenido HTML o JavaScript para servir con la creatividad.
secure_content	cadena (255)	Si el formato de píxel es "raw-js", el contenido HTML o JavaScript que se va a publicar con el creativo en una llamada publicitaria segura (HTTPS).
url	cadena (255)	Si el formato de píxel es "url-html", "url-js", "url-image", o "raw-url", la URL del píxel HTML, JavaScript o de imagen que se va a publicar con el creativo.
secure_url	cadena (255)	Si el formato de píxel es "url-html", "url-js", "url-image", o "raw-url", la dirección URL del píxel HTML, JavaScript o de imagen para servir con el creativo en una llamada segura (HTTPS).

Político

Objeto "political" utilizado para contener los siguientes campos:

Campo	Tipo	Descripción
in_scope	booleano	Determina si la creatividad política de EE. UU. está dentro del alcance para ser regulada. En caso afirmativo, toda la información política del comprador requerida debe proporcionarse en el nivel de inserción. Para obtener información adicional, consulta la documentación Crear una orden de inserción a través de nuestra interfaz de usuario (es necesario iniciar sesión).

Valores pop

Nota:

Los pop_values campos están en desuso y nuestros sistemas los ignoran/no los usan.

Estos campos deben incluirse en una "pop_values" matriz dentro del JSON creativo. Vea a continuación un ejemplo.

Campo	Tipo (longitud)	Descripción
pop_window_maximize	Booleano	Si true, la etiqueta del editor debe maximizar la ventana. Solo relevante para creativos con formato "url-html" y "url-js". Si pop_window_maximize se establece en true, entonces ni "height""width" debe establecerse en la creatividad. Valor predeterminado:false
pop_is_tag_initiated	Booleano	Si true, la etiqueta del creativo iniciará el estallido. Si false, el bus de impresiones iniciará el estallido. Valor predeterminado:false
pop_window_title	cadena (255)	El título de la ventana emergente. Only applies to pops with pop_is_tag_initiated set to false. No se garantiza que sea compatible con todos los exploradores. Valor predeterminado:Network name
pop_statusbar	Booleano	Si true, se muestra una barra de estado en la ventana emergente. Only applies to pops with pop_is_tag_initiated set to false. No se garantiza que sea compatible con todos los exploradores. Valor predeterminado:true
pop_menubar	Booleano	Si true, se muestra una barra de menú en la ventana emergente. Only applies to pops with pop_is_tag_initiated set to false. No se garantiza que sea compatible con todos los exploradores. Valor predeterminado:true
pop_resizable	Booleano	Si true, se puede cambiar el tamaño de la ventana emergente. Solo se aplica a pops con pop_is_tag_initiated el valor establecido en false. No se garantiza que sea compatible con todos los exploradores. Valor predeterminado:true
pop_scrollbars	Booleano	Si true, se muestran barras de desplazamiento en la ventana emergente. Only applies to pops with pop_is_tag_initiated set to false. No se garantiza que sea compatible con todos los exploradores. Valor predeterminado:true
pop_toolbar	Booleano	Si true, se muestra una barra de herramientas en la ventana emergente. Only applies to pops with pop_is_tag_initiated set to false. No se garantiza que sea compatible con todos los exploradores. Valor predeterminado:true
pop_addressbar	Booleano	Si true, se muestra una barra de direcciones en la ventana emergente. Only applies to pops with pop_is_tag_initiated set to false. No se garantiza que sea compatible con todos los exploradores. Valor predeterminado:true

Segmentos

Estos campos se incluirán en la matriz Segments:

Campo	Tipo	Descripción
id	Entero	El identificador del segmento. Requerido en:POST, PUT
segment_id	Entero	El identificador del segmento. Este campo contiene la misma información que el id campo.
action	enumeración	La acción realizada por los usuarios que los agregará al segmento. Valores posibles: "add on view" o "add on click". Requerido en:POST, PUT
name	string	El nombre del segmento.

Estado

Nombre	Tipo	Descripción
user_ready	booleano	El estado del conjunto de creatividades por parte del usuario, que describe si la creatividad está lista para publicarse o no. Valores posibles: "true" o "false". El valor de user_ready debe ser verdadero para reactivar una creatividad expirada junto con su audit_status. Valor predeterminado:true
hosted_assets_association_complete	Boolean o NULL	Estado de la creatividad cargada por los sistemas internos de Xandr. Valores posibles: "true" o "false" para creatividades hospedadas y "null" para creatividades de terceros. Solo lectura.

Píxeles de terceros

La thirdparty_pixels matriz contiene los campos de la tabla siguiente. Estos campos, excepto id, son de solo lectura. Use este servicio para actualizar el id de un píxel de terceros o adjuntar píxeles de terceros a creatividades individuales.

Campo	Tipo	Descripción
id	Entero	El identificador del píxel. Requerido en:PUT
name	string	El nombre completo del píxel. Solo lectura.
active	Booleano	El estado actual del píxel (verdadero = activo). Solo lectura.
audit_status	string	Estado de auditoría del píxel. Solo lectura.

Nota:

Para actualizar o crear un píxel de terceros o adjuntar píxeles de terceros a todas las creatividades propiedad del anunciante o miembro de la red, utilice el servicio de píxeles de terceros.

Primera ejecución/última ejecución

Para incluir los first_run campos and last_run en una GET respuesta, pase flight_info=true la cadena de consulta. También puedes filtrar los recursos creativos en función de cuándo se publicaron por primera vez y cuándo se publicaron por última vez, de la siguiente manera:

Recuperar solo los recursos creativos que nunca se han publicado

Pase never_run=true la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/creative?advertiser_id=100&flight_info=true&never_run=true'

Nota:

Puede usarlo never_run=true en combinación con otros filtros, pero tenga en cuenta que siempre será una relación OR. Por ejemplo, si pasa ambos never_run=truey min_first_run=2012-01-01 00:00:00 en la cadena de consulta, buscará creatividades que nunca se hayan publicado O líneas de pedido que se publicaron por primera vez el 01-01-2012 o después.

Recuperar solo los recursos creativos que se publicaron por primera vez en una fecha específica o después de ella

Pase min_first_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/creative?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00'

Recuperar solo los recursos creativos que se publicaron por primera vez en una fecha específica o antes

Pase max_first_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/creative?advertiser_id=100&flight_info=true&max_first_run=2012-08-01 00:00:00'

Recuperar solo las creatividades que se sirvieron por primera vez dentro de un intervalo de fechas específico

Pase min_first_run=YYYY-MM-DD HH:MM:SS&max_first_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/creative?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00&max_first_run=2012-08-01 00:00:00'

Recuperar solo los creativos que se publicaron por última vez en una fecha específica o después de ella

Pase min_last_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/creative?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00'

Recuperar solo las creatividades que se publicaron por última vez en una fecha específica o antes de esa fecha

Pase max_last_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/creative?advertiser_id=100&flight_info=true&max_last_run=2012-08-01 00:00:00'

Recuperar solo las creatividades que se publicaron por última vez en un intervalo de fechas específico

Pase min_last_run=YYYY-MM-DD HH:MM:SS&max_last_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/creative?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00&max_last_run=2012-08-01 00:00:00'

Estadísticas

Nota:

El statsobjeto ha quedado en desuso (a partir del 17 de octubre de 2016). En su lugar, utilice el servicio de informes para obtener información estadística.

Cambios que provocan una nueva auditoría

Una vez que una creatividad ha pasado la auditoría de Xandr (audit_status es "audited"), cambiar cualquiera de los siguientes campos hace que la creatividad se vuelva a enviar para la auditoría (audit_status se establece en "pending"):

• width
• height
• content
• media_url
• click_url
• template
• custom_macros
• media_subtypes
• language
• categories
• technical_attributes
• brand_id
• pixel_url
• pixels (si se 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 POP Creative)
• pop_is_tag_initiated (si es pop creativo y cambia de falso a verdadero)
• video_attribute
• media_assets
• brand_url (no aplicable a los usuarios de API)
• alternative_landing_page_url
• native_attribute

Además, si el audit_status cambio allow_audit de a "no_audit""true" hace que la creatividad se vuelva a enviar para la auditoría de "false" Xandr.

Macros creativas

Xandr ha predefinido algunas macros que se pueden usar dentro de los campos , , click_url, y pixel_url de media_urlcontentla creatividad.

Ejemplo de seguimiento de clics

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

Ejemplos

Precaución

Excluir audit_status y no_audit en PUT llamadas para evitar errores.

Agregar una imagen de banner Recurso creativo (alojado)

Al cargar una creatividad de imagen de banner estándar para hospedaje con Xandr:

Una vez que se haya registrado la creatividad, el contenido se almacenará en la red CDN y se le asignará un media_url mensaje como https://cdn.adnxs.com/p/29/23/21/a0/292321a0bea05427598914c8bb626032.jpg.

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no quieres que se audite el creativo, debes incluirlo allow_audit y establecerlo en false. Alternativamente, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla en true.

$ cat creative

{
   "creative": {
      "template": {"id":4},
      "width": 300,
      "height": 250,
      "click_url": "https://www.gothere.com",
      "click_target": "https://www.gothere.com",
      "file_name": "gothere.png",
      "content": "/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3kAAQAEAAAAPAAA/+4ADkFkb2JlAGTAAAAAAf/b
                 AIQABgQEBAUEBgUFBgkGBQYJCwgGBggLDAoKCwoKDBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxsc
                 Hx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8f
                 ...
                 nwj3HrP+oer6/wDPa/tKsOz/AEf8CnxP82z3fTu9VDboP//Z",
       "is_political_and_eu_targeted": false,
       "is_political_and_non_eu_targeted": false
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=2'

{
   "response": {
      "status": "OK",
      "id": 10,
      ...
      "template": {
          "id": 4,
          "name": "Standard",
          "media_subtype_id": 1,
          "format_id": 4
      },
      "width": 300,
      "height": 250,
      ...
      "click_url": "https://www.gothere.com",
      "click_target": "https://www.gothere.com",
      "media_url": "https://cdn.adnxs.com/p/29/23/21/a0/gothere.png"
      ...
      "audit_status": "pending",
      ...
     "categories":  [
           {
                 "id": 37,
                 "name": "Politics",
                 "self_declared": true
          }],
   }
}

Agregar una imagen de banner móvil creativa (hospedada)

Para que las creatividades móviles pasen la auditoría de la plataforma Xandr, debes pasar el mobile objeto con una URL alternativa que se muestre correctamente en un navegador de escritorio cuando se haga clic en la creatividad.

$ cat creative
 
{
    "creative": {
        "content": "\/9j\/4AAQSkZJRgABAQEASABIAAD\/7QCEUGhvdG9zaG9wIDMuMAA4QklNBAQAAAAAAGccAVoAAxsl...",
        "mobile": {
            "alternative_landing_page_url": "https:\/\/example.com"
        },
        "file_name": "SWEET.png",
        "click_url": "https:\/\/example.com",
        "click_target": "https:\/\/example.com",
        "height": 250,
        "width": 300,
        "template": {
            "id": 4
        }
    }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=3141'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 700864,
        "start_element": 0,
        "num_elements": 100,
        "creative": {
            "name": null,
            "brand_id": 1,
            "media_url": "https:\/\/cdn.sand-08.adnxs.net\/s\/d3\/d6\/1c\/61\/d3d61c611fd6f98becc8ad6d45c43875.png",
            "id": 700864,
            "code": null,
            "code2": null,
            "member_id": 1309,
            "state": "inactive",
            "click_track_result": "not_tested",
            "advertiser_id": 41798,
            "publisher_id": null,
            "format": null,
            "width": 300,
            "height": 250,
            "click_url": "https:\/\/example.com",
            "click_target": "https:\/\/example.com",
            "flash_click_variable": null,
            "no_iframes": false,
            "content": null,
            "original_content": null,
            "file_name": "OH_YEAH.png",
            "track_clicks": true,
            "audit_status": "pending",
            "macros": null,
            "profile_id": null,
            "audit_feedback": null,
            "is_prohibited": false,
            "is_suspicious": false,
            "created_on": "2013-10-18 15:57:03",
            "flash_backup_url": null,
            "last_modified": "2013-10-18 15:57:03",
            "is_control": false,
            "allow_audit": true,
            "is_expired": false,
            "creative_upload_status": "pending",
            "backup_upload_status": null,
            "use_dynamic_click_url": false,
            "media_subtypes": [
                "banner"
            ],
            "size_in_bytes": 15171,
            "msft_audit_status": "pending",
            "msft_audit_feedback": null,
            "msft_external_audit_status": "pending",
            "msft_external_audit_feedback": null,
            "is_self_audited": false,
            "no_adservers": false,
            "text_title": null,
            "text_description": null,
            "text_display_url": null,
            "click_action": "click-to-web",
            "ssl_status": "disabled",
            "allow_ssl_audit": false,
            "media_url_secure":"https:\/\/a248.e.akamai.net\/appnexus.download.akamai.com\/89298\/sandbox\/s\/d3\/d6\/1c\/61\/d3d61c611fd6f98becc8ad6d45c43875.png",
            "content_secure": null,
            "original_content_secure": null,
            "flash_backup_url_secure": null,
            "is_hosted": true,
            "content_source": "standard",
            "lifetime_budget_imps": null,
            "daily_budget_imps": null,
            "enable_pacing": null,
            "allow_safety_pacing": null,
            "lifetime_budget": null,
            "daily_budget": null,
            "landing_page_url": null,
            "thirdparty_creative_id": null,
            "thirdparty_campaign_id": null,
            "custom_request_template": null,
            "language": {
                "id": 1,
                "name": "English"
            },
            "pop_values": null,
            "brand": {
                "id": 1,
                "name": "Unknown",
                "category_id": 8
            },
            "template": {
                "id": 4,
                "name": "Standard",
                "media_subtype_id": 1,
                "format_id": 4
            },
            "thirdparty_page": null,
            "custom_macros": null,
            "segments": null,
            "folder": null,
            "campaigns": null,
            "competitive_brands": null,
            "competitive_categories": null,
            "pixels": null,
            "mobile": {
                "alternative_landing_page_url":"https:\/\/example.com"
            },
            "sla": null,
            "sla_eta": null,
            "currency": "USD"
        },
        "dbg_info": {
            ...
        }
    }
}

Agregar un banner Flash Creative (alojado)

Al cargar una creatividad flash de banner estándar para hospedaje con Xandr:

Una vez que se haya registrado la creatividad, el contenido se almacenará en la red CDN y se le asignará un media_url mensaje como https://cdn.adnxs.com/p/29/23/21/a0/292321a0bea05427598914c8bb626032.jpg.

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no quieres que se audite el creativo, debes incluirlo allow_audit y establecerlo en false. Alternativamente, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla en true.

$ cat creative

{
   "creative": {
      "template": {"id":3},
      "width": 300,
      "height": 250,
      "click_url": "https://www.gothere.com",
      "click_target": "htpps://www.gothere.com",
      "file_name": "gothere.swf",
      "flash_click_variable": "ClickTag",
      "content": "/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3kAAQAEAAAAPAAA/+4ADkFkb2JlAGTAAAAAAf/b
                 AIQABgQEBAUEBgUFBgkGBQYJCwgGBggLDAoKCwoKDBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxsc
                 Hx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8f
                 ...
                 nwj3HrP+oer6/wDPa/tKsOz/AEf8CnxP82z3fTu9VDboP//Z",
      "flash_backup_content": "AcndgAAZABkAAD/7AARRHVja3kAAQAEAAAAPAAA/+4ADkFkb2JlAGTAAAAAAf/b
                 AIQABgQEBAUEBgUFBgkGBQYJCwgGcdkDCADBdcdDDBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxsc
                 Hx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx6smd34
                 ...
                 nwj3HrP+oer6/wDPa/tKsOz/AEf8Cnnd30cddaxcio244adc",
      "flash_backup_file_name": "flash_backup.png"
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=2'

{
   "response": {
      "status": "OK",
      "id": 11,
      ...
      "template": {
          "id": 3,
          "name": "Standard",
          "media_subtype_id": 1,
          "format_id": 3
      },
      "width": 300,
      "height": 250,
      ...
      "click_url": "https://www.gothere.com",
      "click_target": "https://www.gothere.com",
      "media_url": "https://cdn.adnxs.com/p/29/23/21/a0/gothere.swf"
      "flash_backup_url": "https://cdn.adnxs.com/c/54/f2/d1/v3/flash_backup.png"
      ...
      "audit_status": "pending",
      ...
   }
}

Agregar un banner Creatividad flash (URL de terceros)

Al añadir una URL de terceros para un banner creativo flash:

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no quieres que se audite el creativo, debes incluirlo allow_audit y establecerlo en false. Alternativamente, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla en true.

$ cat creative

{
   "creative": {
      "media_url": "https://creative.com/300x250",
      "flash_backup_url": "https://creative.com/backupimage/300x250",
      "template": {"id":2},
      "width": 300,
      "height": 250,
      "campaigns": [
         {"id":58990},
         {"id":58991}
      ]
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=35'

{
   "response": {
      "status": "OK",
      "id":12,
      ...
      "media_url": "https://creative.com/300x250",
      "flash_backup_url": "https://creative.com/backupimage/300x250",
      ...
      "template": {
          "id": 2,
          "name": "Standard",
          "media_subtype_id": 1,
          "format_id": 2
      },
      ...
      "audit_status": "pending",
      ...
   }
}

Añadir un creativo expandible de MediaMind (URL de terceros)

En este ejemplo, observa que el media_url campo proporciona la URL de terceros para la creatividad expandible, y la matriz de plantillas especifica la plantilla 108, que es la plantilla estándar de Xandr para creatividades del subtipo multimedia "MediaMind Expandable" y el "url-js" formato.

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no quieres que se audite el creativo, debes incluirlo allow_audit y establecerlo en false. Alternativamente, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla en true.

$ cat creative

{
   "creative": {
      "media_url": "https://bs.serving-sys.com/BurstingPipe/adServer.bs?ncu=$$${CLICK_URL_ENC}$$&cn=rsb&c=28&
          pli=2980019&PluID=0&w=300&h=250&ord=${CACHEBUSTER}&ucm=true",
      "template": {"id":108},
      "width": 300,
      "height": 250,
      "campaigns":[
          {"id": 58990},
          {"id": 58991}
      ]
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=35'

{
   "response":{
      "status":"OK",
      "id":12,
      ...
      "media_url":"https://bs.serving-sys.com/BurstingPipe/adServer.bs?ncu=$$${CLICK_URL_ENC}$$&cn=rsb&c=28&
          pli=2980019&PluID=0&w=300&h=250&ord=${CACHEBUSTER}&ucm=true",
      ...
      "template": {
          "id": 108,
          "name": "Standard",
          "media_subtype_id": 11,
          "format_id": 2
      },
      ...
      "audit_status": "pending",
      ...
   }
}

Agregar un creativo expandible de Pointroll (etiqueta HTML de terceros)

En este ejemplo, observa que el campo de contenido proporciona la etiqueta de JavaScript para la creatividad expandible y la matriz de plantillas especifica la plantilla 159, que es la plantilla estándar de Xandr para las creatividades del subtipo de "Pointroll Expandable" medios y el "raw-html" formato.

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no quieres que se audite el creativo, debes incluirlo allow_audit y establecerlo en false. Alternativamente, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla en true.

$ cat creative

{
   "creative": {
      "content":<script type=\"text/javascript\">function pr_swfver(){var osf,osfd,i,axo=1,v=0,nv=navigator;
       if(nv.plugins&&nv.mimeTypes.length){osf=nv.plugins[\"ShockwaveFlash\"];if(osf&&osf.description)
       {osfd=osf.description;v=parseInt(osfd.substring(osfd.indexOf(\".\")-2))}}else{try{for(i=5;axo!=null;i++)
       {axo=new ActiveXObject(\"ShockwaveFlash.ShockwaveFlash.\"+i);v=i}}catch(e){}}return v;}var pr_d=new Date
       ();pr_d=pr_d.getDay()+\"|\"+pr_d.getHours()+\": \"+pr_d.getMinutes()+\"|\"+-pr_d.getTimezoneOffset()/60;
       var pr_postal=\"\";var pr_data=\"\";var pr_redir=\"$CTURL$\";var pr_nua=navigator.userAgent.toLowerCase();
       </script>,
      "template": {"id":159},
      "width": 300,
      "height": 250,
      "campaigns": [
         {"id": 58990},
         {"id": 58991}
      ]
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=35'

{
   "response": {
      "status": "OK",
      "id": 12
      ...
      "content":"var click = '${CLICK_URL}'; var t = (new Date()).getTime(); var s = document.createElement('script');
                s.setAttribute('src', 'https://pointroll.adserver.org/showad?size=300x250;click=' + click + ';ord=' + t);
                document.getElementsByTagName('body').appendChild(s);https://creative.com/300x250",
      ...
      "template": {
         "id": 159,
         "name": "Standard",
         "media_subtype_id": 12,
         "format_id": 6
      },
      ...
      "audit_status":"pending",
      ...
   }
}

Agregar un creativo de imagen emergente (URL de terceros)

En este ejemplo, ten en cuenta que el media_url campo proporciona la URL de terceros para la creatividad de imagen emergente, y la matriz de plantillas especifica la plantilla 10, que es la plantilla de renderizado Xandr estándar para el "Popup" subtipo de medios y el "url-js" formato. Si no especifica una plantilla en la solicitud, debe pasar format as "image" and media_subtype as "popup".

{
   "creative":
   {
     "media_url": "https://dummyimage.com/728x90",
     "click_url": "https://www.google.com",
     "click_target": "https://www.google.com",
     "template": {"id":10},
     "pop_values": {
       "pop_is_tag_initiated": false,
       "pop_window_maximize": false,
       "pop_window_title": null,
       "pop_statusbar": false,
       "pop_resizable": false,
       "pop_scrollbars": false,
       "pop_toolbar": false,
       "pop_addressbar": false
       },
      "width": 728,
      "height": 90
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=2'

{
   "response": {
      "status": "OK",
      "id": 14,
      ...
      "template": {
          "id": 10,
          "name": "Standard",
          "media_subtype_id": 2,
          "format_id": 2
      },
      "width": 728,
      "height": 90,
      ...
      "audit_status": "pending",
      ...
   }
}

Añadir una imagen emergente del creativo (URL de terceros)

En este ejemplo, ten en cuenta que el media_url campo proporciona la URL de terceros para la creatividad de imagen emergente, y la matriz de plantillas especifica la plantilla 17, que es la plantilla de renderizado estándar de Xandr para el "Popunder" subtipo de medios y el "url-js" formato. Si no incluye una plantilla en la solicitud, debe pasar el formato como "image" y media_subtype como "popunder".

{
   "creative" :
   {
     "media_url": "https://dummyimage.com/728x90",
     "click_url": "https://www.google.com",
     "click_target": "https://www.google.com",
     "template": {"id":17},
     "pop_values": {
       "pop_is_tag_initiated": false,
       "pop_window_maximize": false,
       "pop_window_title": null,
       "pop_statusbar": false,
       "pop_resizable": false,
       "pop_scrollbars": false,
       "pop_toolbar": false,
       "pop_addressbar": false
       },
      "width": 728,
      "height": 90
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=2'

{
   "response": {
      "status": "OK",
      "id":14,
      ...
      "template": {
          "id": 17,
          "name": "Standard",
          "media_subtype_id": 2,
          "format_id": 2
      },
      "width": 728,
      "height": 90,
      ...
      "audit_status": "pending",
      ...
   }
}

Agregar un vídeo en la pancarta (archivo de vídeo de terceros)

Al agregar un archivo de vídeo en el banner de terceros:

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no quieres que se audite el creativo, debes incluirlo allow_audit y establecerlo en false. Alternativamente, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla en true.

$ cat inbanner

{
   "creative": {
      "media_url": "https://example.com/inbanner.flv",
      "template": {"id":219},
      "click_url": "https://www.example.com",
      "click_target": "https://www.example.com",
      "width": 300,
      "height": 250,
      "flash_backup_url": "https://www.example.com/poster_image.png"
      "custom_macros": [
          {
              "code": "FLV_URL",
              "value": "https:www.example.com/inbanner.flv"
          },
          {
              "code": "MP4_URL",
              "value": "https:www.example.com/inbanner.mp4"
          },
          {
              "code": "WEBM_URL",
              "value": "https:www.example.com/inbanner.webm"
          }
      ],
   }
}


$ curl -b cookies -c cookies -X POST -d @inbanner 'https://api.appnexus.com/creative?advertiser_id=2'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 510242,
        "start_element": 0,
        "num_elements": 100,
        "creative": {
            "name": null,
            "brand_id": 1,
            "media_url": "https://example.com/inbanner.flv",
            "id": 510244,
            "code": null,
            "code2": null,
            "state": "inactive",
            "click_track_result": "not_tested",
            "advertiser_id": 2,
            "publisher_id": null,
            "format": null,
            "width": 300,
            "height": 250,
            "click_url": "https://www.example.com",
            "flash_click_variable": null,
            "pixel_url": null,
            "pixel_type": "image",
            "no_iframes": false,
            "content": null,
            "original_content": null,
            "file_name": "inbanner.flv",
            "track_clicks": true,
            "audit_status": "pending",
            "macros": null,
            "profile_id": null,
            "audit_feedback": null,
            "is_prohibited": false,
            "created_on": "2012-04-13 14:47:46",
            "flash_backup_url": "https://example.com/poster_image.png",
            "last_modified": "2012-04-13 14:47:46",
            "is_control": false,
            "allow_audit": true,
            "is_expired": false,
            "creative_upload_status": "pending",
            "backup_upload_status": null,
            "use_dynamic_click_url": false,
            "media_subtypes": [
                "banner"
            ],
            "size_in_bytes": 0,
            "msft_audit_status": "pending",
            "msft_audit_feedback": null,
            "msft_external_audit_status": "pending",
            "msft_external_audit_feedback": null,
            "is_self_audited": false,
            "no_adservers": false,
            "text_title": null,
            "text_description": null,
            "text_display_url": null,
            "click_action": "click-to-web",
            "click_target": "https://www.example.com",
            "ssl_status": "disabled",
            "allow_ssl_audit": false,
            "media_url_secure": "https://example.com/inbanner.flv",
            "content_secure": null,
            "original_content_secure": null,
            "pixel_url_secure": null,
            "flash_backup_url_secure": null,
            "is_hosted": true,
            "lifetime_budget_imps": null,
            "daily_budget_imps": null,
            "enable_pacing": null,
            "lifetime_budget": null,
            "daily_budget": null,
            "language": {
                "id": 1,
                "name": "English"
            },
            "pop_values": null,
            "brand": {
                "id": 1,
                "name": "Unknown",
                "category_id": 8
            },
            "template": {
                "id": 219,
                "name": "Standard",
                "media_subtype_id": 3,
                "format_id": 11
            },
            "custom_macros": [
                {
                    "code": "AUTOPLAY",
                    "value": "0"
                },
                {
                    "code": "CONTROLS",
                    "value": "1"
                },
               {
                    "code": "FLV_URL",
                    "value": "https:www.example.com/inbanner.flv"
                },
                {
                    "code": "MP4_URL",
                    "value": "https:www.example.com/inbanner.mp4"
                },
                {
                    "code": "WEBM_URL",
                    "value": "https:www.example.com/inbanner.webm"
                }
            ],
            "segments": null,
            "folder": null,
            "campaigns": null,
            "competitive_brands": null,
            "competitive_categories": null,
            "pixels": null,
            "sla": null,
            "sla_eta": null,
            "currency": "USD"
        },
        "dbg_info": {
            ... 
        }
    }
}

Añadir un vídeo en la pancarta (archivo XML de terceros)

Al agregar un archivo XML en el banner de terceros:

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no quieres que se audite el creativo, debes incluirlo allow_audit y establecerlo en false. Alternativamente, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla en true.

$ cat inbanner

{
   "creative": {
      "media_url": "https://example.com/inbanner.xml",
      "template": {"id":8},
      "click_url": "https://www.example.com",
      "click_target": "https://www.example.com",
      "width": 300,
      "height": 250,
      "flash_backup_url": "https://example.com/poster_image.png"
   }
}


$ curl -b cookies -c cookies -X POST -d @inbanner 'https://api.appnexus.com/creative?advertiser_id=2'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 510242,
        "start_element": 0,
        "num_elements": 100,
        "creative": {
            "name": null,
            "brand_id": 1,
            "media_url": "https://example.com/inbanner.xml",
            "id": 510245,
            "code": null,
            "code2": null,
            "state": "inactive",
            "click_track_result": "not_tested",
            "advertiser_id": 2,
            "publisher_id": null,
            "format": null,
            "width": 300,
            "height": 250,
            "click_url": "https://www.example.com",
            "flash_click_variable": null,
            "pixel_url": null,
            "pixel_type": "image",
            "no_iframes": false,
            "content": null,
            "original_content": null,
            "file_name": "inbanner.xml",
            "track_clicks": true,
            "audit_status": "pending",
            "macros": null,
            "profile_id": null,
            "audit_feedback": null,
            "is_prohibited": false,
            "created_on": "2012-04-13 14:47:46",
            "flash_backup_url": "https://example.com/poster_image.png",
            "last_modified": "2012-04-13 14:47:46",
            "is_control": false,
            "allow_audit": true,
            "is_expired": false,
            "creative_upload_status": "pending",
            "backup_upload_status": null,
            "use_dynamic_click_url": false,
            "media_subtypes": [
                "banner"
            ],
            "size_in_bytes": 0,
            "msft_audit_status": "pending",
            "msft_audit_feedback": null,
            "msft_external_audit_status": "pending",
            "msft_external_audit_feedback": null,
            "is_self_audited": false,
            "no_adservers": false,
            "text_title": null,
            "text_description": null,
            "text_display_url": null,
            "click_action": "click-to-web",
            "click_target": "https://www.example.com",
            "ssl_status": "disabled",
            "allow_ssl_audit": false,
            "media_url_secure": "https://example.com/inbanner.xml",
            "content_secure": null,
            "original_content_secure": null,
            "pixel_url_secure": null,
            "flash_backup_url_secure": null,
            "is_hosted": true,
            "lifetime_budget_imps": null,
            "daily_budget_imps": null,
            "enable_pacing": null,
            "lifetime_budget": null,
            "daily_budget": null,
            "language": {
                "id": 1,
                "name": "English"
            },
            "pop_values": null,
            "brand": {
                "id": 1,
                "name": "Unknown",
                "category_id": 8
            },
            "template": {
                "id": 8,
                "name": "Standard",
                "media_subtype_id": 3,
                "format_id": 10
            },
            "custom_macros": null,
            "segments": null,
            "folder": null,
            "campaigns": null,
            "competitive_brands": null,
            "competitive_categories": null,
            "pixels": null,
            "sla": null,
            "sla_eta": null,
            "currency": "USD"
        },
        "dbg_info": {
           ...
        }
    }
}

Agregar un recurso creativo que utiliza una plantilla de representación personalizada

En este ejemplo, la POST solicitud añade un banner flash alojado creativo a Xandr. El creativo utiliza una plantilla personalizada de creativo, que está diseñada para representar el creativo con un borde cuando se sirve. Las macros personalizadas de la plantilla permiten al trafficker especificar el código de color HTML y el tamaño (en píxeles) o el borde.

$ cat creative

{
   "creative": {
      "template": {"id":252},
      "width": 300,
      "height": 250,
      "custom_macros": [
         {
            "code": "BORDER_COLOR",
            "value": "#000000"
         },
         {
            "code": "BORDER_SIZE",
            "value": 1
         }
      ],
      "click_url": "https://www.gothere.com",
      "click_target": "https://www.gothere.com",
      "file_name": "gothere.swf",
      "flash_click_variable": "ClickTag",
      "content": "/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3kAAQAEAAAAPAAA/+4ADkFkb2JlAGTAAAAAAf/b
                 AIQABgQEBAUEBgUFBgkGBQYJCwgGBggLDAoKCwoKDBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxsc
                 Hx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8f
                 ...
                 nwj3HrP+oer6/wDPa/tKsOz/AEf8CnxP82z3fTu9VDboP//Z",
      "flash_backup_content": "AcndgAAZABkAAD/7AARRHVja3kAAQAEAAAAPAAA/+4ADkFkb2JlAGTAAAAAAf/b
                 AIQABgQEBAUEBgUFBgkGBQYJCwgGcdkDCADBdcdDDBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxsc
                 Hx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx6smd34
                 ...
                 nwj3HrP+oer6/wDPa/tKsOz/AEf8Cnnd30cddaxcio244adc",
      "flash_backup_file_name": "flash_backup.png"
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=2'

{
   "response": {
      "status": "OK",
      "id": 11,
      ...
      "template": {
          "id": 252,
          "name": "Flash Banner with Border",
          "media_subtype_id": 1,
          "format_id": 3
      },
      "width": 300,
      "height": 250,
      ...
      "click_url": "https://www.gothere.com",
      "click_target": "https://www.gothere.com",
      "media_url": "https://cdn.adnxs.com/p/29/23/21/a0/gothere.swf"
      "flash_backup_url": "https://cdn.adnxs.com/c/54/f2/d1/v3/flash_backup.png"
      ...
      "audit_status": "pending",
      ...
      "custom_macros": [
         {
            "code": "BORDER_COLOR",
            "value": "#000000"
         },
         {
            "code": "BORDER_SIZE",
            "value": 1
         }
      ],
      ...
   }
}

Agregar un creativo seguro

Al cargar una creatividad no segura, también puede cargar una versión para que se publique en el inventario SSL de la siguiente manera:

Nota:

Puede comprobar el estado de auditoría SSL de una creatividad realizando una simple GET solicitud. El ssl_status campo de la respuesta te indica el estado de auditoría. La creatividad será elegible para servir en el inventario seguro solo una vez que pase la auditoría y el ssl_status es "approved". Una creatividad de terceros pasará nuestra auditoría solo si todas las llamadas en la cadena de anuncios pasan por servidores seguros. Si la creatividad no supera la auditoría SSL, puede volver a enviarla para la auditoría SSL cambiando el ssl_status campo a "pending".

$ cat creative

{
   "creative": {
      "media_url": "https://creative.com/123",
      "media_url_secure": "https://creative.com/123",
      "template": {"id":2},
      "allow_ssl_audit": true
      "format": "image",
      "width": 300,
      "height": 250,
      "campaigns": [
         {"id":58990},
         {"id":58991}
      ]
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=35'

{
   "response": {
      "status":"OK",
      "id":13
      ...
      "audit_status":"pending",
      ...
      "ssl_status":"pending",
      ...
   }
}

Enviar un recurso creativo para una auditoría prioritaria

Si tiene un contrato de servicios complementarios con Xandr para auditorías prioritarias, puede enviar una creatividad para auditoría prioritaria (auditoría dentro de las 2 horas durante el horario comercial) estableciendo el sla campo en 2. El sla_eta campo de la respuesta proporcionará un tiempo estimado de finalización de la auditoría.

$ cat creative

{
   "creative": {
      "media_url": "https://creative.com/456",
      "template": {"id":2},
      "width": 300,
      "height": 250,
      "campaigns": [
         {"id":58990},
         {"id":58991}
      ],
      "sla": 2
   }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=35'

{
   "response": {
      "status": "OK",
      "id": 469340,
      ...
      "audit_status": "pending",
      ...
      "sla": "2",
      "sla_eta": "2012-01-13 22:43:33",
      ...
   }
}

Cancelar una auditoría de creatividad

Si ha enviado una creatividad para la auditoría de Xandr, y el audit_status es , puede cancelar la auditoría y no se le cobrará la tarifa de auditoría haciendo una PUT solicitud con allow_audit establecido en false"pending". El audit_status campo estará "no_audit" en la respuesta.

$ cat creative

{
   "creative": {
      "allow_audit":false
   }
}

$ curl -b cookies -c cookies -X PUT -d @creative 'https://api.appnexus.com/creative?id=469340&advertiser_id=35'

{
   "response": {
      "status": "OK",
      "id": 469340,
      ...
      "audit_status":"no_audit",
      ...
   }
}

Ver estadísticas de auditoría de todos los recursos creativos

En este ejemplo, "audit_stats=true" se pasa en la cadena de consulta de la GET llamada. Devuelve el número de creatividades con cada estado de auditoría de Xandr, Microsoft y Google.

$ curl -b cookies -c cookies 'https://api.appnexus.com/creative?audit_stats=true'

{
    "response": {
        "status": "OK",
        "count": 30,
        "start_element": 0,
        "num_elements": 100,
        "creatives": [
            {
                "total": 30,
                "appnexus_audit": {
                    "no_audit": 10,
                    "pending": 18,
                    "approved": 0,
                    "rejected": 1
                },
                "microsoft_audit": {
                    "no_audit": 10,
                    "pending": 18,
                    "approved": 1,
                    "rejected": 1
                }
            }
        ],
        "dbg_info": {
            ...
        }
    }
}

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.

1. En primer lugar, hay que averiguar los pixel_template_id parámetros 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.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\" : \"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": {
               ...
           }
       }
   }
   

2. 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, debe proporcionar valores para {P1} y {P2} en el contenido del píxel.

3. Usted crea el archivo con formato JSON para añadir el píxel a la creatividad. En el archivo, estableces pixel_template_id en 2, y estableces param_1 y en param_2 los valores para {P1} y {P2} en el contenido de píxeles.

   Precaución

   La matriz de píxeles se sobrescribirá completamente con su JSON. Por lo tanto, si la matriz de píxeles de la creatividad ya incluye píxeles, asegúrese de especificarlos también en la matriz JSON. Para obtener más información, consulte Servicio creativo.

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

4. Finalmente, realiza una PUT llamada 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.

   Nota:

   El píxel Evidon AdChoices Icon no hace que la creatividad requiera una nueva auditoría, audit_status no se ha revertido a "pending".

   $ curl -b cookies -c cookies -X PUT -d @creative_update 'https://api.appnexus.com/creative?id=503577&advertiser_id=35081'
   
   {
       "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",
               "advertiser_id": 35081,
               ...
               "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": {
               ...
           }
       }
   }
   

Agregar un píxel personalizado a una creatividad

En este ejemplo, la solicitud agrega un píxel url-js personalizado a la PUT 503577 creativa. En el archivo con formato JSON, el formato se establece en "url-js", y la dirección URL se establece en la ubicación del JavaScript que desea servir con la creatividad.

Nota:

En la respuesta que es"pending"; Esto se debe a queaudit_status, al agregar un píxel personalizado a una creatividad, la creatividad se vuelve a enviar para su auditoría.

Precaución

La matriz de píxeles se sobrescribirá completamente con la información de este archivo. Por lo tanto, si la creatividad ya incluye píxeles, asegúrate de especificarlos también en el archivo.

$ 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.appnexus.com/creative?id=503577&advertiser_id=35081'

{
    "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",
            "advertiser_id": 35081,
            ...
            "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 píxel de terceros a una creatividad

En este ejemplo, la solicitud agrega 2 píxeles de terceros a la PUT "503577" creativa.

Nota:

En la respuesta que es"pending"; Esto se debe a que agregar un píxel de terceros a una creatividad hace que audit_status la creatividad se vuelva a enviar para auditoría.

$ cat creative_update

{
    "creative": {
        "thirdparty_pixels": [
          {
            "id": 145
          },
          {
            "id": 314
          }
        ]
    }
}

$ curl -b cookies -c cookies -X PUT -d @creative_update 'https://api.appnexus.com/creative?id=503577&advertiser_id=35081'

{
    "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",
            "advertiser_id": 35081,
            ...
            "audit_status": "pending",  ??remove this, confirm with UTSAV
            ...
            "thirdparty_pixels": [

                {
                  "id": 145,
                  "name": "sample pixel",
                  "audit_status": "pending",
                  "active": true
                },
                {
                  "id": 314,
                  "name": "another sample pixel",
                  "audit_status": "pending",
                  "active": true
                }
            ],
            ...
        },
        "dbg_info": {
            ...
        }
    }
}

Agregar un creativo (etiqueta HTML de terceros)

Cuando el campo de formato se establece en "raw-html"document.write() , el content contenido del campo debe ajustarse y también escaped.

$ cat creative 
{
    "creative": {
        "adservers": [
            {
                "id": 79,
                "use_type": "adserver"
            }
        ],
        "name": "Test Creative",
        "original_content": "<script language=\"javascript\"src=\"https://track.adform.net/adfscript/?bn=2342059;click=${CLICK_URL}\"></script><noscript><a href=\"{CLICK_URL}https://track.adform.net/C/?bn=2342059;C=0\"  target=\"_blank\"><img  src=\"https://track.adform.net/adfserve/?bn=2342059;srctype=4;ord=${CACHEBUSTER}\"  border=\"0\"  width=\"300\"  height=\"250\"  alt=\"\"/></a></noscript>",
        "track_clicks": "true",
        "width": 300,
        "height": 250,
        "is_self_audited": "false",
        "content": "document.write('<scr' + 'ipt language=\\\"javascript\\\"src=\\\"https://track.adform.net/adfscript/?bn=2342059;click=${CLICK_URL}\\\"></scr' + 'ipt><noscript><a href=\\\"{CLICK_URL}https://track.adform.net/C/?bn=2342059;C=0\\\"  target=\\\"_blank\\\"><img  src=\\\"https://track.adform.net/adfserve/?bn=2342059;srctype=4;ord=${CACHEBUSTER}\\\"  border=\\\"0\\\"  width=\\\"300\\\"  height=\\\"250\\\"  alt=\\\"\\\"/></a></noscript>');",
        "template": {
            "id": "6"
        }
    }
}

$ curl -b cookies -c cookies -X POST -d @creative 'https://api.appnexus.com/creative?advertiser_id=1'

{
   "response": {
      "status": "OK",
      "id": 20,
      ...
      "template": {
          "id": 6,
          "name": "Standard"
      },
      "width": 300,
      "height": 250,
      "audit_status": "pending",
   }
}

Agregar una creatividad nativa

Este es el nuevo atributo nativo. Al agregar una creatividad nativa con el nuevo atributo, use el ID de plantilla 39461.

Paso 1: Cargue el recurso en el servicio de carga de creatividades.

curl -X POST -H 'Authorization:hbapi:21816:58f909dfa3405:nym2' --form "type=image" --form "file=@./NATIVE.JPG" 'https://api.appnexus.com/creative-upload?member_id=123'

El media_asset_id es devuelto.

{  
   "response": {  
      "status": "OK",
      "count": 0,
      "start_element": 0,
      "num_elements": 0,
      "dbg_info": {  
         "instance": "05.media-asset-pipeline.prod.nym2",
         "db":"",
         "warnings": [  
         ],
         "start_microtime": 1492716035.805,
         "time": 5,
         "version": "",
         "output_term": "media-asset"
      },
      "media-asset":[  
         {  
            "id": 1536691,
            "parent_media_asset_id": null,
            "member_id": 123,
            "advertiser_id": null,
            "publisher_id": null,
            "file_name": "NATIVE.JPG",
            "size_in_bytes": 79400,
            "cdn_uploaded_on": null,
            "cdn_url": "https://vcdn.adnxs.com/p/creative-image/1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
            "cdn_secure_url": "https://vcdn.adnxs.com/p/creative-image/1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
            "created_on": "2017-04-20 19:20:35",
            "last_modified": "2017-04-20 19:20:35",
            "deleted": false,
            "media_asset_status": [  
               {  
                  "id": 1536687,
                  "media_asset_id": 1536691,
                  "error_message": null,
                  "local_path": "1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
                  "cdn_upload_attempt_count": 0,
                  "created_on": "2017-04-20 19:20:35",
                  "last_modified": "2017-04-20 19:20:35",
                  "deleted": false,
                  "status": "on_shared_storage"
               }
            ],
            "media_asset_image": {  
               "id": 1005450,
               "media_asset_id": 1536691,
               "height": 480,
               "width": 640,
               "created_on": "2017-04-20 19:20:35",
               "last_activity": "2017-04-20 19:20:35",
               "deleted": false
-            },
            "media_asset_video": null,
            "media_asset_html5": null,
            "asset_type": "image",
            "mime_type": "image/jpeg"
         }
      ]
   }
}

Paso 2: Usa el media_asset_id para cargar el recurso creativo.

cat native
{
    "creative": {
        "name": null,
        "brand_id": 1,
        "media_url": "https://mediaurl.com",
        "code": "test",
        "code2": null,
        "member_id": 4,
        "state": "active",
        "advertiser_id": 7,
        "publisher_id": null,
    "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": "main_image",
                    "media_asset_id": 1536691,
                    "image_resize_setting": {
                        "resize_enabled": true,
                        "crop_enabled": true,
                        "aspect_ratio_upper_bound": 1.2,
                        "aspect_ratio_lower_bound": 0.8,
                        "max_scale_factor": 1.41
                    }
                }
            ],
            "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": "native"
    }
}
 

$ curl -b cookies -c cookies -X POST -d @native 'https://api.appnexus.com/creative/1751'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 411,
        "start_element": 0,
        "num_elements": 100,
        "dbg_info": {
            ...
            },
            "proxy": true
        },
        "creative": {
            "name": null,
            "brand_id": 1,
            "media_url": "https://mediaurl.com",
            "id": 411,
            "code": "test",
            "code2": null,
            "member_id": 4,
            "state": "active",
            "click_track_result": "not_tested",
            "advertiser_id": 3,
            "publisher_id": null,
            "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"
            },
            "pop_values": null,
            "brand": {
                "id": 1,
                "name": "Unknown",
                "category_id": null
            },
            "template": {
                "id": 39461,
                "name": "native ad",
                "media_subtype_id": 17,
                "format_id": 11
            },
            "ios_ssl_audit": null,
            "adx_audit": null,
            "thirdparty_page": 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": "main_image",
                        "media_asset_id": 1536691,
                        "creative_asset_image": {
                            "url": "http://url.com",
                            "url_secure": "https://secureurl.com",
                            "height": 12,
                            "width": 34
                        }
                        "image_resize_setting": {
                            "resize_enabled": true,
                            "crop_enabled": true,
                            "aspect_ratio_upper_bound": 1.2,
                            "aspect_ratio_lower_bound": 0.8,
                            "max_scale_factor": 1.41
                        }
                    }
                ],
                "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"
        }
    }
    }

Temas relacionados

• Servicio de carga creativa: formato de archivo
• Procedimientos recomendados de API
• Semántica de API