API de plataforma digital: servicio creativo

Puede usar creative service para agregar creatividades a nuestro sistema. Todas las creatividades deben estar asociadas a un anunciante o editor.

• Puede ver su id. de anunciante llamando al Servicio de anunciantes.
• Puede ver el identificador del publicador llamando al servicio publisher.
• Puede adjuntar una creatividad a un publicador para usarla como creatividad predeterminada para una ubicación. A continuación, adjuntaría la creatividad a una ubicación a través de su identificador mediante el servicio de selección de ubicación.

Nota:

Solo se puede acceder a los servicios de audio y vídeo hospedados y de terceros mediante creative vast service. Solo se puede acceder a las creatividades HTML hospedadas y de terceros mediante el servicio HTML creativo.

Auditoría

Xandr trabaja con miembros que se preocupan profundamente por la marca y la reputación. Por esta razón, nos encargamos de asegurarnos de que los anuncios (creativos) 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 creative service.

• Las creatividades se identifican por su media_url (una dirección URL de adserver de terceros o una dirección URL de content delivery network para un archivo Flash, imagen o vídeo).
• Xandr comprueba media_urls periódicamente. Si un archivo desaparece, la creatividad se tratará como no auditada.
• Una vez que una creatividad ha superado la auditoría de Xandr, ciertos cambios en la creatividad hacen que se vuelva a enviar para la auditoría. Para obtener más información, vea Los cambios que provocan una nueva auditoría a continuación.

API de REST

