Licitadores: servicio creativo
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/GIF).
- Comprobaremos media_urls de forma periódica. Si un archivo desaparece, la creatividad se tratará como no auditada.
- Se enviará una solicitud de notificación de auditoría al controlador de audit_notify_uri para cada creatividad cuyo estado de auditoría ha cambiado.
- La carga de malware o creativos engañosos o el etiquetado intencionado de creatividades está totalmente prohibido.
- Se recomienda encarecidamente configurar el miembro (consulte el Servicio para miembros) para recibir correos electrónicos cuando:
- La creatividad se audita (mediante la configuración del campo audit_notify_email en el servicio para miembros).
- El creativo ha sido examinado por Sherlock (mediante la configuración de la sherlock_notify_email en el Servicio para miembros).
Nota:
Directiva creativa expirada
Cuando una creatividad (1) no se ha ejecutado y (2) no se ha modificado durante 15 días consecutivos, se marcará automáticamente como expirada ("is_expired": true) y no servirá en ningún inventario. Las creatividades se reactivarán automáticamente si el licitador reanuda la puja con la creatividad.
Permisos:
- Solo el administrador puede cambiar el
audit_statuscampo. - Las creatividades que se modifiquen una vez auditadas volverán a un
pendingestado de auditoría.
API de REST
| Método HTTP | Punto final | Descripción |
|---|---|---|
| DELETE | https://api.adnxs.com/creative/MEMBER_ID?id=CREATIVE_ID | Eliminar una creatividad. |
| GET | https://api.adnxs.com/creative/MEMBER_ID https://api.adnxs.com/creative/MEMBER_ID?num_elements=X& start_element=Y&min_last_activity=Z&sort=id.asc |
Ver todas las creatividades de un miembro. Nota: Si tiene más de 100 creatividades para un miembro, use los parámetros num_elements y start_element descritos a continuación. Para ver un número específico y un intervalo de creatividades para un miembro. X es el número de elementos que se van a devolver. Debe ser 100 o inferior. Y es el primer elemento de los elementos X que se van a devolver. El primer elemento es 0. Si usa num_elements, también debe especificar el start_element. Para recuperar resultados paginados únicos, use el parámetro &sort=id.asc como se muestra a continuación. También puede especificar min_last_activity=Z como filtro. Z debe tener el formato YYYY-MM-DD. |
| GET | https://api.adnxs.com/creative/MEMBER_ID/CREATIVE_ID https://api.adnxs.com/creative?member_id=MEMBER_ID& id=CREATIVE_ID1,CREATIVE_ID2,CREATIVE_ID3https://api.adnxs.com/creative?member_id=MEMBER_ID& code=CODE | Ver una creatividad específica. |
| POST | https://api.adnxs.com/creative/MEMBER_ID (JSON creativo) | Agregue una nueva creatividad. |
| PUT | https://api.adnxs.com/creative-macro-check?include_tests=1 (replace_pattern_in_content_url JSON) | Modificar una creatividad existente. |
| PUT | https://api.adnxs.com/creative/MEMBER_ID/CREATIVE_ID (JSON creativo) https://api.adnxs.com/creative/MEMBER_ID?code=CODE |
Estructura JSON
| Campo | Establecer por | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
active |
interno | no | Booleano | Solo lectura. Estado actual de la creatividad. |
added_by_bidder |
interno | no | Entero | Identificador del pujador que agregó esta creatividad. |
adservers |
interno | no | matriz de objetos | Solo lectura. Los servidores de anuncios que entregan la creatividad o se llaman para fines de recopilación de datos durante la entrega de la creatividad. |
adx_audit |
interno | no | objeto |
Solo lectura. Este objeto contiene información sobre el estado y los comentarios relacionados con la auditoría de Google Ad Exchange de la creatividad. La información sobre si se ha aprobado o no una creatividad se devuelve en el audit_status campo. |
allow_audit |
cliente | no | Booleano | Establézcalo en true si desea optar por la creatividad en el proceso de auditoría. |
allow_ssl_audit |
cliente | no | Booleano | Si es true, la creatividad se enviará para la auditoría segura (https). Si es false, no se enviará la creatividad. Si es true, también se requiere media_url_secure o content_secure. Valor predeterminado: false |
audit_feedback |
interno | no | string | Si la creatividad ha producido un error en la auditoría creativa de Xandr, esto incluye el razonamiento del equipo de auditoría. |
audit_status |
equipo de auditoría y cliente | no | enum ('no_audit','pending','rejected','unauditable', 'audited') | Estado de la auditoría. El equipo de auditoría creativa de Xandr establece este campo. Una creatividad que no tenga audit_status "auditada" se puede volver a enviar para la auditoría estableciendo el audit_status de la creatividad en "pendiente". |
backup_upload_status |
En desuso. | |||
brand |
cliente | no | objeto | Contiene el identificador de la marca de la empresa que anuncia la creatividad, el nombre y el category_id. Se auditará. Sugerencia: Para devolver category_name también, pase show_category_name=true la cadena de consulta de la llamada. |
brand_id |
cliente | no | Entero | El identificador de la marca de la empresa que anuncia la creatividad. |
campaign |
cliente | no | string(50) | Nombre (opcional) de la campaña para esta creatividad, que se usa con fines de generación de informes y administración. |
categories |
equipo de auditoría | no | Lista de ints | Identificadores de categorías asociadas a la creatividad: consulte Servicio de categorías. Para GET, solo se devuelven si usa la marca attributes=true en la dirección URL de la solicitud. |
click_action |
no | no | string | 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, "hacer clic en web". Valor predeterminado: hacer clic en web |
click_target |
no | no | string | Destino del 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. |
click_trackers |
En desuso. | |||
click_url |
cliente | Sí (cuando creative.format es imagen) | string(1000) | No funciona para los clientes del Licitador. |
code |
cliente | no | string (100) | El código de miembro de la creatividad; se usa solo con fines de asignación de identificadores externos (consulte Respuesta de puja entrante de los licitadores). |
content |
cliente | no (si media_url existe) | text | El contenido javascript o html sin procesar de la creatividad utilizada en lugar de un media_url. |
content_secure |
cliente | no (si media_url_secure existe) | text | Contenido javascript o HTML cuando "format" es "raw-js" o "iframe-html" servido en una llamada de anuncio segura. |
created_on |
interno | no | Timestamp | Marca de tiempo cuando la creatividad se cargó originalmente en Xandr |
creative_upload_status |
En desuso. | |||
description |
no | string (400) | Descripción opcional asociada a la creatividad. | |
filter |
En desuso. | |||
flash_backup_url |
no | string | Copia de seguridad de creatividades de formato flash, que se proporcionará si el explorador del usuario no admite flash. | |
flash_click_variable |
cliente | no | string | Solo para creativos flash. No se habilita el POSTPUT intento de o en este campo para las creatividades que no son flash. Este es el nombre de la variable flash clickTAG en la que Xandr insertará una dirección URL de seguimiento de clics (si el seguimiento de clics está habilitado) que se seguirá cuando el usuario haga clic en la creatividad. Consulte la guía del diseñador de Adobe sobre cómo configurar un archivo Flash para usar la variable clickTAG. |
format |
En desuso. | |||
height |
cliente | sí | int | Alto de la creatividad en píxeles. |
id |
interno | Sí (al actualizar) | Entero | El identificador de la creatividad; solo se usa con fines de coincidencia interna. |
impression_trackers |
En desuso. | |||
is_expired |
interno | no | booleano | Indica si la creatividad se ha servido o modificado en los últimos 15 días. |
is_prohibited |
interno | no | booleano | True si el sistema de auditoría interna de Xandr ha detectado un comportamiento malintencionado al analizar la creatividad. Si es True, esta creatividad no será apta para servir. |
is_suspicious |
interno | no | booleano | True si el sistema de auditoría interna de Xandr ha detectado un comportamiento sospechoso al analizar la creatividad. Si es True, esta creatividad no será apta para servir. |
language_id |
equipo de auditoría | no | Entero | Identificador del idioma de la creatividad: consulte Servicio de lenguaje |
last_activity |
interno | no | Timestamp | Fecha y hora en que se modificó por última vez la creatividad. La zona horaria es UTC. Solo lectura. |
last_checked |
interno | no | Timestamp | Marca de tiempo en la que se ha comprobado por última vez la existencia de la dirección URL. |
media_subtypes |
En desuso. | |||
media_url |
cliente | no (si existe contenido) | string(1000) | La dirección URL de la creatividad: puede ser image, flash, html, javascript. La dirección URL debe existir y debe estar en una red CDN o equivalente. |
media_url_secure |
cliente | no (si content_secure existe) | string(1000) | La dirección URL de la creatividad segura (https): puede ser imagen, flash, HTML, javascript 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. |
member_id |
cliente | no | Entero | Identificador del miembro al que pertenece esta creatividad. Esto se especifica en el URI de la llamada API y no es necesario que también esté en json. |
mobile |
cliente | no | objeto | Información necesaria para que los creativos móviles pasen la auditoría creativa. Consulte Móvil a continuación. |
native |
En desuso. | |||
native_attribute |
cliente | Sí (obligatorio para anuncios nativos con la plantilla 39461) | objeto | Este es el 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. |
no_iframes |
En desuso. | |||
no_iframes |
En desuso. | |||
not_found |
interno | no | booleano | Cuántas veces no se pudo cargar la dirección URL. Después de un número determinado de comprobaciones, la creatividad se desactivará. |
original_content |
interno | no | string | Este campo es solo de referencia. Cuando se carga una etiqueta con contenido de terceros en Xandr, el contenido original cargado con la creatividad se almacenará en este campo. Valor predeterminado: Obligatorio en: POST al enviar como tipo raw-html. |
original_content_secure |
interno | no | string | Vea original_content. Esta es la versión segura de este contenido. |
passed_sherlock_audit |
interno | no | booleano | Indica si el sistema de auditoría creativa automatizada de Xandr ha comprobado recientemente la creatividad ("Sherlock"). |
pixel_type |
En desuso. Use el pixels campo en su lugar. |
|||
pixel_url |
En desuso. Use el pixels campo en su lugar. |
|||
pixel_url_secure |
En desuso. Use el pixels campo en su lugar. |
|||
pixels |
cliente | no | 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. Consulte Píxeles a continuación para obtener más detalles. |
placement |
cliente | no | string(50) | Nombre (opcional) de la ubicación de esta creatividad, que se usa con fines de generación de informes y administración. |
pop_values |
En desuso. | |||
segments |
cliente | no | 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. Ejemplo: "segments": [ { "id": 11111, "action": "add_on_view" }, { "id": 22222, "action": "add_on_click" } ] |
size_in_bytes |
interno | no | Entero | Tamaño del archivo multimedia en bytes. |
sla |
cliente | no | integer | Período de tiempo de destino al solicitar una auditoría de plataforma. Un valor de 0 es estándar, 2 es priority/rush. El valor predeterminado es 0. Nota: Al solicitar una auditoría estándar, la API rellenará este campo con un valor null. |
ssl_status |
equipo de auditoría | no | enum('disabled','pending','approved','failed') | 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 "pendiente". Valor predeterminado: "deshabilitado" |
state |
interno | no | enumeración | El estado de la creatividad. Los valores posibles son "active" o "inactive" |
status |
cliente | no | objeto | Estado de la creatividad que describe si la creatividad está lista para servir. Consulte Estado a continuación para obtener más información. |
technical_attributes |
equipo de auditoría | no | Lista de ints | Identificadores de atributos técnicos asociados a la creatividad: consulte Servicio de atributos técnicos. Para GET, solo se devuelven si usa la marca attributes=true en la dirección URL de la solicitud. |
template |
cliente | sí | objeto | La plantilla creativa (por ejemplo, template_id 6 ) 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. Advertencia: cuando se usa una plantilla para el formato "raw-html" (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 Predeterminado: POST |
text_description |
cliente | Sí, solo si el formato es texto | cadena de hasta 70 caracteres | La línea inferior de texto que se muestra en una creatividad de texto |
text_display_url |
cliente | Sí, solo si el formato es texto | cadena de hasta 35 caracteres | Dirección URL legible que se muestra en una creatividad de texto |
text_title |
cliente | Sí, solo si el formato es texto | cadena de hasta 25 caracteres | Línea superior de texto que se muestra en un creativo de texto |
track_clicks |
En desuso. | |||
track_clicks |
En desuso. | |||
video_attribute |
cliente | no | objeto | Atributos para creatividades de vídeo en streaming (VAST) de terceros. Consulte Atributo de vídeo a continuación para obtener más detalles. |
width |
cliente | sí | int | Ancho de la creatividad en píxeles. |
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. Advertencia: debe proporcionar una dirección URL auditable para que la creatividad pase la auditoría. |
Audio
| Campo | Tipo | Descripción |
|---|---|---|
click_target |
string | Destino del click_action, que es la acción que debe realizar el dispositivo cuando se hace clic en la creatividad. Escriba una dirección URL que nuestro equipo de auditoría pueda usar para comprobar la marca y los atributos de su creatividad de audio. Asegúrese de que el sitio al que apunta la dirección URL está en el mismo idioma que el audio. Esta dirección URL solo se usa con fines de auditoría. Advertencia: debe proporcionar una dirección URL auditable para que la creatividad pase la auditoría. |
Atributo Video
El identificador de plantilla para video_attribute es 6439 - Video: Standard VAST (también acepta VPAID) y el objeto incluye los campos siguientes:
Nota:
Audio El objeto de atributo de vídeo también se usa para crear creatividades de audio. El id. de plantilla para audio es 38745 - Xandr Audio Template (VAST). Se aceptan las direcciones URL XML y las direcciones URL de archivo de audio.
COMPROBACIÓN VASTA. Al agregar una creatividad de vídeo VAST o VPAID de terceros, se realizan una serie de comprobaciones en el XML. Hay diferentes salidas que puede ver y acciones correctivas que se pueden realizar. Consulte VAST Comprobar para obtener más información.
| Campo | Tipo | Descripción |
|---|---|---|
duration_ms |
double | Duración, en milisegundos, de la creatividad de vídeo en secuencia (VAST). Debe ser mayor que 0. |
is_skippable |
booleano | Si truees , se puede omitir la creatividad de vídeo en secuencia (VAST). Solo se admiten creatividades de vídeo VAST omitibles de terceros; por lo tanto, cuando is_skippable es true, is_hosted debe ser false. |
wrapper |
objeto | Contenedor de documentos VAST que contiene la elements matriz y la trackers matriz. |
Contenedor de atributos de vídeo
El wrapper objeto contiene los campos siguientes:
| Campo | Tipo | Descripción |
|---|---|---|
elements |
matriz | Elementos del contenedor VAST. |
secure_url |
string | Dirección URL segura del documento VAST. |
url |
string | Dirección URL del documento VAST. |
Elemento contenedor de atributos de vídeo
La elements matriz contiene los campos siguientes:
Se debe especificar al menos un elemento.
| Campo | Tipo | Descripción |
|---|---|---|
trackers |
matriz | Seguimientos de eventos VAST. |
type |
string | Solo lectura. Tipo de elemento. Valor posible: "lineal" |
vast_element_type_id |
Entero | Id. de elemento VAST. Valor posible: 1: lineal |
Seguimientos de eventos de atributos de vídeo
Puede colocar píxeles en cada evento del que realicemos el seguimiento en los informes (consulte vast_event_type_id a continuación). Agregue los píxeles como trackers en la creatividad. La trackers matriz contiene los campos siguientes:
| Campo | Tipo | Descripción |
|---|---|---|
event_type |
string | Solo lectura. Tipo de evento correspondiente a vast_event_type_id. |
is_segment_pixel |
booleano | Define el píxel como un píxel de segmento y garantiza que el id. de usuario para ese evento se agrega al segmento independientemente del tipo de dispositivo. Valor predeterminado = false. Si se establece en true, la dirección URL debe configurarse en el formato estándar: https://ib.adnxs.com/seg?add=segmentID, de lo contrario, recibirá un error. |
name |
string | Nombre del seguimiento de eventos. |
secure_url |
string | Dirección URL segura del seguimiento de eventos. |
url |
string | Dirección URL del seguimiento de eventos. |
vast_event_type_id |
Entero | Identificador del evento VAST. Posibles valores: - 1: servicio - 2: inicio - 3: omitir - 4: error - 5: first_quartile - 6: punto medio - 7 : third_quartile - 8: finalización - 9: impresión - 10: haga clic en |
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. |
Estos son los identificadores de plantilla estándar para los formatos creativos más comunes.
| Id. | Formato | Nombre |
|---|---|---|
1 |
url-html | Banner estándar |
2 |
url-js | Banner estándar |
3 |
flash | Banner estándar |
4 |
imagen | Banner estándar |
5 |
raw-js | Banner estándar |
6 |
raw-html | Banner estándar |
7 |
iframe-html | Banner estándar |
8 |
url-xml | vídeo de In-Banner |
9 |
url-html | Elemento emergente |
10 |
url-js | Elemento emergente |
11 |
flash | Elemento emergente |
12 |
imagen | Elemento emergente |
13 |
raw-js | Elemento emergente |
14 |
raw-html | Elemento emergente |
15 |
iframe-html | Elemento emergente |
6439 |
VAST, VPAID | ESTÁNDAR VAST |
Para ver las creatividades expansibles, consulte la página Expandables and Rich Media para obtener más detalles.
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" Valor predeterminado: true |
hosted_assets_association_complete |
boolean/null | Solo lectura. 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. |
Atributo nativo
El native_attribute objeto contiene los campos siguientes. Para obtener más información, vea Agregar una creatividad nativa en ejemplos .
| Campo | Tipo | Descripción |
|---|---|---|
data_assets |
matriz de objetos | Atributos de la creatividad nativa. Consulte Recursos de datos a continuación para obtener más detalles. |
image_assets |
matriz de objetos | Atributos de cada imagen individual. Consulte Recursos de imagen para obtener más detalles. |
image_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 imágenes a continuación. |
javascript_trackers |
matriz de objetos | Una lista de direcciones URL de seguimiento de impresiones de terceros. Para obtener más información, consulte Seguimientos de Javascript a continuación. Se admiten todas las macros OpenRTB y Xandr para este campo, excepto ${AUCTION_PRICE} y ${PRICE_PAID}. |
link |
objeto | Direcciones URL asociadas a la creatividad nativa. Consulte Vínculo a continuación para obtener más informació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 | Atributos de los recursos de vídeo. Consulte Recursos de vídeo para obtener más detalles. |
Nota:
Use image_trackers para los rastreadores de impresiones y link.trackers para los rastreadores de clics.
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 |
|---|---|---|
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. Debe ser una matriz de seguimientos de clics. Consulte Seguimientos a continuación para obtener más detalles. |
url |
string | Página de aterrizaje del creativo nativo. Obligatorio en : POST,PUT |
Nota:
De forma predeterminada, todas las creatividades nativas se envían para una auditoría segura.
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.
Seguidores
| Nombre | Tipo | Descripción |
|---|---|---|
url |
string | Dirección URL de seguimiento de impresiones de terceros. Esto debe contener el rastreador de impresiones. |
url_secure |
string | Dirección URL de seguimiento de impresiones de terceros (que usa SSL). Esto debe contener el rastreador de impresiones. |
Seguimientos de imágenes
| Nombre | Tipo | Descripción |
|---|---|---|
url |
string | Dirección URL de seguimiento de impresiones de terceros. Esto debe contener el rastreador de impresiones. |
url_secure |
string | Dirección URL de seguimiento de impresiones de terceros (que usa SSL). Esto debe contener el rastreador de impresiones. |
Seguimientos de Javascript
| 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) |
Recursos de datos
El data_assets objeto incluye los campos siguientes:
| Campo | Tipo | Descripción |
|---|---|---|
data_type |
string | Tipo de recurso para la creatividad nativa. Posibles valores: - sponsored_by -título -descripción -Clasificación - call_to_action - display_url -Le gusta -Descargas -precio - sale_price -Teléfono -dirección - additional_description |
value |
string | Descripción de que data_type asset ha especificado. - "sponsored_by": nombre de marca del patrocinador - "título": título de la creatividad - "description": descripción del producto o servicio que se anuncia - "rating": clasificación del producto que se ofrece - "call_to_action": acción sugerida para el paso siguiente - "display_url": la dirección URL que desea que se muestre - "Me gusta": me gusta en las redes sociales - "descargas": número de descargas e instalaciones de este producto - "price" - Price for product / app / in-app purchase - "sale_price": precio de venta que se puede usar junto con el precio para indicar un precio con descuento - "teléfono": número de teléfono "dirección": dirección - "additional_description": la versión más larga de la descripción del anuncio |
Recursos de imagen
El objeto image_assets incluye los campos siguientes:
| Campo | Tipo | Descripción |
|---|---|---|
creative_asset_image |
objeto | Objeto que contiene los detalles del recurso creativo. Necesario para creatividades nativas de terceros. Consulte los detalles de Creative Asset Image a continuación. |
image_type |
string | Formato de la imagen. Los valores posibles son: - icon_image - main_image |
Imagen de recurso creativo
| Campo | Tipo | Descripción |
|---|---|---|
height |
Entero | Alto de la imagen. El valor debe ser > 0 |
url |
string | Dirección URL de la imagen. |
url_secure |
string | Dirección URL segura de la imagen. |
width |
Entero | Ancho de la imagen. El valor debe ser > 0 |
Recursos de vídeo
El objeto video_assets incluye los campos siguientes:
| Campo | Tipo | Descripción |
|---|---|---|
video_creative_id |
Entero | El identificador creativo de Xandr del recurso de vídeo asociado a la creatividad nativa. Nota: Primero se debe registrar una creatividad de vídeo independiente antes de registrar una creatividad de vídeo nativa. |
Pixels
Esta matriz se usa para agregar hasta cinco píxeles personalizados y aprobados por Xandr a una creatividad.
Los píxeles aprobados por Xandr proceden de proveedores de confianza 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. Consulte el ejemplo "Agregar un píxel aprobado por Xandr a una creatividad" a continuación para obtener más instrucciones. Tenga en cuenta que puede usar el servicio de 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. Consulte el siguiente ejemplo agregar un píxel personalizado a una creatividad para obtener más instrucciones.
| Campo | Tipo | Descripción |
|---|---|---|
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. |
format |
enumeración | Formato del píxel. Valores posibles: "raw-js", "url-html", "url-js" o "url-image". |
id |
Entero | Solo lectura. Identificador del píxel. |
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](pixel-template-service .md). |
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. |
pixel_template_id |
Entero | Identificador del píxel aprobado por Xandr. Puede usar el servicio de plantilla de píxeles para obtener este identificador. |
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 Image para servir con la creatividad. |
Segmentos
Estos campos se incluirán en la matriz Segmentos:
| Campo | Tipo | Descripción |
|---|---|---|
action |
enumeración | Acción realizada por los usuarios que los agregarán al segmento. Valores posibles: "agregar en la vista" o "agregar al hacer clic". Obligatorio en: POST, PUT |
id |
Entero | Identificador del segmento. Obligatorio en: POST, PUT |
name |
string | Nombre del segmento. |
segment_id |
Entero | Identificador del segmento. Este campo contiene la misma información que el campo id. |
| Campo | Tipo | Descripción |
|---|---|---|
landing_page_url |
string | Dirección URL de la página de aterrizaje especificada por el administrador de Xandr durante el proceso de auditoría. Valor predeterminado: null |
thirdparty_campaign_id |
Entero |
Solo lectura. Si la campaña se ha sincronizado con un tercero, este es el identificador del sistema de terceros. Valor predeterminado: null |
thirdparty_creative_id |
Entero |
Solo lectura. Si la creatividad se ha sincronizado con un tercero como Yahoo Ad Exchange, este es el identificador del sistema de terceros. Si surge un problema con la sincronización, puede restablecer thirdparty_creative_id a null con la siguiente llamada PUT: $ curl -b cookies -c cookies -X PUT -d '{"creative":{}}' 'https://api.adnxs.com/creative/MEMBER_ID/CREATIVE_ID&reset_thirdparty_creative_id'Default: null |
Cambios que provocan Re-Audit
Una vez que una creatividad ha superado la auditoría Xandr (audit_status se "audita"), cambiar cualquiera de los campos siguientes hace que la creatividad se vuelva a enviar para la auditoría (allow_audit se establece en "pendiente"):
- width
- height
- contenido
- media_url
- click_url
- template
- custom_macros
- media_subtypes
- language
- categories
- technical_attributes
- brand_id
- pixel_url
- píxeles (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
Además, si el audit_status es "no_audit", cambiar allow_audit de "false" a "true" hace que la creatividad se vuelva a enviar para la auditoría Xandr.
Ejemplos
Adición de una creatividad
$ cat creative
{
"creative":
{ "width" : 300,
"height" : 250,
"media_url" : "https://ad.doubleclick.net/adi/ABC.Advertising.com/DEF.40;sz=300x250;click0=",
"template":{
"id": 1
}
}
}
$ curl -b cookies -c cookies -X POST -d @creative.json "https://api.adnxs.com/creative/5"
{
"response": {
"status": "OK",
"count": 1,
"id": 703355,
"creative": {
"id": 703355,
"active": true,
"member_id": 5,
"description": null,
"code": null,
"code2": null,
"media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
"audit_status": "pending",
"allow_audit": true,
"size_in_bytes": 0,
"last_checked": null,
"not_found": 0,
"added_by_bidder": null,
"campaign": null,
"placement": null,
"format": null,
"width": 300,
"height": 250,
"click_url": null,
"landing_page_url": null,
"flash_click_variable": null,
"no_iframes": false,
"content": null,
"original_content": null,
"track_clicks": true,
"audit_feedback": null,
"created_on": "2013-10-31 21:17:17",
"flash_backup_url": null,
"is_self_audited": false,
"file_name": null,
"is_prohibited": false,
"last_activity": "2013-10-31 21:17:17",
"passed_sherlock_audit": true,
"is_expired": false,
"creative_upload_status": null,
"backup_upload_status": null,
"filter": null,
"is_suspicious": false,
"suspicious_activity_timestamp": null,
"media_subtypes": [
"banner"
],
"no_adservers": false,
"is_blanking": false,
"is_rotating": false,
"text_title": null,
"text_description": null,
"text_display_url": null,
"click_action": "click-to-web",
"click_target": null,
"ssl_status": "disabled",
"allow_ssl_audit": false,
"media_url_secure": null,
"content_secure": null,
"original_content_secure": null,
"flash_backup_url_secure": null,
"is_hosted": false,
"content_source": "standard",
"thirdparty_creative_id": null,
"thirdparty_campaign_id": null,
"custom_request_template": null,
"brand": {
"id": 1,
"name": "Unknown",
"category_id": 8
},
"language": {
"id": 1,
"name": "English"
},
"template": {
"id": 1
},
"segments": null,
"pixels": null,
"mobile": null,
"brand_id": 1,
"sla": "0",
"sla_eta": "2013-11-01 11:18:17"
}
}
}
Visualización de la creatividad que se agregó
$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
"response":{
"status":"OK",
"creative":{
"id": 6,
"active": true,
"member_id": 5,
"description": null,
"code": null,
"brand_id": 43,
"media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
"audit_status": "pending",
"allow_audit": true,
"size_in_bytes": 18467,
"last_checked": null,
"not_found": false,
"added_by_bidder": 14,
"campaign": null,
"placement": null,
"format": "url-html",
"width": 300,
"height": 250,
"click_url": "",
"flash_click_variable": null,
"pixel_url": "",
"no_iframes": false,
"content": null,
"original_content": null,
"track_clicks": true,
"pixel_type": "image",
"audit_feedback": null,
"created_on": "0000-00-00 00:00:00",
"flash_backup_url": null,
"is_self_audited": false,
"last_activity": "2008-08-26 05:41:04",
"passed_sherlock_audit": true,
"is_expired": false,
"creative_upload_status": null,
"backup_upload_status": null,
"filter": null,
"is_suspicious": false,
"suspicious_activity_timestamp": null,
"media_subtypes": [
"banner"
],
"no_adservers": false,
"is_blanking": false,
"is_rotating": false,
"text_title": null,
"text_description": null,
"text_display_url": null,
"click_action": "click-to-web",
"click_target": null,
"ssl_status": "disabled",
"allow_ssl_audit": false,
"media_url_secure": null,
"content_secure": null,
"original_content_secure": null,
"flash_backup_url_secure": null,
"is_hosted": false,
"content_source": "standard",
"thirdparty_creative_id": null,
"thirdparty_campaign_id": null,
"custom_request_template": null,
"brand": {
"id": 5,
"name": "Adobe",
"category_id": 27
},
"language": {
"id": 16,
"name": "Norwegian"
},
"template": {
"id": 1
},
"segments": null,
"pixels": null,
"mobile": null,
"brand_id": 5,
"sla": null,
"sla_eta": null
}
}
}
Modificación de una creatividad
Si decide agregar un nombre de campaña "Triple Play - Octubre de 2008" al creativo con fines de informes:
$ cat creative_mod
{"creative" : {
"campaign":"Triple Play - October 2008"
}
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
"response":{
"status":"OK",
"id":6
}}
Y, a continuación, para ver el cambio:
$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
"response": {
"creatives": [
{
"id": 6,
"active": true,
"member_id": 5,
"description": null,
"code": null,
"brand_id": 43,
"media_url": "https:\/\/ad.doubleclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
"audit_status": "pending",
"allow_audit": true,
"size_in_bytes": 18467,
"last_checked": null,
"not_found": 0,
"added_by_bidder": 14,
"campaign": "Triple Play - October 2008",
"placement": null,
"format": "url-html",
"width": 300,
"height": 250,
"click_url": "",
"flash_click_variable": null,
"pixel_url": "",
"no_iframes": false,
"content": null,
"original_content": null,
"track_clicks": true,
"pixel_type": "image",
"audit_feedback": null,
"created_on": "2008-08-26 05:41:04",
"flash_backup_url": null,
"last_activity": "2008-09-14 06:20:04"
}
],
"status": "OK"
}
}
Envío de una creatividad para auditoría
Si desea solicitar una auditoría para un creativo, debe estar activo y tener el allow_audit campo establecido en true:
$ cat creative_mod
{"creative" : {
"audit_status": "pending",
"allow_audit" : true
}
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
"response":{
"status":"OK",
"id":6
}}
Anular la ejecución de una creatividad y volver a enviarla para la auditoría
Si una creatividad ha expirado, puede actualizarla con esta configuración para establecer el estado en "pendiente" y volver a enviar la creatividad para la auditoría. Tenga en cuenta que a partir de noviembre de 2017, las creatividades que han expirado durante más de un año se eliminarán permanentemente. Consulte "Directiva creativa expirada" en la parte superior de esta página para obtener más información.
$ cat unexpire_creative
{
"creative": {
"audit_status": "pending",
"allow_audit": true,
"status": {
"user_ready": true
}
}
}
Envío de una creatividad móvil para auditoría
En este ejemplo se usa el nuevo mobile objeto :
$ cat mobile_creative
{
"creative" : {
"audit_status": "pending",
"allow_audit" : true,
"mobile" : {
"alternative_landing_page_url" : "https://..."
}
}
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
"response":{
"status":"OK",
"id":6
}
}
Envío de una creatividad para la auditoría de prioridad
Si desea enviar para una auditoría de prioridad. Establezca "sla" en 2 (actualmente no se usa un valor de 1). Se le cobrará una tarifa de auditoría prioritaria por su contrato.
$ cat creative_mod
{"creative" : {
"audit_status": "pending",
"sla": 2
}
}
$ curl -b cookies -c cookies -X PUT --data-binary @creative_mod 'https://api.adnxs.com/creative/5/6'
{
"response":{
"status":"OK",
"id":6
}}
Ver el tiempo de auditoría estimado para la creatividad ('sla_eta')
$ curl -b cookies -c cookies 'https://api.adnxs.com/creative/5/6'
{
"response": {
"creatives": [
{
"id": 6,
...
"audit_status": "pending",
"sla": 0,
"sla_eta": "2011-05-21 05:33:06"
}
],
"status": "OK"
}
}
Adición de una creatividad (etiqueta HTML de terceros)
$ cat creative
{
"creative":
{ "width" : 300,
"height" : 250,
"media_url" : "https://ad.doubleclick.net/adi/ABC.Advertising.com/DEF.40;sz=300x250;click0=",
"template":{
"id": 1
}
}
}
$ curl -b cookies -c cookies -X POST -d @creative.json 'https://api.sand-08.adnxs.net/creative?member_id=1282'
{
"response":{
"status":"OK",
"count":1,
"start_element":null,
"num_elements":null,
"id":816447,
"creative":{
"id":816447,
"active":true,
"member_id":1282,
"description":null,
"code":null,
"code2":null,
"media_url":"https:\/\/ad.dblclick.net\/adi\/ABC.Advertising.com\/DEF.40;sz=300x250;click0=",
"audit_status":"pending",
"allow_audit":true,
"size_in_bytes":0,
"last_checked":null,
"not_found":0,
"added_by_bidder":null,
"campaign":null,
"placement":null,
"format":null,
"width":300,
"height":250,
"click_url":null,
"landing_page_url":null,
"flash_click_variable":null,
"no_iframes":false,
"content":null,
"original_content":null,
"track_clicks":true,
"audit_feedback":null,
"created_on":"2014-01-24 16:02:31",
"flash_backup_url":null,
"is_self_audited":false,
"file_name":null,
"is_prohibited":false,
"last_activity":"2014-01-24 16:02:31",
"passed_sherlock_audit":true,
"is_expired":false,
"creative_upload_status":null,
"backup_upload_status":null,
"filter":null,
"is_suspicious":false,
"suspicious_activity_timestamp":null,
"media_subtypes":[
"banner"
],
"no_adservers":false,
"is_blanking":false,
"is_rotating":false,
"text_title":null,
"text_description":null,
"text_display_url":null,
"click_action":"click-to-web",
"click_target":null,
"ssl_status":"disabled",
"allow_ssl_audit":false,
"media_url_secure":null,
"content_secure":null,
"original_content_secure":null,
"flash_backup_url_secure":null,
"is_hosted":false,
"content_source":"standard",
"thirdparty_creative_id":null,
"thirdparty_campaign_id":null,
"custom_request_template":null,
"brand":{
"id":1,
"name":"Unknown",
"category_id":8
},
"language":{
"id":1,
"name":"English"
},
"template":{
"id":1
},
"segments":null,
"pixels":null,
"mobile":null,
"brand_id":1,
"sla":"0",
"sla_eta":"2014-01-27 00:03:31"
}
Adición de una creatividad iframe-html
El servicio creativo permite crear varios tipos diferentes de creatividades. Por ejemplo, para crear una creatividad con el formato "iframe-html", cargaría el html sin formato que se incrustará en un iframe en la página que sirve el anuncio.
$ cat iframe-html-creative
{
"creative" : {
"content":"<script type=\"text/javascript\" language=\"javascript\">
var sample_var = 350;
</script>
<script type=\"text/javascript\" language=\"javascript\" src=\"https://sample_source.com/sample_id?ord=${CACHEBUSTER}\"</script>",
"width":"300",
"height":"250",
"format":"iframe-html",
"brand_id" : 43
}
}
$ curl -b cookies -c cookies --data-binary @iframe-html-creative 'https://api.adnxs.com/creative/5'
{
"response":{
"status":"OK",
"id":7
}}
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.
En primer lugar, debe averiguar el pixel_template_id 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.adnxs.com/pixel-template'
{
"response": {
"status": "OK",
"count": 3,
"start_element": 0,
"num_elements": 100,
"pixel-templates": [
{
"id": 1,
"name": "Evidon AdChoices Icon",
"format": "raw-js",
"content": "(function() {document.write('<sc'+'ript type=\"text/javascript\"' + ((\"https:\"
== document.location.protocol) ? \"https://c.betrad.com\" : \"https://c.betrad.com\") +
'/surly.js?;ad_wxh=${CREATIVE_SIZE};coid=${P1};nid=${P2};${P3}\"></scr'+'ipt>');}());",
"num_required_params": 2,
"require_reaudit": false
},
{
"id": 2,
"name": "Brilig Impression Tracker",
"format": "url-image",
"num_required_params": 1,
"require_reaudit": false,
"url": "https://p.brilig.com/contact/bct?pid=${P1}&_ct=pixel&adid=${CP_ID}&action=1"
},
...
],
"dbg_info": {
...
}
}
}
El píxel Evidon AdChoices Icon es el primero 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.
A continuación, cree el archivo con formato JSON para agregar el píxel a la creatividad. En el archivo, establezca pixel_template_id en 2 y establezca param_1 y param_2 en los valores de {P1} y {P2} en el contenido del píxel.
Nota:
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": [
{
"pixel_template_id": 1,
"param_1":"12",
"param_2":"34"
}
]
}
}
Por último, realiza una llamada PUT 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. Tenga en cuenta que, dado que el píxel Evidon AdChoices Icon no hace que la creatividad requiera una nueva auditoría, audit_status no se ha revertido a "pendiente".
$ curl -b cookies -c cookies -X PUT -d @creative_update 'https://api.adnxs.com/creative/3/503577'
{
"response": {
"status": "OK",
"count": 1,
"id": "503577",
"start_element": 0,
"num_elements": 100,
"creative": {
"name": null,
"brand_id": 1,
"media_url": "https://creative.com/300x250",
"id": 503577,
"code": null,
"code2": null,
"state": "active",
"click_track_result": "not_tested",
"member_id": 3,
...
"audit_status": "audited",
...
"pixels": [
{
"id": 163,
"pixel_template_id": 1,
"param_1": "12",
"param_2": "34",
"param_3": null,
"param_4": null,
"param_5": null,
"format": "url-image",
"content": "(function() {document.write('<sc'+'ript type=\"text/javascript\"' +
((\"https:\" == document.location.protocol) ? \"https://c.betrad.com\" :
\"https://c.betrad.com\") + '/surly.js?;ad_wxh=${CREATIVE_SIZE};coid=12;nid=34;
\"></scr'+'ipt>');}());"
}
],
...
},
"dbg_info": {
...
}
}
}
Adición de un píxel personalizado a una creatividad
En este ejemplo, la solicitud PUT 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. Tenga en cuenta en la respuesta que audit_status está "pendiente"; Esto se debe a que la adición de un píxel personalizado a una creatividad hace que la creatividad se vuelva a enviar para la auditoría.
Nota:
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.adnxs.com/creative/3/503577'
{
"response": {
"status": "OK",
"count": 1,
"id": "503577",
"start_element": 0,
"num_elements": 100,
"creative": {
"name": null,
"brand_id": 1,
"media_url": "https://creative.com/300x250",
"id": 503577,
"code": null,
"code2": null,
"state": "active",
"click_track_result": "not_tested",
"member_id": 3,
...
"audit_status": "pending",
...
"pixels": [
{
"id": 196,
"pixel_template_id": null,
"param_1": null,
"param_2": null,
"param_3": null,
"param_4": null,
"param_5": null,
"format": "url-js",
"url": "https://50.16.221.228/render_js?cb=${CACHEBUSTER}&uid=${USER_ID}
&ref=${REFERER_URL}&campaign_id=147"
}
],
...
},
"dbg_info": {
...
}
}
}
Adición de una creatividad de vídeo con objeto y contenedor de atributos de vídeo
{
"creative": {
"id": 145,
...
"template_id": 6439,
"video_attribute": {
"is_skippable": true,
"duration_ms": 21000,
"wrapper": {
"url": "http://www.doubleclick.net/...",
"secure_url": "https://www.doubleclick.net/...",
"elements": [
{
"vast_element_type_id": 1,
"name": "linear",
"trackers": [
{
"name": "startTracker",
"vast_event_type_id": 2,
"url": "http://tracker.com/...",
"secure_url": "https://tracker.com/...",
"event_type": "start"
},
{
"name": "completionTracker",
"vast_event_type_id": 8,
"url": "http://tracker.com/...",
"secure_url": "https://tracker.com/...",
"event_type": "completion"
}
]
}
]
}
}
}
}
Adición de una creatividad nativa
Al agregar una creatividad nativa, use el identificador de plantilla 39461.
cat native
{
"creative": {
"description": "native_test",
"brand_id": 1,
"media_url": "https://mediaurl.com",
"code": "test",
"code2": null,
"member_id": 4,
"state": "active",
"template": {
"id": 39461
},
"native_attribute": {
"link": {
"url": "https://url.com",
"fallback_url": "https://fallback.com",
"trackers": [{
"url": "http://url.com",
"url_secure": "https://secureurl.com"
}]
},
"data_assets": [{
"data_type": "sponsored_by",
"value": "a value"
}, {
"data_type": "rating",
"value": "8"
}],
"image_assets": [{
"image_type": "icon_image",
"creative_asset_image": {
"url": "http://url.com",
"url_secure": "https://secureurl.com",
"height": 1,
"width": 1
}
}],
"image_trackers": [{
"url": "http://url.com",
"url_secure": "https://secureurl.com"
}],
"javascript_trackers": [{
"url": "http://url.com",
"url_secure": "https://secureurl.com"
}]
},
"thirdparty_viewability_providers": null,
"status": {
"user_ready": true
},
"sla_eta": null
}
}
$ curl -b cookies -c cookies -X POST -s @native 'https://api.adnxs.com/creative/4'
{
"response": {
"status": "OK",
"count": 1,
"id": 411,
"start_element": 0,
"num_elements": 100,
"dbg_info": {
...
},
"creative": {
"description": "native_test",
"brand_id": 1,
"media_url": "https://mediaurl.com",
"id": 411,
"code": "test",
"code2": null,
"member_id": 4,
"state": "active",
"click_track_result": "not_tested",
"format": "url-file",
"width": null,
"height": null,
"click_url": null,
"flash_click_variable": null,
"no_iframes": false,
"content": null,
"original_content": null,
"file_name": null,
"track_clicks": true,
"audit_status": "pending",
"macros": null,
"profile_id": null,
"audit_feedback": null,
"is_prohibited": false,
"is_suspicious": false,
"created_on": "2017-03-09 21:54:11",
"flash_backup_url": null,
"last_modified": "2017-03-09 21:54:11",
"is_control": false,
"allow_audit": true,
"is_expired": false,
"creative_upload_status": null,
"backup_upload_status": null,
"use_dynamic_click_url": false,
"media_subtypes": [
"popunder",
"popup",
"banner"
],
"size_in_bytes": 0,
"is_self_audited": false,
"no_adservers": false,
"text_title": null,
"text_description": null,
"text_display_url": null,
"click_action": "click-to-web",
"click_target": null,
"ssl_status": "pending",
"allow_ssl_audit": true,
"media_url_secure": "https://MEDIAURL.appnexus.com",
"content_secure": "document.write(\\\"\\\")",
"original_content_secure": null,
"flash_backup_url_secure": null,
"is_hosted": false,
"content_source": "standard",
"lifetime_budget": null,
"lifetime_budget_imps": null,
"daily_budget": null,
"daily_budget_imps": null,
"enable_pacing": null,
"allow_safety_pacing": null,
"landing_page_url": null,
"thirdparty_creative_id": null,
"thirdparty_campaign_id": null,
"facebook_audit_status": null,
"facebook_audit_feedback": null,
"custom_request_template": null,
"language": {
"id": 1,
"name": "English"
},
"brand": {
"id": 1,
"name": "Unknown",
"category_id": null
},
"template": {
"id": 329,
"name": "native ad",
"media_subtype_id": 17,
"format_id": 11
},
"ios_ssl_audit": null,
"adx_audit": null,
"custom_macros": null,
"segments": null,
"folder": null,
"campaigns": null,
"line_items": null,
"competitive_brands": null,
"competitive_categories": null,
"pixels": null,
"mobile": null,
"video_attribute": null,
"media_assets": null,
"sla": null,
"thirdparty_pixels": null,
"native": null,
"native_attribute": {
"link": {
"url": "https://url.com",
"fallback_url": "https://fallback.com",
"trackers": [{
"url": "http://url.com",
"url_secure": "https://secureurl.com"
}]
},
"data_assets": [{
"data_type": "sponsored_by",
"value": "a value"
}, {
"data_type": "rating",
"value": "8"
}],
"image_assets": [{
"image_type": "icon_image",
"creative_asset_image": {
"url": "https://vcdn.adnxs.com/sand/creative-image/ea/f5/30/28/eaf53028-e6c6-4ac0-bcbb-ce8fe14b73ab.png",
"url_secure": "https://secureurl.com",
"height": 12,
"width": 34
}
}],
"image_trackers": [{
"url": "http://url.com",
"url_secure": "https://secureurl.com"
}],
"javascript_trackers": [{
"url": "http://url.com",
"url_secure": "https://secureurl.com"
}]
},
"thirdparty_viewability_providers": null,
"status": {
"user_ready": true,
},
"sla_eta": null,
"currency": "USD",
"type": "standard"
}
}
}
Determinación de los atributos técnicos asignados a la creatividad
Aunque los atributos técnicos no son algo que se pueda agregar a los informes automatizados hoy en día, esto se puede recuperar a través del servicio Creative en la API del licitador. Para obtener más información, consulte el Servicio de atributos técnicos.
Para acceder a esto, agregue el parámetro de cadena de consulta "?attributes=true" como: "adnxs.com/creative/MEMBER_ID/CREATIVE_ID?attributes=true"
"technical_attributes": [
{
"id": 2,
"name": "Flash"
},
{
"id": 9,
"name": "Initial Load > 40kb"
},
{
"id": 13,
"name": "Banner has AdChoices Icon"
},
{
"id": 15,
"name": "Animated: 15 seconds or less"
}
]
Meta Service proporciona la información más actualizada sobre la interacción con objetos en nuestra API.
Macros creativas
El bus de impresiones admite dos tipos de macros creativas reemplazadas en tiempo real: macros Xandrcreative predefinidas y macros personalizadas que el licitador puede definir. La principal diferencia entre los dos es la perspectiva. Por ejemplo, el bus de impresiones no tiene conocimiento de una campaña o un pedido de inserción cuando se realiza una oferta en tiempo real, por lo que cualquier objeto compatible con el modelo de objetos interno de un licitador y necesario en una macro debe ser compatible con macros personalizadas.
Advertencia
Restricciones de macros
Solo se admiten macros Xandr predefinidas y macros personalizadas al registrar creatividades.
NO use macros de OpenRTB al registrar creatividades. Las macros de OpenRTB solo se usan en la respuesta de la puja.
No asigne un nombre a una macro personalizada que coincida con el nombre de una macro de OpenRTB.
Macros creativas de Xandr
Consulte Macros Xandr para obtener una lista completa de las macros creativas disponibles.
Haga clic en Ejemplo de seguimiento:
"media_url": "https://ad.doubleclick.net/adi/N5364.Ivillage.com/B2965815.5;sz=728x90;click0=${CLICK_URL};ord=${CACHEBUSTER}?"
Macros personalizadas
Con custom_macro funcionalidad en la respuesta de puja, puede pasar dinámicamente a las creatividades preinseradas. Por ejemplo, si quisiera devolver siempre una campaña determinada y un código de informes, podría configurar la creatividad de la siguiente manera:
{
"creative":{
"media_url":"https://adserver.com/imp?z=300x250;camp=${CAMPAIGN_ID};int=${INT_CODE}",
"format":"url-html",
"width":"300",
"height":"250"
}}
A continuación, cuando el licitador responde a una subasta, la respuesta de la oferta puede especificar el nombre y el valor de las macros que se van a reemplazar, incluyendo, por ejemplo:
"custom_macros":[
{
"name":"CAMPAIGN_ID",
"value":"452346"
},
{
"name":"INT_CODE",
"value":"a352-45we-sdr3"
}]
Nota:
Incluso si el valor es un entero, debe colocarse entre comillas (por ejemplo, "42").
<iframe src="https://adserver.com/sz=300x250;camp=452346;int=a352-45we-sdr3" width=300 height=250/>