Servicio HTML creativo

Artículo
07/05/2024

Puede usar el servicio HTML creativo para agregar creatividades HTML5 a AppNexus. 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:

media_asset_id es necesario para cargar una creatividad HTML5 hospedada. Para obtener más información, consulte la sección Ejemplos a continuación.

Auditoría

AppNexus 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 o de vídeo).
AppNexus comprueba media_urls de forma periódica. Si un archivo desaparece, la creatividad se tratará como no auditada.
Una vez que una creatividad ha superado la auditoría de AppNexus, 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.
Para obtener más información sobre la auditoría, consulte Creative Standards and Auditing(Estándares creativos y auditoría).

API de REST

Http (método)	Endpoint	Description
`POST`	https://api.appnexus.com/creative-html?advertiser_id=ADVERTISER_ID (JSON creativo)	Agrega una nueva creatividad HTML5 hospedada a uno de tus anunciantes.
`POST`	https://api.appnexus.com/creative-html?publisher_id=PUBLISHER_ID (JSON creativo)	Agregue una nueva creatividad HTML5 a uno de los publicadores.
`PUT`	- https://api.appnexus.com/creative-html?id=CREATIVE_ID& advertiser_id=ADVERTISER_ID - https://api.appnexus.com/creative-html?id=CREATIVE_ID&p ublisher_id=PUBLISHER_ID	Modifique una creatividad HTML5 hospedada existente.
`GET`	https://api.appnexus.com/creative-html	Ver todas las creatividades HTML5 hospedadas.
`GET`	- https://api.appnexus.com/creative-html?advertiser_id=ADVERTISER_ID - https://api.appnexus.com/creative-html?advertiser_code=ADVERTISER_CODE - https://api.appnexus.com/creative-html?publisher_id=PUBLISHER_ID - https://api.appnexus.com/creative-html?publisher_code=PUBLISHER_CODE	Ver todas las creatividades HTML5 hospedadas para 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-html?id=CREATIVE_ID - https://api.appnexus.com/creative-html?code=CREATIVE_CODE	Ver una creatividad específica.
`GET`	https://api.appnexus.com/creative-html?id=1,2,3	Vea varias creatividades por identificador mediante una lista separada por comas.
`GET`	https://api.appnexus.com/creative-html?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 AppNexus, Microsoft y Google. Para obtener el formato de respuesta, vea ejemplos a continuación.
`DELETE`	- https://api.appnexus.com/creative-html?id=CREATIVE_ID& advertiser_id=ADVERTISER_ID - https://api.appnexus.com/creative-html?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.

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.
`code2`	string (100)	Código personalizado adicional para la creatividad. Cada objeto de .`line_items`
`name`	string (100)	Nombre de la creatividad.
`type`	enumeración	Tipo de creatividad. Posibles valores: `"html"` 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.
`height`	Entero	Tamaño de la creatividad en altura.
`width`	Entero	Tamaño de la creatividad en ancho.
`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.
`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 AppNexus 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 de la consola. 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.
`template`	objeto	La plantilla creativa (ejemplo: `template_id` 6439) para el formato y el tipo de medio de la creatividad. La plantilla incluye código para controlar cómo se representa la creatividad en las páginas web. Posibles valores: - Html Multi Asset - Standard: 8606 - Html Multi Asset - Intersticial: 8607 - Html Multi Asset - Expandable: 8608 Obligatorio activado:`POST` Para obtener más información, vea Ejemplos a continuación.
`media_url`	string (1000)	La dirección URL de la creatividad : puede ser flash, HTML, javascript (ver formato). Obligatorio en:`POST` si no se usa contenido. Este campo solo se aplica a creatividades de terceros. Deje en blanco las creatividades HTML5.
`media_url_secure`	string (1000)	La dirección URL de la creatividad segura (HTTPS): puede ser flash, HTML, javascript (ver formato) para que se sirva en una llamada de anuncio segura. Este campo solo se aplica a creatividades de terceros. Deje en blanco las creatividades HTML5.
`click_url`	string (2000)	Dirección URL de la página de aterrizaje (opcional) para imágenes de terceros y creatividades flash. Nota: Este valor debe comenzar por "http://" o "https://" Obligatorio en:`POST`, si la plantilla es para el `"image"` formato .
`file_name`	string (1000)	Este campo no se aplica a las creatividades de vídeo hospedadas.
`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. 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. Predeterminado:`"pending"`
`audit_feedback`	string	El equipo de auditoría creativa puede pasar mensajes sobre una creatividad en este campo. Solo lectura.
`allow_audit`	Booleano	Si `true`es , la creatividad se enviará para la auditoría. Si `false`es , 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 que se audite estas creatividades, debe actualizar las creatividades y establecerlas en `allow_audit` true. 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 no cumple 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". Valores permitidos: - `"disabled"` - `"pending"` - `"approved"` - `"failed"` Predeterminado:`"disabled"`
`allow_ssl_audit`	Booleano	Si `true`es , la creatividad se enviará para la auditoría segura (HTTPS). Si `false`es , no se enviará la creatividad. Si `true`es , `media_url_secure` o `content_secure` también es necesario. Predeterminado:`false`
`google_audit_status`	enumeración	Obsoleto. Vea `adx_audit` en su lugar.
`google_audit_feedback`	string	Obsoleto. Vea `adx_audit` en su lugar.
`msft_audit_status`	enumeración	Obsolescente.
`msft_audit_feedback`	string	Obsolescente.
`is_self_audited`	Booleano	Si `true`es , la creatividad se audita por sí misma y, por tanto, no pasará por la auditoría de la plataforma (AppNexus). 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, esto se establece en true para evitar que el creativo sirva. Predeterminado:`false` Solo lectura.
`is_hosted`	Booleano	Si `true`es , AppNexus 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 `true`es , 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	Si `true`es , el gasto por minuto está limitado a un máximo del 1 % del presupuesto de duración y del 5 % del presupuesto diario. Solo administrador.
`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.
`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. Para obtener más información, vea Test and Control Targeting(Destino de prueba y control). 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 y el ejemplo siguiente.
`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_modified`	Timestamp	Fecha y hora en que se modificó por última vez la creatividad. Solo lectura.
`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 y el ejemplo siguiente.
`adservers`	matriz de objetos	Los servidores de anuncios que entregan la creatividad o se llaman para la 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 y el ejemplo siguiente. 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 el Servicio de atributos técnicos y el ejemplo siguiente.
`language`	objeto	El lenguaje de la creatividad. Para recuperar una lista completa de idiomas, consulte language service y el ejemplo siguiente.
`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.
`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 producirán una auditoría de prioridad (cuando esté habilitada) y las tarifas resultantes. Si tiene un contrato de servicios complementarios con AppNexus para auditorías prioritarias, 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. Para obtener más información sobre la auditoría de prioridad, consulte Creative Standards and Auditing (Estándares creativos y auditoría).
`sla_eta`	Timestamp	Tiempo estimado de finalización de una auditoría de prioridad. Solo lectura.
`currency`	string	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. Solo lectura.
`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.
`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.
`adx_audit`	objeto	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. Solo lectura.
`member_id`	Entero	Identificador del miembro propietario de la creatividad.
`custom_macros`	matriz de objetos	Las creatividades HTML5 tendrán la `HTML5_INDEX_FILE` macro personalizada que establece la API.
`media_assets`	matriz de objetos	Se usa para asociar archivos hospedados de AppNexus a la creatividad. Este campo se rellenará automáticamente al cargar archivos a través de la API. Vea el ejemplo. Nota: `creative_field` siempre debe ser null para una creatividad HTML5.