Http (método)	Endpoint	Description
POST	https://api.appnexus.com/creative?advertiser_id=ADVERTISER_ID (JSON creativo)	Agrega una nueva creatividad a uno de tus anunciantes.
POST	https://api.appnexus.com/creative?publisher_id=PUBLISHER_ID (JSON creativo)	Agregue una nueva creatividad a uno de los publicadores.
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 todas las creatividades de un anunciante o editor. Nota: Puede filtrar las creatividades en función de cuándo se atienden por primera y última vez. Esto resulta especialmente útil cuando se está aproximando al límite de objetos y es necesario identificar las creatividades que se pueden eliminar del sistema. Para obtener más información, consulte Primera ejecución o ú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	Vea 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 una creatividad. Nota: No se puede eliminar una creatividad que se usa como la creatividad predeterminada para un miembro o ubicación. Las creatividades predeterminadas se pueden eliminar una vez que se desasocie de una ubicación.
GET	https://api.appnexus.com/creative/meta	Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Campo	Tipo	Descripción
id	Entero	Identificador interno asociado a la creatividad. Predeterminado: Número generado automáticamente. Obligatorio On:PUT, en la cadena de consulta.
code	string (100)	Código personalizado para la creatividad. Nota: Es importante que este código sea único.
code2	string (100)	Código personalizado adicional para la creatividad. Nota: Es importante que este código sea único.
name	string (400)	Nombre de la creatividad.
type	enumeración	Tipo de creatividad. Posibles valores: - "standard" "html" - "video" Nota: Aviso alfa-beta Este campo o característica forma parte de la funcionalidad actualmente en la fase Alfa o Beta. Por lo tanto, está sujeto a cambios. Solo lectura.
advertiser_id	Entero	Id. del anunciante al que se adjunta la creatividad. Obligatorio On:POST/PUT, en la cadena de consulta, si la creatividad está asociada a un anunciante.
political	objeto	Solo lectura. Si este creativo es "político" y servirá en estados Unidos, este objeto se rellena con los elementos necesarios para los creativos políticos estadounidenses. Para obtener más información, vea la descripción del objeto Político a continuación. Predeterminado:null
publisher_id	Entero	Identificador de la compra del publicador o medio al que se adjunta la creatividad. Obligatorio On:POST/PUT, en la cadena de consulta, si la creatividad está asociada a un publicador.
brand_id	Entero	El id. de la marca de la empresa que anuncia la creatividad. Si se incluye, el equipo de auditoría de Xandr lo comprobará. Si no se incluye, el equipo de auditoría lo asignará. Para recuperar 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	Estado de la creatividad que describe si la creatividad está lista para servir. Para obtener más información, consulte Estado a continuación.
click_track_result	enumeración	Resultado de la prueba de seguimiento de clics, una característica que solo está disponible en la interfaz de usuario. Valores posibles: "not_tested", "passed"o "failed". Predeterminado:"not_tested"
campaigns	matriz de objetos	Lista de campañas a las que está asociado el creativo. Para obtener más información, consulta Campañas a continuación. Nota: Este campo solo se devolverá si se especifica en advertiser_id la cadena de consulta.
format	enumeración	Obsolescente.
template	objeto	La plantilla creativa (por ejemplo, template_id6) para el formato y el tipo de medio de la creatividad (es decir, flash y ampliable). La plantilla incluye código para controlar cómo se representa 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 ser escaped (comillas, barras diagonales, etc.) y encapsularse en una document.write(); instrucción. Esto es necesario para entregar el contenido a la página. Obligatorio activado:POST
thirdparty_page	objeto	Nota: Este campo ya no está en uso.
custom_macros	matriz de objetos	Los valores de las macros personalizadas que se usan en la plantilla creativa. Para obtener más información, vea Macros personalizadas a continuación. Obligatorio en:POST, si la plantilla incluye macros personalizadas necesarias.
width	Int	Ancho de la creatividad; la cadena debe contener un valor int. Obligatorio en:POST, si la plantilla es para el "Banner" tipo de medio o "Expandable" .
height	Int	Obligatorio en:POST, si la plantilla es para el "Banner" tipo de medio o "Expandable" . El alto de la creatividad; la cadena debe contener un valor int. Si la plantilla de la creatividad tiene un tipo de medio Pop, los de la creatividad height deben establecerse o pop_window_maximize (en el pop_values campo) deben ser true (pero no ambos). Nota: Solo puede enviar creatividades pop de tamaños aceptados para la auditoría Xandr. Si media_subtype_id dentro de la template matriz es 4 (popunder) y audit_status es "pending", height debe establecerse en 300 y width en 720. Si media_subtype_id dentro de la template matriz es 2 (elemento emergente) y audit_status es "pending", width y height debe ser uno de los siguientes: 250x250, 300x250, 550x480. Obligatorio en:POST, si la plantilla es para el "Banner" tipo de medio o "Expandable" .
media_url	string (1000)	La dirección 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. Obligatorio en:POST si no se usa contenido.
media_url_secure	string (1000)	La dirección URL de la creatividad segura (HTTPS): puede ser imagen, flash, HTML, javascript (ver formato) que se va a servir en una llamada de anuncio 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://" Obligatorio en:POST si la plantilla es para el formato de "imagen".
file_name	string (1000)	Nombre de archivo y extensión de una creatividad hospedada. Tipos de archivo permitidos: jpg, gif, png, swf, flv, mp4, wmv, f4v, avi, m4v, mov y mpg. Obligatorio en:POST si se agrega una creatividad hospedada.
flash_click_variable	string (255)	Variable ClickTag en una creatividad flash. Xandr puede ejecutar y realizar un seguimiento de los clics del usuario en una creatividad flash solo si proporciona la variable exacta en el archivo (clickTAG, ClickTag, Clicktag, etc.). Puede usar el servicio ClickTags para identificar esta variable. Si necesita especificar más de una variable ClickTag para una única creatividad, póngase en contacto con el soporte técnico. Nota: Este campo solo se puede actualizar (a través POST de o PUT) para las creatividades flash.
content	string	Javascript o contenido HTML cuando "format" es "raw-js" o "iframe-html". Para una creatividad hospedada, el contenido del archivo debe estar codificado en base64 y enviarse como una cadena dentro del campo de contenido. Propina: Cuando se usa una plantilla (por ejemplo: template_id6) para el "raw-html" formato (HTML que no se servirá en un iFrame), todo lo que hay en el content campo debe ser escaped (comillas, barras diagonales, etc.) y encapsularse en una document.write(); instrucció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. Obligatorio on:POST, si no usa media_url. Valor predeterminado: soporte de etiqueta de terceros.
content_secure	string	Contenido de Javascript o HTML cuando "format" se proporciona o "iframe-html" se "raw-js" sirve en una llamada de anuncio segura.
original_content	string	El valor que pasa al "content" campo a través de la interfaz de usuario se devolverá sin cambios en este campo. 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). Obligatorio activado:POST al enviar 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	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 expirado, puede volver a crearla cambiando este campo. Si se establece en "pending" , se volverá a enviar para la auditoría. El campo user_ready también debe establecerse en true para reactivar una creatividad expirada. Para ver los cambios que reenvía automáticamente la creatividad para la auditoría, consulte Los cambios que provocan la nueva auditoría a continuación. - Solo puede enviar creatividades pop de tamaños aceptados para la auditoría Xandr. Si media_subtype_id dentro de la template matriz es 4 (popunder), audit_status no se puede establecer en a "pending" menos que width sea 720 y height sea 300. Si media_subtype_id dentro de la template matriz es 2 (elemento emergente), audit_status no se puede establecer en pendiente a menos que width y height sean uno de los siguientes: 250x250, 300x250, 550x480. 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 truees , la creatividad se enviará para la auditoría. Si falsees , no se enviará la creatividad. Las creatividades no auditadas solo se pueden ejecutar 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 la auditoría (allow_audit será false). Una vez que se ha activado el miembro, si desea auditar estas creatividades, debe actualizar las creatividades y establecer en allow_audittrue. - Solo puede enviar creatividades pop de tamaños aceptados para la auditoría Xandr. Si media_subtype_id dentro de la template matriz es 4 (popunder), allow_audit no se puede establecer en 1 a menos que width sea 720 y height sea 300. Si media_subtype_id dentro de la template matriz es 2 (elemento emergente), allow_audit no se puede establecer en 1 a menos que width y height sean uno de los siguientes: 250x250, 300x250, 550x480. Predeterminado:true
ssl_status	enumeración	Estado ssl (HTTPS) de la creatividad. Solo los creativos con ssl_status = aprobado serán aptos para servir en un inventario seguro. Nota: Si una creatividad produce un error en la auditoría de Ssl Sherlock, puede enviarla para una nueva prueba (una vez que haya corregido el contenido no seguro de bajada) cambiando este campo a "pending". Valores permitidos: - "disabled" - "pending" - "approved" - "failed" Predeterminado:"disabled"
allow_ssl_audit	Booleano	Si truees , la creatividad se enviará para la auditoría segura (HTTPS). Si falsees , no se enviará la creatividad. Si truees , media_url_secure o content_secure también es necesario. Valor predeterminado:true, si media_url_secure se proporciona o content_secure . De lo contrario, false será el valor predeterminado.
msft_audit_status	enumeración	Obsolescente.
msft_audit_feedback	string	Obsolescente.
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 truees , la creatividad se audita por sí misma y, por tanto, no pasará por la auditoría de la plataforma Xandr. La creatividad solo puede servir en el inventario que acepta su creatividad auto-clasificada o en el inventario que acepta creatividades no auditadas. Predeterminado:false
is_expired	Booleano	Si la creatividad (1) no se ha ejecutado y (2) no se ha modificado en 45 días, se marcará automáticamente como expirada y no servirá en ningún inventario. - Las creatividades expiradas se deben volver a auditar para ejecutarse en el inventario de terceros. Para anular la expresión de una creatividad para el inventario de terceros, establezca en audit_status"pending". - No es necesario volver a auditar las creatividades expiradas para ejecutarse en el inventario directo. Para anular la expresión de una creatividad para el inventario directo, establezca en audit_status"no_audit". Predeterminado:false Solo lectura.
is_prohibited	Booleano	Si Sherlock marca la creatividad para tener malware o cargar dominios bloqueados, se establece en true para evitar que el creativo sirva. Predeterminado:false Solo lectura.
is_hosted	Booleano	Si truees , Xandr hospeda la creatividad. Solo lectura.
lifetime_budget	double	El presupuesto de duración en dólares. Nota: Para incluir este campo en una GET respuesta, pase attributes=1 la cadena de consulta. Predeterminado:unlimited
lifetime_budget_imps	Entero	Límite de duración del número de impresiones. Nota: Para incluir este campo en una GET respuesta, pase attributes=1 la cadena de consulta. 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. Predeterminado:unlimited
daily_budget_imps	Entero	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. Predeterminado:unlimited
enable_pacing	Booleano	Si truees , el gasto presupuestado diario 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. Predeterminado:true
allow_safety_pacing	Booleano	Solo para administradores. Si truees , el gasto por minuto está limitado a un máximo del 1 % del presupuesto de duración y del 5 % del presupuesto diario.
profile_id	Entero	Puede asociar la segmentación como el sexo y la geografía a un creativo creando un perfil y asociándolo aquí.
folder	objeto	Para organizar las creatividades en carpetas para mayor comodidad (normalmente en la interfaz de usuario), creará una carpeta mediante el Servicio de carpetas creativas y, a continuación, la asociará aquí a través del identificador de carpeta o en el servicio carpeta creativa a través del identificador creativo. La salida es: {"id": "41", "name": "MyFolder"}
line_items	matriz de objetos	Los elementos de línea asociados a la creatividad. Para obtener más información, vea Elementos de línea a continuación.
pixels	matriz de objetos	Los píxeles que se van a servir con la creatividad. Pueden ser para el seguimiento de impresiones externas, el seguimiento de clics externos u otros fines, como agregar el icono de AdChoices a un creativo. Para obtener más información, consulte Píxeles a continuación.
pixel_url	string (100)	Obsoleto. En su lugar, use la matriz de píxeles. Dirección URL de un píxel de impresión que se va a servir con la dirección URL o el contenido multimedia.
pixel_url_secure	string (100)	Obsoleto. En su lugar, use la matriz de píxeles. Dirección URL de un píxel de impresión seguro (HTTPS) que se va a servir con el contenido de la dirección URL multimedia en una llamada de anuncio segura.
pixel_type	enumeración	Obsoleto. En su lugar, use la matriz de píxeles. 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 truees , el pujador no atenderá esta creatividad cuando se detecte un iframe en la llamada al anuncio. Predeterminado:false
track_clicks	Booleano	Obsolescente. Predeterminado:true
flash_backup_content	string	Para una creatividad flash, este es el contenido de la creatividad de copia de seguridad que se proporcionará si el explorador de un usuario no admite flash. Para un creativo de vídeo en banner, este es el contenido de la imagen de póster que se mostrará antes de que los usuarios haga 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 cargado el creativo de copia de seguridad, el contenido se almacenará en la red CDN y la ubicación se establecerá en el campo flash_backup_url. Ni flash_backup_content ni flash_backup_file_name se pueden recuperar en GET. Obligatorio en:POST/PUT, si se usa flash_backup_file_name. Escribir solo.
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 de la creatividad de copia de seguridad. Obligatorio en:POST/PUT, si se usa flash_backup_content. Escribir solo.
flash_backup_url	string (100)	Para una creatividad flash, esta es la dirección URL de una creatividad de terceros que se proporcionará si el explorador del usuario no admite flash. Para una creatividad de vídeo en banner, esta es la dirección URL de la imagen de póster que se mostrará antes de que los usuarios haga clic en reproducir y después de que el vídeo haya terminado de reproducirse.
is_control	Booleano	Se trata de una marca que se usa para marcar esta creatividad como parte de un grupo de control o prueba en las pruebas A/B. 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, vea Segmentos a continuación.
created_on	Timestamp	Fecha y hora en que se creó esta creatividad. Si se creó antes de enero de 2010, será cero. Solo lectura.
last_activity	Timestamp	Fecha y hora en que se modificó por última vez la creatividad. La zona horaria es UTC. Solo lectura.
media_subtypes	matriz de cadenas	Obsolescente.
creative_upload_status	enumeración	Obsolescente.
backup_upload_status	enumeración	Obsolescente.
use_dynamic_click_url	Booleano	Si truees , la dirección URL de la página de aterrizaje (opcional) de la imagen de terceros y las creatividades flash se establece en el nivel de campaña o de elemento de línea. Predeterminado:false
size_in_bytes	Entero	Tamaño de una creatividad cargada (en bytes). Solo lectura.
text_title	string (25)	Línea superior de texto que se muestra en una creatividad de texto. Obligatorio en:POST, si la plantilla es para el "text" formato .
text_description	string (70)	Línea inferior de texto que se muestra en una creatividad de texto. Obligatorio en:POST, si la plantilla es para el "text" formato .
text_display_url	string (35)	Dirección URL legible que se muestra en una creatividad de texto. Obligatorio en:POST, si la plantilla es para el "text" formato .
click_action	enumeración	Acción que el dispositivo debe realizar cuando se hace clic en la creatividad. Actualmente, este campo se establecerá en la única acción de clic admitida, "click-to-web". Predeterminado:"click-to-web"
click_target	string (2000)	Destino de click_action. Para hacer clic en web, este es el click_url elemento de la creatividad. click_url eventualmente quedará en desuso en favor de este campo. Mientras tanto, la configuración click_url o click_target tendrá el mismo efecto.
categories	matriz de objetos	Categorías que describen el tipo creativo y de oferta. Nota: Para incluir categorías en una GET respuesta, pase attributes=1 la cadena de consulta. Para recuperar una lista completa de categorías, consulte el Servicio de categorías.
adservers	matriz de objetos	Los servidores de anuncios que entregan la creatividad o se llaman para fines de recopilación de datos durante la entrega de la creatividad. Nota: Para incluir adservers en una GET respuesta, pase attributes=1 la cadena de consulta. Para recuperar una lista completa de servidores de anuncios, consulte El servicio de servidor de anuncios. Solo lectura.
technical_attributes	matriz de objetos	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 recuperar una lista completa de atributos técnicos, consulte servicio de atributos técnicos.
language	objeto	El lenguaje de la creatividad. Para recuperar una lista completa de idiomas, consulte Language Service.
brand	objeto	La marca de la empresa publicitando el creativo y la categoría asociada a la marca. Para obtener más información, consulte Marca a continuación. Solo lectura.
pop_values	matriz	Obsolescente.
sla	Entero	Las creatividades establecidas en 0 se enviarán para su auditoría con un acuerdo de nivel de servicio estándar. Cautela: Las creatividades enviadas con cualquier número distinto de 0 generarán una auditoría de prioridad (cuando esté habilitada) y las tarifas resultantes. Si tiene un contrato de servicios complementarios con Xandr para auditorías de prioridad, puede enviar una creatividad para la auditoría de prioridad (auditoría en un plazo de 2 horas durante el horario laboral) estableciendo este campo en 2.
sla_eta	Timestamp	Tiempo estimado de finalización de una auditoría de prioridad. Solo lectura.
currency	string	Solo lectura. 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. Predeterminado: Moneda predeterminada del miembro.
first_run	Timestamp	La fecha y hora en que la creatividad se sirvió por primera vez, actualizada 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 han servido por primera vez, consulte Primera ejecución o última ejecución a continuación. Solo lectura.
last_run	Timestamp	Fecha y hora en que la creatividad se sirvió por última vez, actualizada 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 sirvieron por última vez, consulte Primera ejecución o última ejecución a continuación. Solo lectura.
mobile	objeto	Información necesaria para que los creativos móviles pasen la auditoría creativa. Consulte Móvil a continuación.
video_attribute	objeto	Atributos de contenido en streaming (VAST) de terceros y creativos de vídeo hospedados. Nota: Para agregar & actualizar grandes creatividades, use el /creative-vast servicio. Para obtener más información, consulte Creative Vast Service. Predeterminado:null
stats	objeto	El stats objeto ha quedado en desuso (a partir del 17 de octubre de 2016). Use el servicio de informes para obtener información estadística en su lugar.
content_source	string	Origen del contenido de este creativo. Predeterminado:"standard" Valores permitidos: - "standard": esta creatividad consta de contenido hospedado en un servidor de anuncios, que generalmente se recuperará con una única solicitud HTTP. - "mediation": esta creatividad 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 la realización de varias solicitudes HTTP en secuencia. Para obtener más información, consulte El servicio de plantilla de solicitud personalizada creativa. 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 objeto múltiple debe definirse para la creatividad. - La custom_macros matriz debe rellenarse con macros definidas por los parámetros de plantilla asociados a la plantilla de solicitud personalizada. Los campos siguientes ya no serán necesarios: - content - media_url - template
custom_request_template	multiobjeto	Si el valor del campo de content_source esta creatividad está establecido en "mediation", este objeto describe la asociación entre esta creatividad y una plantilla de solicitud personalizada que se usa para rellenar la creatividad con contenido. Para obtener más información, vea Plantilla de solicitud personalizada. Predeterminado:null Obligatorio en:PUT, si content_source está establecido en "mediation".
competitive_brands	matriz de objetos	Los creativos asociados a las marcas de esta matriz no servirán juntos en /mtj subastas. El ejemplo clásico de marcas competidoras es Coca-Cola frente a 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	Los creativos asociados a las categorías de esta matriz no servirán juntos en /mtj subastas, por ejemplo, "Citas" y "Educación". Vea Categorías competitivas a continuación. Para obtener más información sobre las categorías que aplicamos a los creativos (y las marcas), consulte el Servicio de categorías.
thirdparty_pixels	matriz de objetos	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 Pixel de terceros o adjuntarlos individualmente en el nivel creativo mediante el Servicio Creativo. Predeterminado:null Obligatorio activado:PUT
native	objeto	Obsoleto. Si esta creatividad es un anuncio nativo, este objeto se rellena con los elementos necesarios para los anuncios nativos. Para obtener más información, vea la descripción del objeto Nativo a continuación. Predeterminado:null Obligatorio activado:POST y PUT para anuncios nativos. Técnicamente, nuestro sistema identifica los anuncios nativos como aquellos creativos que tienen un template objeto 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, vea la descripción del objeto Native Attribute a continuación. Predeterminado:null Obligatorio activado: Necesario para anuncios nativos con la plantilla 39461.
click_trackers	matriz de objetos	Una lista de direcciones URL de seguimiento de clics de terceros destinadas a usarse con creativos nativos. Para obtener más información, consulte Seguimientos de clics a continuación.
impression_trackers	matriz de objetos	Lista de direcciones URL de seguimiento de impresiones de terceros destinadas a usarse con creativos nativos. Para obtener más información, consulte 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 se ha aprobado o no una creatividad 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 de anuncio segura.
msft_external_audit_feedback	string	Obsolescente.
msft_external_audit_status	enumeración	Obsolescente.
member_id	Entero	Identificador del miembro propietario de la creatividad.
media_assets	matriz de objetos	El identificador de recurso del archivo original y un campo que describe para qué se debe usar el recurso. Se usa para asociar archivos hospedados de Xandr a la creatividad. Esta matriz se rellenará automáticamente al cargar archivos a través de la API. Para obtener más información, vea Recursos multimedia a continuación.
ad_type	string	Propina: Este campo solo se aplica cuando se asocian creatividades a elementos de línea aumentadas. Tipo de creatividad que se usa. Posibles valores: - banner - video (incluye tipos de audio) - native Este valor determina cómo se realiza el seguimiento de los elementos de la subasta para la estrategia de compra del artículo de línea, la estrategia de pago, las opciones de optimización, la asociación creativa y las opciones de selección de destino. Nota: Todas las creatividades asociadas a un elemento de línea deben tener el mismo tipo de anuncio, que debe coincidir con el ad_type seleccionado en line item service - ALI.

