Servicio HTML creativo
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.
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).
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. |
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":[
{"id":11111,
"action":"add_on_view"
},
{"id":22222,
"action":"add_on_click"
}
]
"categories":[{"id":"13","name":"Online Games"}]
"adservers":[{"id":"1","use_type":"adserver","name":"24/7 Real Media"}]
"technical_attributes":[{"id":"1","name":"Image"}]
"language":{"id":"1","name":"English"}
"media_assets":[
{
"media_asset_id":22,
"creative_field":null
}
]
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 |
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 |
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. |
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 |
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 |
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. |
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. |
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:
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'
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'
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.
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"
},
...
}
}