Servicio HTML creativo

Puedes utilizar el servicio Creative HTML para añadir creatividades HTML5 a AppNexus. Todos los recursos creativos deben estar vinculados a un anunciante o editor.

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

Nota:

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

Nota:

A partir de septiembre de 2025: declara si tu anuncio es político y está destinado a publicarse en la UE a través de los is_political_and_eu_targeted campos y is_political_and_non_eu_targeted .

Auditoría

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

Las creatividades se identifican por su media_url (ya sea una URL del servidor de anuncios de terceros o una URL de red de entrega de contenido para un archivo Flash o de vídeo).
AppNexus media_urls comprueba periódicamente. Si un archivo desaparece, la creatividad se tratará como no auditada.
Una vez que una creatividad ha pasado la auditoría de AppNexus, ciertos cambios en la creatividad hacen que se vuelva a enviar para su auditoría. Para obtener más detalles, consulte Cambios que provocan una nueva auditoría a continuación.
Para obtener más información sobre la auditoría, consulte Normas creativas y auditoría.

API de REST

Método HTTP	Endpoint	Description
`POST`	https://api.appnexus.com/creative-html?advertiser_id=ADVERTISER_ID (JSON creativo)	Agregar un nuevo creativo HTML5 alojado a uno de sus anunciantes.
`POST`	https://api.appnexus.com/creative-html?publisher_id=PUBLISHER_ID (JSON creativo)	Añadir una nueva creatividad HTML5 a uno de sus editores.
`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	Modificar una creatividad HTML5 alojada existente.
`GET`	https://api.appnexus.com/creative-html	Ver todas las creatividades HTML5 alojadas.
`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 alojadas para un anunciante o editor. Nota: Puede filtrar los recursos creativos en función de cuándo se publicaron por primera vez y cuándo se publicaron por última vez. Esto es particularmente útil cuando se acerca al límite de su objeto y necesita identificar creatividades que se pueden eliminar del sistema. Para obtener más información, consulte Primera ejecución/Última ejecución a continuación.
`GET`	- https://api.appnexus.com/creative-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	Ver 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, consulte los siguientes ejemplos .
`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 un recurso creativo. Nota: No puede eliminar un recurso creativo que se utiliza como recurso creativo predeterminado para un miembro o ubicación. Las creatividades predeterminadas se pueden eliminar una vez que se desasocian de una ubicación.

Campos JSON

Campo	Tipo	Descripción
`id`	Entero	El identificador interno asociado a la creatividad. Valor predeterminado: Número generado automáticamente. Requerido el:`PUT`, en la cadena de consulta.
`code`	cadena (100)	El código personalizado del creativo.
`code2`	cadena (100)	El código personalizado adicional para la creatividad. Cada objeto del `line_items`archivo .
`name`	cadena (100)	El nombre del creativo.
`type`	enumeración	El tipo de creatividad. Posibles valores: `"html"` Nota: Aviso de alfa-beta: Este campo o característica forma parte de la funcionalidad que se encuentra 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 del creativo en ancho.
`advertiser_id`	Entero	El identificador del anunciante al que está adherida la creatividad. Requerido el:`POST`/`PUT`, en la cadena de consulta, si el creativo está adjunto a un anunciante.
`publisher_id`	Entero	El identificador del editor o la compra de medios a los que está adjuntada la creatividad. Requerido el:`POST`/`PUT`, en la cadena de consulta, si la creatividad está adjunta a un editor.
`brand_id`	Entero	El identificador de la marca de la empresa que anuncia el creativo. Si se incluye, será verificado por el equipo de auditoría de AppNexus. Si no se incluye, será asignado por el equipo de auditoría. Para obtener una lista completa de marcas, consulte el Servicio de marca.
`state`	enumeración	El estado de la creatividad. Valores posibles: `"active"` o `"inactive"`. Solo lectura.
`status`	objeto	El estado del creativo que describe si está listo para publicarse. Para obtener más información, consulte Estado a continuación.
`click_track_result`	enumeración	El resultado de la prueba de seguimiento de clics, una función solo disponible en la interfaz de usuario de la Consola. Valores posibles: `"not_tested"`, `"passed"`o `"failed"`. Valor predeterminado:`"not_tested"`
`campaigns`	matriz de objetos	La lista de campañas a las que está asociada la creatividad. Para obtener más información, consulta Campañas a continuación. Nota: Este campo solo se devolverá si se especifica an `advertiser_id` en 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 renderiza la creatividad en las páginas web. Posibles valores: - Multiactivo HTML - Standard: 8606 - Multiactivo HTML - Intersticial: 8607 - Multiactivo HTML - Expandible: 8608 Requerido en:`POST` Para obtener más información, consulte los siguientes ejemplos .
`media_url`	string (1000)	La URL de la creatividad: puede ser flash, HTML, javascript (ver formato). Requerido en:`POST`, si no usa contenido. Este campo solo se aplica a creatividades de terceros. Déjelo en blanco para las creatividades HTML5.
`media_url_secure`	string (1000)	La dirección URL de la creatividad segura (HTTPS): puede ser flash, HTML o javascript (ver formato) para que se publique en una llamada publicitaria segura. Este campo solo se aplica a creatividades de terceros. Déjelo en blanco para las creatividades HTML5.
`click_url`	string (2000)	La URL de la página de destino (opcional) para creatividades de imagen y flash que no son de terceros. Nota: Este valor debe comenzar por "http://" o "https://" Requerido 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	El estado de auditoría de la creatividad. Valores posibles: `"no_audit"`, `"pending"`, `"rejected"`o `"audited"`. Nota: - Si `allow_audit` es falso, este campo debe ser `"no_audit"`. - Si una creatividad ha caducado, puedes reanimarla cambiando este campo. Al establecerla, se volverá a `"pending"` enviar para su auditoría. En el caso de los cambios que vuelven a enviar automáticamente la creatividad para su auditoría, consulte Cambios que provocan una nueva auditoría a continuación. Valor predeterminado:`"pending"`
`audit_feedback`	string	El equipo de auditoría creativa puede pasar mensajes sobre una creatividad en este campo. Solo lectura.
`allow_audit`	Booleano	Si `true`, la creatividad se enviará para auditoría. Si `false`, la creatividad no se enviará. Las creatividades no auditadas solo pueden ejecutarse en el inventario administrado de una red. Nota: - Si `audit_status` es `"no_audit"`, este campo debe ser "falso". - Si su miembro aún no está activo, puede agregar creatividades, pero no se enviarán para auditoría (`allow_audit` será falso). Una vez que se haya activado el miembro, si quieres que se auditen estas creatividades, debes actualizarlas y establecerlas `allow_audit` en true. Valor predeterminado:`true`
`ssl_status`	enumeración	El estado SSL (HTTPS) de la creatividad. Solo los creativos con ssl_status = aprobado podrán servir en el inventario seguro. Nota: Si una creatividad no supera la auditoría SSL de Sherlock, puede enviarla para una nueva prueba (una vez que haya corregido el contenido no seguro descendente) cambiando este campo a "pendiente". Valores permitidos: - `"disabled"` - `"pending"` - `"approved"` - `"failed"` Valor predeterminado:`"disabled"`
`allow_ssl_audit`	Booleano	Si `true`, la creatividad se enviará para una auditoría segura (HTTPS). Si `false`, la creatividad no se enviará. Si `true`, o `media_url_securecontent_secure` también es necesario. Valor 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	En desuso.
`msft_audit_feedback`	string	En desuso.
`is_self_audited`	Booleano	Si `true`, la creatividad se audita automáticamente y, por lo tanto, no pasará por la auditoría de plataforma (AppNexus). El creativo solo puede servir en el inventario que acepta tu creativo autoclasificado o en el inventario que acepta creativos no auditados. Valor predeterminado:`false`
`is_expired`	Booleano	Si el creativo (1) no se ha ejecutado y (2) no se ha modificado en 45 días, se marcará automáticamente como expirado y no aparecerá en ningún inventario. - Las creatividades expiradas deben volver a auditarse para ejecutarse en el inventario de terceros. Para anular la expiración de una creatividad para el inventario de terceros, establezca `audit_status` en `"pending"`. - No es necesario volver a auditar las creatividades caducadas para ejecutarse en inventario directo. Para anular la expiración de un recurso creativo para inventario directo, establezca `audit_status` en `"no_audit"`. Valor predeterminado:`false` Solo lectura.
`is_prohibited`	Booleano	Si Sherlock marca la creatividad por tener malware o por cargar dominios bloqueados, esto se establece como verdadero para evitar que la creatividad se publique. Valor predeterminado:`false` Solo lectura.
`is_hosted`	Booleano	Si `true`, la creatividad está hospedada por AppNexus. Solo lectura.
`lifetime_budget`	double	El presupuesto de por vida en dólares. Nota: Para incluir este campo en una `GET` respuesta, pase `attributes=1` la cadena de consulta. Valor predeterminado:`unlimited`
`lifetime_budget_imps`	Entero	El límite de por vida del número de impresiones. Nota: Para incluir este campo en una `GET` respuesta, pase `attributes=1` la cadena de consulta. Valor predeterminado:`unlimited`
`daily_budget`	double	El presupuesto diario en dólares. Nota: Para incluir este campo en una `GET` respuesta, pase `attributes=1` la cadena de consulta. Valor predeterminado:`unlimited`
`daily_budget_imps`	Entero	El límite diario para el número de impresiones. Nota: Para incluir este campo en una `GET` respuesta, pase `attributes=1` la cadena de consulta. Valor predeterminado:`unlimited`
`enable_pacing`	Booleano	Si `true`, el gasto diario presupuestado se distribuye uniformemente a lo largo de un día. Nota: Para incluir este campo en una `GET` respuesta, pase `attributes=1` la cadena de consulta. Valor predeterminado:`true`
`allow_safety_pacing`	Booleano	Si `true`, el gasto por minuto se limita a un máximo del 1 % del presupuesto de duración y el 5 % del presupuesto diario. Solo para Administración.
`profile_id`	Entero	Puede adjuntar segmentaciones como el género y la geografía a una creatividad creando un perfil y asociándolo aquí.
`folder`	objeto	Para organizar tus creatividades en carpetas para mayor comodidad (normalmente en la interfaz de usuario), deberás crear una carpeta utilizando el servicio de carpetas creativas y asociarla aquí mediante el ID de la carpeta o en el servicio de carpetas creativas mediante el ID de la creatividad. La salida es `{"id": "41", "name": "MyFolder"}`.
`line_items`	matriz de objetos	Las líneas de pedido asociadas a la creatividad. Para obtener más información, consulte las líneas de pedido a continuación.
`is_control`	Booleano	Esta es una marca que se utiliza para marcar esta creatividad como parte de un grupo de control/prueba en las pruebas A/B. Para obtener más información, consulte Segmentación de prueba y control. Valor predeterminado:`false`
`segments`	matriz	Una lista de segmentos a los que se agregará un usuario al ver o hacer clic en esta creatividad. Para obtener más información, consulte Segmentos y el ejemplo siguiente.
`created_on`	marca de tiempo	La fecha y hora en que se creó esta creatividad. Si se creó antes de enero de 2010, será cero. Solo lectura.
`last_modified`	marca de tiempo	La fecha y hora en que se modificó por última vez la creatividad. Solo lectura.
`categories`	matriz de objetos	Las categorías que describen el tipo de creatividad y oferta. Nota: Para incluir categorías en una `GET` respuesta, pase `attributes=1` la cadena de consulta. Para obtener una lista completa de categorías, consulte la categoría Servicio y el ejemplo siguiente.
`adservers`	matriz de objetos	Los servidores de anuncios que entregan la creatividad o a los que se llama con fines de recopilación de datos durante la entrega de la creatividad. Nota: Para incluir servidores de anuncios en una `GET` respuesta, pase `attributes=1` la cadena de consulta. Para obtener una lista completa de servidores de anuncios, consulta el Servicio de servidor de anuncios y el siguiente ejemplo . Solo lectura.
`technical_attributes`	matriz de objetos	Los atributos que describen las características técnicas de la creatividad, como `"Expandable"` o `"Video"`. Nota: Para incluir atributos técnicos en una `GET` respuesta, pase `attributes=1` la cadena de consulta. Para obtener una lista completa de atributos técnicos, consulte el servicio de atributos técnicos y el ejemplo siguiente.
`language`	objeto	El lenguaje de lo creativo. Para obtener una lista completa de idiomas, consulte el Servicio de idiomas y el siguiente ejemplo .
`brand`	objeto	La marca de la empresa que anuncia el creativo y la categoría asociada a la marca. Para obtener más detalles, consulte la marca a continuación. Solo lectura.
`sla`	Entero	Las creatividades establecidas en "0" se enviarán para auditoría con un SLA estándar. Precaución: Las creatividades enviadas con un número distinto de 0 darán como resultado una auditoría prioritaria (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 auditoría prioritaria (auditoría en un plazo de 2 horas durante el horario comercial) estableciendo este campo en 2. Para obtener más información sobre la auditoría prioritaria, consulte Normas creativas y auditoría.
`sla_eta`	marca de tiempo	El tiempo estimado de finalización de una auditoría prioritaria. Solo lectura.
`currency`	string	El código que define la moneda principal del anunciante (por ejemplo, USD). Para obtener más información sobre los tipos de moneda disponibles, consulte Servicio de divisas. Valor predeterminado: Moneda predeterminada del miembro. Solo lectura.
`first_run`	marca de tiempo	La fecha y hora en que se publicó por primera vez la creatividad, se actualizan cada hora. Este valor refleja la zona horaria UTC. Para incluir esta información en una `GET` respuesta, pase `flight_info=true` la cadena de consulta. Para obtener más información sobre cómo filtrar las creatividades en función de cuándo se publicaron por primera vez, consulta Primera ejecución/Última ejecución a continuación. Solo lectura.
`last_run`	marca de tiempo	La fecha y la hora en que se publicó por última vez la creatividad, que se actualizan cada hora. Este valor refleja la zona horaria UTC. Para incluir esta información en una `GET` respuesta, pase `flight_info=true` la cadena de consulta. Para obtener más información sobre cómo crear creatividades en función de cuándo se publicaron por última vez, consulta Primera ejecución/Última ejecución a continuación. Solo lectura.
`competitive_brands`	matriz de objetos	Los creativos asociados con las marcas de esta matriz no servirán juntos en `/mtj` las subastas. El ejemplo clásico de marcas competidoras es Coca-Cola vs. Pepsi. Consulte Marcas competitivas a continuación. Para obtener más información sobre las marcas de nuestro sistema, consulte el Servicio de marca.
`competitive_categories`	matriz de objetos	Las creatividades asociadas a las categorías de esta matriz no se publicarán juntas en `/mtj` las subastas, por ejemplo, "Citas" y "Educación". Consulte las categorías competitivas a continuación. Para obtener más información sobre las categorías que aplicamos a los creativos (y marcas), consulte la categoría Servicio.
`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 una creatividad ha sido aprobada o no se devuelve en el `audit_status` campo. Solo lectura.
`member_id`	Entero	El identificador del miembro propietario de la creatividad.
`custom_macros`	matriz de objetos	Las creatividades HTML5 tendrán la `HTML5_INDEX_FILE` macro personalizada establecida por la API.
`media_assets`	matriz de objetos	Se utiliza para asociar los archivos alojados de AppNexus a tu 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.
`is_political_and_eu_targeted`	Booleano	Establézcalo en true si el creativo contiene contenido político y tiene previsto ejecutarlo en la UE. El valor predeterminado asumido es false si no se envía el campo. NOTA: La publicidad política no es compatible en la UE.
`is_political_and_non_eu_targeted`	Booleano	Establézcalo en true si el creativo contiene contenido político y no tiene intención de ejecutarlo en la UE. El valor predeterminado asumido es false si no se envía el campo. NOTA: La publicidad política se admite en países que no pertenecen a la UE, solo para los clientes de Microsoft Monetize Adserver.