Marca

El brand objeto contiene los campos siguientes.

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 id. de la marca de la empresa que anuncia la creatividad. Solo lectura.
name	string	Nombre de la marca de la empresa que anuncia la creatividad. Solo lectura.
category_id	Entero	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 campos siguientes. Para obtener información sobre "id" campos o "code" , puede usar el Servicio de campaña.

Campo	Tipo (longitud)	Descripción
id	Entero	Identificador de la campaña. "code" O "id" es necesario al actualizar la asociación de campaña. Obligatorio activado:PUT
campaign_id	Entero	Identificador de la campaña.
creative_id	Entero	Identificador de la creatividad.
name	string	Nombre de la campaña. Solo lectura.
state	enumeración	Estado de la campaña. Valores posibles: "active", "inactive"o "parent_inactive". Solo lectura.
code	string	Código personalizado para la campaña. "code" O "id" es necesario al actualizar la asociación de elementos de línea. Obligatorio activado:PUT

Marcas competitivas

Nota:

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

Nombre	Tipo	Descripción
id	Entero	Identificador de la marca.
name	string	Nombre de la marca.

Categorías competitivas

Nota:

Para obtener más información sobre las categorías, vea el servicio category.

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

Plantilla creativa

Puede usar Creative Template Service para ver todas las plantillas de representación que se pueden asignar a las creatividades.