`segments` ejemplo

"segments":[
{"id":11111,
"action":"add_on_view"
},
{"id":22222,
"action":"add_on_click"
}
]

`categories` ejemplo

"categories":[{"id":"13","name":"Online Games"}]

`adservers` ejemplo

"adservers":[{"id":"1","use_type":"adserver","name":"24/7 Real Media"}]

`technical_attributes` ejemplo

"technical_attributes":[{"id":"1","name":"Image"}]

`language` ejemplo

"language":{"id":"1","name":"English"}

`media_assets` ejemplo

"media_assets":[
{
"media_asset_id":22,
"creative_field":null
}
]

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 artículos de línea - ALI.

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`

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`

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"` Predeterminado:`true`
`hosted_assets_association_complete`	boolean/null	Estado de la creatividad cargada por los sistemas internos de AppNexus. Valores posibles: `"true"` o `"false"` para creatividades hospedadas y `"null"` para creatividades de terceros. Solo lectura.

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. Predeterminado: N/A Obligatorio activado: N/A
`name`	string	Nombre de la marca. Predeterminado: N/A Obligatorio activado: N/A

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. Predeterminado: N/A Obligatorio activado: N/A
`name`	string	Nombre de la categoría. Predeterminado: N/A Obligatorio activado: N/A

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.

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 `category_name` campo solo se devuelve cuando se encuentra `passshow_category_name=true` en la cadena de consulta de la llamada. Solo lectura.

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-html?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=true como 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-html?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-html?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-html?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-html?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-html?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-html?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00&max_last_run=2012-08-01 00:00:00'