`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
}
]

Líneas de pedido

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

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

Campañas

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

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

Estado

Nombre	Tipo	Descripción
`user_ready`	booleano	El estado del conjunto de creatividades por parte del usuario, que describe si la creatividad está lista para publicarse o no. Posibles valores: `"true"` o `"false"` Valor predeterminado:`true`
`hosted_assets_association_complete`	Boolean o 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	El Id. de la marca. Valor predeterminado: No disponible Requerido en: No disponible
`name`	string	El nombre de la marca. Valor predeterminado: No disponible Requerido en: No disponible

Categorías competitivas

Nota:

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

Nombre	Tipo	Descripción
`id`	Entero	El identificador de la categoría. Valor predeterminado: No disponible Requerido en: No disponible
`name`	string	Nombre de la categoría. Valor predeterminado: No disponible Requerido en: No disponible

Segmentos

Estos campos se incluirán en la matriz Segments:

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

Marca

El brand objeto contiene los siguientes campos.

Nota:

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

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

Primera ejecución/última ejecución

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

Recuperar solo los recursos creativos que nunca se han publicado

Pase never_run=true la cadena de consulta.

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

Nota:

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

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

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

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

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

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

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

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

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

curl -b cookies -c cookies 'https://api.appnexus.com/creative-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 los creativos que se publicaron por última vez en una fecha específica o después de ella

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

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

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

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

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

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

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

curl -b cookies -c cookies 'https://api.appnexus.com/creative-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"), cambiar cualquiera de los siguientes campos hace que la creatividad se vuelva a enviar para la auditoría (allow_audit se establece en "pending"):

media_url
click_url
language
categories
technical_attributes
brand_id
pixel_url
video_attribute
media_asset

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

Ejemplos

Cargar una creatividad HTML5

Al cargar una creatividad para hospedarla con AppNexus:

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

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"

El media_asset_id es devuelto.

{
    "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 el media_asset_id para cargar el recurso creativo.

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

Last updated on 2026-08-18

Servicio HTML creativo

Auditoría

API de REST

Campos JSON

segments ejemplo

categories ejemplo

adservers ejemplo

technical_attributes ejemplo

language ejemplo

media_assets ejemplo

Líneas de pedido

Campañas

Estado

Marcas competitivas

Categorías competitivas

Segmentos

Marca

Primera ejecución/última ejecución

Recuperar solo los recursos creativos que nunca se han publicado

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

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

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

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

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

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

Cambios que provocan una nueva auditoría

Ejemplos

Cargar una creatividad HTML5

Temas relacionados

Recursos adicionales

`segments` ejemplo

`categories` ejemplo

`adservers` ejemplo

`technical_attributes` ejemplo

`language` ejemplo

`media_assets` ejemplo