Campo	Tipo	Descripción
id	Entero	Identificador de la plantilla creativa.
name	string	Nombre de la plantilla creativa. Solo lectura.
media_subtype_id	Entero	Identificador del subtipo de medios asignado a la plantilla. Puede usar el servicio de subtipos multimedia para ver todos los subtipos multimedia admitidos. Solo lectura.
format_id	string	Nombre del formato asignado a la plantilla. Puede usar el servicio de formato creativo para ver todos los formatos admitidos. Solo lectura.

Plantillas creativas usadas con frecuencia

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

Id. de plantilla	Tipo creativo	Requisitos
1	Dirección URL única que apunta a un fragmento de código HTML.	Tendrá que pasar la dirección URL en el media_url campo y establecer un identificador de 1 en el objeto de plantilla.
2	Dirección URL única que apunta a un fragmento de código Javascript.	Tendrá que pasar la dirección URL en el media_url campo y establecer un identificador de 2 en el objeto de plantilla.
5	Creatividad que comienza y termina con componentes de Javascript, incluso si el código Javascript escribe HTML.	Tendrá que pasar el código Javascript en el content campo y establecer un identificador de 5 en el objeto de plantilla.
6	Creatividad que comienza y termina con componentes HTML, incluso si estos componentes HTML son <script> etiquetas.	Tendrá que pasar el código html en el content campo y establecer un identificador de 6 en el objeto de plantilla.