Cambios que provocan una nueva auditoría

Una vez que una creatividad ha pasado la auditoría de AppNexus (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"):

media_url
click_url
language
categories
technical_attributes
brand_id
pixel_url
video_attribute
media_asset

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 AppNexus.

Ejemplos

Carga de una creatividad HTML5

Al cargar una creatividad para hospedar con AppNexus:

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

curl -X POST -H "Authorization: hbapi:139072:5761726637ada:nym2" --form "type=html" --form "file=@./AppNexus_30_1280_720_2500k.zip" "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,
        "media-asset": [
            {
                "id": 54621,
                "parent_media_asset_id": null,
                "member_id": 123,
                "advertiser_id": null,
                "publisher_id": null,
                "file_name": "AppNexus_30_1280_720_2500k.zip",
                "size_in_bytes": 8358845,
                "cdn_uploaded_on": null,
                "cdn_url": null,
                "cdn_secure_url": null,
                "created_on": "2016-06-15 15:33:17",
                "last_modified": "2016-06-15 15:33:17",
                "deleted": false,
                "media_asset_status": [
                    {
                        "id": 54621,
                        "media_asset_id": 54621,
                        "error_message": null,
                        "local_path": "03/36/2e/66/03362e66-674a-41b3-9477-fcd979cdbf0b/03362e66-674a-41b3-9477-fcd979cdbf0b.zip",
                        "cdn_upload_attempt_count": 0,
                        "created_on": "2016-06-15 15:33:17",
                        "last_modified": "2016-06-15 15:33:17",
                        "deleted": false,
                        "status": "on_shared_storage"
                    }
                ],
                "media_asset_video": null,
                "media_asset_html5": null,
                "asset_type": "html",
                "mime_type": "zip" 
            }
        ]
    }

Paso 2: Use para media_asset_id cargar la creatividad.

$ cat creative_html

{
    "creative-html": {
        "name": "upload_hosted_html5.zip",
        "template":{
            "id":8606
            },
        "media_assets": 
           [{
               "media_asset_id": 54621
            }
        ],
        "width":120
        "height":600
        "click_url": "https://appnexus.com",
        "advertiser_id": 164979,
        "segments": null,
        "allow_audit": true,
        "is_self_audited": false,
        "sla": 0
    }
}

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 12345678,
        "start_element": 0,
        "num_elements": 100,
        "creative-html": {
            "name": "upload_hosted_html5.zip",
            "brand_id": 1,
            "media_url": "http://appnexus.com",
            "id": 12345678,
            ...
            "track_clicks": true,
            "audit_status": "pending",
            ...
            "media_url_secure": "https://appnexus.com",
            ...
            "is_hosted": true,
            ...
            "language": {
                "id": 1,
                "name": "English"
            },
            ...
            },
            "template": {
                "id": 8606,
                "name": "HTML Multi Asset - Standard",
            },
            ...
            "media_assets": [
                {
                    "media_asset_id": 54621
                }
            ],
            ...
            "currency": "USD",
            "type": "html"
        },
        ...
    }
    }

Compartir a través de

Servicio HTML creativo

Auditoría

API de REST

Campos JSON

`segments` ejemplo

`categories` ejemplo

`adservers` ejemplo

`technical_attributes` ejemplo

`language` ejemplo

`media_assets` ejemplo

Elementos de línea

Campañas

Estado

Marcas competitivas

Categorías competitivas

Segmentos

Marca

Primera ejecución/última ejecución

Recuperar solo las creatividades que nunca han servido

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

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

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

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

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

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

Cambios que provocan una nueva auditoría

Ejemplos

Carga de una creatividad HTML5

Recursos adicionales

Compartir a través de

Servicio HTML creativo

Auditoría

API de REST

Campos JSON

segments ejemplo

categories ejemplo

adservers ejemplo

technical_attributes ejemplo

language ejemplo

media_assets ejemplo

Elementos de línea

Campañas

Estado

Marcas competitivas

Categorías competitivas

Segmentos

Marca

Primera ejecución/última ejecución

Recuperar solo las creatividades que nunca han servido

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

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

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

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

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

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

Cambios que provocan una nueva auditoría

Ejemplos

Carga de una creatividad HTML5

Temas relacionados

Recursos adicionales

`segments` ejemplo

`categories` ejemplo

`adservers` ejemplo

`technical_attributes` ejemplo

`language` ejemplo

`media_assets` ejemplo