Macros personalizadas

Si la plantilla creativa proporciona valores predeterminados para una macro, pasar los códigos y valores aquí es opcional. Sin embargo, si la plantilla define una macro personalizada como necesaria, debe pasar el código y el valor de la macro.

Campo	Tipo	Descripción
code	string	Nombre exacto de la macro, tal como se usa en el código de la plantilla creativa, por ejemplo, "BORDER_COLOR".
value	string	Valor de la macro. Nota: Este valor debe coincidir con el tipo de la macro, tal como se define en la plantilla. Por ejemplo, si una macro es del tipo "integer", 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, vea el ejemplo Agregar una creatividad que usa 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 creativa asociada a esta creatividad, si está content_source establecida en "mediation". Para obtener más información, consulte El servicio de plantilla de solicitud personalizada creativa.
timeout_ms	Entero	Si se trata de una creatividad de "mediación", realizará al menos una solicitud HTTP a un servidor de anuncios externo, lo que a su vez puede realizar una o varias solicitudes adicionales. Este es el tiempo más allá del cual no esperaremos más a que esta creatividad se rellene con contenido. Para obtener más información, consulte El servicio de plantilla de solicitud personalizada creativa.
last_activity	Timestamp	Fecha y hora en que se modificó por última vez la creatividad. La zona horaria es UTC. Solo lectura.

Elementos de línea

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

Campo	Tipo (longitud)	Descripción
name	string	Nombre del elemento de línea. Solo lectura.
state	enumeración	El estado de la creatividad. Valores posibles: "active" o "inactive". Solo lectura.
id	Entero	Identificador del elemento de línea. "code" O "id" es necesario al actualizar la asociación de elementos de línea. Obligatorio activado:PUT
code	string	Código personalizado para el elemento de línea. "code" O "id" es necesario al actualizar la asociación de elementos de línea. Obligatorio activado:PUT

Recursos multimedia

La media_assets matriz de objetos contiene los campos siguientes:

Campo	Tipo	Descripción
media_asset_id	Entero	Identificador único del recurso creativo.
creative_field	string	Este campo indica para qué se debe usar ese recurso creativo determinado. Los valores válidos posibles son: - null (si el recurso 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 reglas siguientes:

• Cada valor de campo solo se puede usar 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 recurso, y solo uno.
• Todas las demás creatividades pueden tener 0 o más recursos 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	Dirección URL de página de aterrizaje alternativa que se puede ver en un explorador de escritorio para creativos que tienen una página de aterrizaje destinada a un dispositivo, sistema operativo o operador específicos. Debe proporcionar una dirección URL auditable para que la creatividad pase la auditoría.

Atributo nativo

El objeto native_attribute contiene los campos siguientes. Para obtener más información, vea 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 Vínculo a continuación.
image_trackers	matriz de objetos	Lista de direcciones URL de seguimiento de impresiones de terceros destinadas a usarse con creativos nativos.
javascript_trackers	matriz de objetos	Una lista de direcciones URL de seguimiento de impresiones de terceros.
data_assets	matriz de objetos	Atributos de la creatividad nativa. Para obtener más información, vea Recurso de datos a continuación.
image_assets	matriz de objetos	Atributos de cada imagen individual. Para obtener más información, vea 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 destino del comprador. Xandr no proporciona un vínculo de privacidad predeterminado.
video_assets	matriz de objetos	Lista de objetos video_asset. Para obtener más información, vea Recursos de vídeo a continuación.

Vínculo

El link objeto contiene la dirección URL de la página de aterrizaje, la dirección 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 campos siguientes:

Campo	Tipo	Descripción
url	string	Página de aterrizaje del creativo nativo. Obligatorio en:PUT , POST
fallback_url	string	Una dirección URL de copia de seguridad si no se admite la dirección URL de vínculo profundo principal.
trackers	matriz de objetos	Lista de direcciones URL de seguimiento de terceros destinadas a usarse con creativos nativos.

Todas las creatividades nativas se envían para la protección de forma predeterminada.

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

Seguimiento de vínculos

El link_tracker objeto incluye los campos siguientes:

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

Seguimiento de imágenes

El image_tracker objeto incluye los campos siguientes:

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

Seguimiento de Javascript

El javascript_tracker objeto incluye los campos siguientes:

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

Recurso de datos

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

Campo	Tipo	Descripción
data_type	string	Tipo de recurso 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	Contenido del data_type recurso especificado. Los valores posibles son: - title: título de la creatividad. - description: descripción del producto o servicio que se anuncia. - sponsored_by: nombre de marca del patrocinador. - call_to_action: acción sugerida para el siguiente paso. - display_url: la dirección URL que desea que se muestre. - price: precio para la compra de producto, aplicación o aplicación. - sale_price: precio de venta que se puede utilizar junto con el precio para indicar un precio con descuento. - rating: clasificación del producto que se ofrece. - likes: a las redes sociales les gusta. - downloads: número de descargas e 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 del 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 la acción necesaria después de ver la creatividad nativa (por ejemplo, firmar para la lista de correo). - custom_social_url_1 - custom_social_url_5: direcciones URL sociales que llevarán al usuario a las plataformas de medios 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 campos siguientes:

Campo	Tipo	Descripción
image_type	string	Formato de la imagen. Los valores posibles son: - main_image: imagen principal que aparecerá cuando se represente la creatividad nativa. - icon_image: icono principal que aparecerá cuando se represente 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 represente la creatividad nativa. - custom_social_icon_1 - custom_social_icon_5: iconos de redes sociales correspondientes que aparecerán cuando se represente la creatividad nativa.
media_asset_id	Entero	Identificador del recurso multimedia. Necesario para los creativos nativos hospedados. Si media_asset_id se puede recuperar, el creative_asset_image objeto se rellenará automáticamente.
creative_asset_image	objeto	Objeto que contiene los detalles del recurso creativo. Necesario para creatividades nativas de terceros. Para obtener más información, consulte Creative Asset Image a continuación.
image_resize_setting	objeto	Objeto que contiene la configuración de cambio de tamaño de imagen. Para obtener más información, vea Configuración de cambio de tamaño de imagen a continuación.

Imagen de recurso creativo

El creative_asset_image objeto incluye los campos siguientes:

Campo	Tipo	Descripción
url	string	Dirección URL de la página de aterrizaje de la imagen.
url_secure	string	Dirección URL de la página de aterrizaje 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 campos siguientes:

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	Relación de aspecto máxima permitida para la creatividad.
aspect_ratio_lower_bound	double	Relación de aspecto mínima permitida para la creatividad.
max_scale_factor	double	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 campos siguientes:

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

Solo uno de { media_asset_id , vast_url } debe rellenarse por solicitud.

Seguimiento vasto

El vast_tracker objeto incluye los campos siguientes:

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

Archivo multimedia

El media_file objeto incluye los campos siguientes:

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

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

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

Medios principales

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

Nota:

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

Valores de clave personalizados

Nombre	Tipo	Descripción
custom_key	string	Obsolescente.
custom_value	string	Obsolescente.

Seguimientos de clics

Nombre	Tipo	Descripción
click_tracker_url	string	Obsolescente.

Seguimientos de impresiones

Nombre	Tipo	Descripción
impression_tracker_url	string	Obsolescente.
impression_tracker_url_secure	string	Obsolescente.

Pixels

Esta matriz se usa 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 y de uso común. La mayoría de ellos no hacen que la creatividad se vuelva a enviar para la auditoría. Para agregar un píxel aprobado por Xandr a una creatividad, debe pasar solo el pixel_template_id y el número de parámetros que requiere el píxel. Para obtener más instrucciones, vea el ejemplo Agregar un píxel aprobado por Xandr a una creatividad en Ejemplos a continuación.

Nota:

Puede usar el servicio de plantilla de píxeles para obtener información sobre estos píxeles, incluido si desencadenan o no la nueva auditoría.

Los píxeles personalizados los define usted y hacen que la creatividad se vuelva a enviar para la auditoría. Para agregar un píxel personalizado, solo debe pasar el formato y, en función del formato, el contenido o la dirección URL. Para obtener más instrucciones, vea el ejemplo Agregar un píxel personalizado a un creativo en los ejemplos siguientes.

Precaución

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

Campo	Tipo	Descripción
id	Entero	Identificador asignado por Xandr de la matriz de píxeles. Asociará los píxeles a través de los pixel_template_idcampos , contento URL que se enumeran a continuación. Solo lectura.
pixel_template_id	Entero	Identificador del píxel aprobado por Xandr. Puede usar el servicio de plantilla de píxeles para obtener este identificador.
param_1	string	Para el píxel aprobado por Xandr: el valor del primer parámetro del contenido o la dirección URL del píxel. Para averiguar cuántos parámetros son necesarios para un píxel aprobado por Xandr, use el servicio de plantilla de píxeles.
param_2	string	Para píxeles aprobados por Xandr: el valor del segundo parámetro en el contenido o la dirección URL del píxel.
param_3	string	Para píxeles aprobados por Xandr: el valor del tercer parámetro en el contenido o la dirección URL del píxel.
param_4	string	Para el píxel aprobado por Xandr: el valor del cuarto parámetro en el contenido o la dirección URL del píxel.
param_5	string	Para el píxel aprobado por Xandr: el valor del quinto parámetro en el contenido o la dirección URL del píxel.
format	enumeración	Formato del píxel. Valores posibles: "raw-js", "url-html", "url-js"o "url-image".
content	string (255)	Si el formato de píxel es "raw-js", el contenido HTML o JavaScript que se va a servir con la creatividad.
secure_content	string (255)	Si el formato de píxel es "raw-js", el contenido HTML o JavaScript que se va a servir con la creatividad en una llamada de anuncio segura (HTTPS).
url	string (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 Imagen que se va a servir con la creatividad.
secure_url	string (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 Imagen para servir con la creatividad en una llamada segura (HTTPS).

Político

Objeto "political" utilizado para contener los campos siguientes:

Campo	Tipo	Descripción
in_scope	booleano	Determina si el creativo político estadounidense está en el ámbito para ser regulado. Si es así, toda la información necesaria del comprador político debe proporcionarse en el nivel de inserción. Para obtener más información, consulte la documentación Sobre la creación de un pedido de inserción a través de nuestra interfaz de usuario (es necesario iniciar sesión).

Valores emergentes

Nota:

Los pop_values campos están en desuso e ignorados o no los usan nuestros sistemas.

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

Campo	Tipo (longitud)	Descripción
pop_window_maximize	Booleano	Si truees , la etiqueta del publicador debe maximizar la ventana. Solo es relevante para creativos con formato "url-html" y "url-js". Si pop_window_maximize se establece en true, no se debe establecer ni "height" en "width" la creatividad. Predeterminado:false
pop_is_tag_initiated	Booleano	Si truees , la etiqueta de la creatividad iniciará el elemento emergente. Si falsees , el bus de impresiones iniciará el pop. Predeterminado:false
pop_window_title	string (255)	Título de la ventana emergente. Solo se aplica a elementos emergentes con pop_is_tag_initiated establecido en false. No se garantiza que se admita en todos los exploradores. Predeterminado:Network name
pop_statusbar	Booleano	Si truees , se muestra una barra de estado en la ventana emergente. Solo se aplica a elementos emergentes con pop_is_tag_initiated establecido en false. No se garantiza que se admita en todos los exploradores. Predeterminado:true
pop_menubar	Booleano	Si truees , se muestra una barra de menús en la ventana emergente. Solo se aplica a elementos emergentes con pop_is_tag_initiated establecido en false. No se garantiza que se admita en todos los exploradores. Predeterminado:true
pop_resizable	Booleano	Si truees , se puede volver a tamaño de la ventana emergente. Solo se aplica a elementos emergentes con pop_is_tag_initiated establecido en false. No se garantiza que se admita en todos los exploradores. Predeterminado:true
pop_scrollbars	Booleano	Si truees , las barras de desplazamiento se muestran en la ventana emergente. Solo se aplica a elementos emergentes con pop_is_tag_initiated establecido en false. No se garantiza que se admita en todos los exploradores. Predeterminado:true
pop_toolbar	Booleano	Si truees , se muestra una barra de herramientas en la ventana emergente. Solo se aplica a elementos emergentes con pop_is_tag_initiated establecido en false. No se garantiza que se admita en todos los exploradores. Predeterminado:true
pop_addressbar	Booleano	Si truees , se muestra una barra de direcciones en la ventana emergente. Solo se aplica a elementos emergentes con pop_is_tag_initiated establecido en false. No se garantiza que se admita en todos los exploradores. Predeterminado:true

Segmentos

Estos campos se incluirán en la matriz Segmentos:

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

Estado

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

Píxeles de terceros

La thirdparty_pixels matriz contiene los campos de la tabla siguiente. Estos campos, excepto para 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	Identificador del píxel. Obligatorio activado:PUT
name	string	Nombre completo del píxel. Solo lectura.
active	Booleano	Estado actual del píxel (true = 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, use el servicio Pixel de terceros.

Primera ejecución/última ejecución

Para incluir los first_run campos y last_run en una GET respuesta, pase flight_info=true la cadena de consulta. También puede filtrar las creatividades en función de cuándo se atienden por primera y última vez, como se indica a continuación:

Recuperar solo las creatividades que nunca han servido

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 usar never_run=true en combinación con otros filtros, pero tenga en cuenta que siempre será una relación OR. Por ejemplo, si pasa tanto never_run=truecomo min_first_run=2012-01-01 00:00:00 en la cadena de consulta, buscará creativos que nunca hayan servido elementos de línea OR que se hayan servido por primera vez en o después del 2012-01-01.

Recuperar solo las creatividades que se sirvieron por primera vez en o después de una fecha específica

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 las creatividades que se sirvieron por primera vez en o antes de una fecha específica

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 atienden 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 las creatividades que se sirvieron por última vez en o después de una fecha específica

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 sirvieron por última vez en o antes de una fecha específica

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 sirvieron por última vez dentro de 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). Use el servicio de informes para obtener información estadística en su lugar.

Cambios que provocan una nueva auditoría

Una vez que una creatividad ha pasado la auditoría de Xandr (audit_status es "audited"), el cambio de cualquiera de los campos siguientes hace que la creatividad se vuelva a enviar para la auditoría (allow_audit está establecida 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 es creativo de texto)
• text_description (si es creativo de texto)
• text_display_url (si es creativo de texto)
• pop_window_maximize (si pop creative)
• pop_is_tag_initiated (si pop creative y cambiar de false a true)
• video_attribute
• media_assets
• brand_url (no aplicable a los usuarios de API)
• alternative_landing_page_url
• native_attribute

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

Macros creativas

Xandr tiene predefinidas algunas macros que se pueden usar dentro de los campos , content, click_urly pixel_url de media_urlla 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.

Adición de una imagen de banner creativa (hospedada)

Al cargar una imagen de banner estándar creativa para hospedar con Xandr:

Una vez que se haya registrado la creatividad, el contenido se almacenará en la red CDN y se le proporcionará un media_url valor 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 desea que se audite la creatividad, debe incluirla allow_audit y establecerla falseen . Como alternativa, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla trueen .

$ 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"
   }
}

$ 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",
      ...
   }
}

Adición de una imagen de banner móvil creativa (hospedada)

Para que las creatividades móviles pasen la auditoría de la plataforma Xandr, debe pasar el mobile objeto con una dirección URL alternativa que se mostrará correctamente en un explorador 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": {
            ...
        }
    }
}

Adición de una creatividad flash de banner (hospedada)

Al cargar un banner estándar flash creative para hospedar con Xandr:

Una vez que se haya registrado la creatividad, el contenido se almacenará en la red CDN y se le proporcionará un media_url valor 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 desea que se audite la creatividad, debe incluirla allow_audit y establecerla falseen . Como alternativa, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla trueen .

$ 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",
      ...
   }
}

Adición de una creatividad flash de banner (dirección URL de terceros)

Al agregar una dirección URL de terceros para un banner flash creative:

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no desea que se audite la creatividad, debe incluirla allow_audit y establecerla falseen . Como alternativa, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla trueen .

$ 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",
      ...
   }
}

Agregar una creatividad ampliable MediaMind (dirección URL de terceros)

En este ejemplo, tenga en cuenta que el media_url campo proporciona la dirección URL de terceros para la creatividad ampliable y la matriz de plantillas especifica la plantilla 108, que es la plantilla estándar Xandr para las 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 desea que se audite la creatividad, debe incluirla allow_audit y establecerla falseen . Como alternativa, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla trueen .

$ 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",
      ...
   }
}

Adición de una creatividad ampliable de Pointroll (etiqueta HTML de terceros)

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

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no desea que se audite la creatividad, debe incluirla allow_audit y establecerla falseen . Como alternativa, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla trueen .

$ 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 una creatividad de imagen emergente (dirección URL de terceros)

En este ejemplo, tenga en cuenta que el media_url campo proporciona la dirección URL de terceros para la creatividad de imagen emergente y la matriz de plantillas especifica la plantilla 10, que es la plantilla de representación Xandr estándar para el "Popup" subtipo multimedia y el "url-js" formato. Si no especifica una plantilla en la solicitud, debe pasar el formato como "image" y media_subtype como "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",
      ...
   }
}

Agregar una creatividad de imagen emergente (dirección URL de terceros)

En este ejemplo, tenga en cuenta que el media_url campo proporciona la dirección URL de terceros para la creatividad de imagen emergente y la matriz de plantillas especifica la plantilla 17, que es la plantilla de representación Xandr estándar para el "Popunder" subtipo multimedia 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",
      ...
   }
}

Adición de un vídeo en banner (archivo de vídeo de terceros)

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

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no desea que se audite la creatividad, debe incluirla allow_audit y establecerla falseen . Como alternativa, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla trueen .

$ 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": {
            ... 
        }
    }
}

Adición de un vídeo en banner (archivo XML de terceros)

Al agregar un archivo XML en banner de terceros:

Auditoría: de forma predeterminada, Xandr enviará la creatividad para su auditoría. Si no desea que se audite la creatividad, debe incluirla allow_audit y establecerla falseen . Como alternativa, si desea auditar la creatividad usted mismo, debe incluirla is_self_audited y establecerla trueen .

$ 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 una creatividad que use una plantilla de representación personalizada

En este ejemplo, la POST solicitud agrega una creatividad de banner flash hospedado a Xandr. La creatividad usa una plantilla de creatividad personalizada, que está diseñada para representar la creatividad con un borde cuando se sirve. Las macros personalizadas de la plantilla permiten al tratante 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
         }
      ],
      ...
   }
}

Adición de una creatividad segura

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

Nota:

Puede comprobar el estado de auditoría ssl de una creatividad realizando una solicitud sencilla GET . El ssl_status campo de la respuesta indica el estado de auditoría. El creativo será apto para servir en un inventario seguro solo una vez que supere la auditoría y ssl_status sea "approved". Un creativo de terceros pasará la auditoría solo si todas las llamadas de la cadena de anuncios pasan por servidores seguros. Si la creatividad produce un error en 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",
      ...
   }
}

Envío de una creatividad para la auditoría de prioridad

Si tiene un contrato de servicios complementarios con Xandr para las auditorías de prioridad, puede enviar una creatividad para la auditoría de prioridad (auditoría en un plazo de 2 horas durante el horario laboral) estableciendo el sla campo en 2. El sla_eta campo de la respuesta proporcionará un tiempo de finalización estimado para 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",
      ...
   }
}

Cancelación de una auditoría creativa

Si ha enviado una creatividad para la audit_status auditoría de Xandr y es "pending", puede cancelar la auditoría y no cobrar la cuota de auditoría realizando una PUT solicitud con allow_audit establecido en false. 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",
      ...
   }
}

Visualización de estadísticas de auditoría para todas las creatividades

En este ejemplo, "audit_stats=true" se pasa en la cadena de consulta de la GET llamada. Esto 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": {
            ...
        }
    }
}

Adición de un píxel aprobado por Xandr a una creatividad

Este ejemplo le guiará por el proceso de agregar el píxel de icono de Evidon AdChoices aprobado por Xandr a un creativo.

1. En primer lugar, debe averiguar el pixel_template_id número y el número de parámetros que debe definir para el píxel. Use el servicio de plantilla 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 de la respuesta. Tenga en cuenta que el identificador es 1. También tiene en cuenta que num_required_params es 2. Esto significa que, al agregar el píxel a la creatividad, debe proporcionar valores para {P1} y {P2} en el contenido del píxel.

3. El archivo con formato JSON se crea para agregar el píxel a la creatividad. En el archivo, establezca pixel_template_id2en , y establezca param_1 y param_2 en los valores de {P1} y {P2} en el contenido del píxel.

   Precaución

   La matriz de píxeles se sobrescribirá por completo con el archivo 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 Creative Service.

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

4. Por último, realiza una PUT llamada para actualizar la creatividad. A continuación, la matriz de píxeles de la respuesta muestra que se ha agregado el píxel. Los dos parámetros se definen y se han rellenado en el contenido de píxeles.

   Nota:

   El píxel icono de AdChoices de Evidon 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": {
               ...
           }
       }
   }
   

Adición de un píxel personalizado a una creatividad

En este ejemplo, la PUT solicitud agrega un píxel url-js personalizado a la 503577 creativa. En el archivo con formato JSON, el formato se establece en "url-js"y la 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 que la adición de un píxel personalizado a una creatividad hace que audit_status la creatividad se vuelva a enviar para la auditoría.

Precaución

La matriz de píxeles se sobrescribirá por completo con la información de este archivo. Por lo tanto, si la creatividad ya incluye píxeles, asegúrese 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": {
            ...
        }
    }
}

Adición de un píxel de terceros a una creatividad

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

Nota:

En la respuesta que es "pending"; esto se debe a que la adición de un píxel de terceros a una creatividad hace que audit_status la creatividad se vuelva a enviar para la 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 una creatividad (etiqueta HTML de terceros)

Cuando el campo de formato se establece "raw-html"en , el contenido del content campo se debe encapsular en document.write() 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",
   }
}

Adición de una creatividad nativa

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

Paso 1: Cargar el recurso en el servicio de carga creativa.

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'

media_asset_id Se devuelve .

{  
   "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: Use para media_asset_id cargar la creatividad.

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