Informe de revisión de marca del publicador
Este informe proporciona una vista del rendimiento de la marca en el inventario de un publicador específico. Este informe está disponible para los usuarios de red y publicador. Puede:
- Revise qué creatividad ha servido en el inventario en un publicador específico y cómo se ha realizado.
- Revise el rendimiento creativo por estado de auditoría.
Este informe requiere que se especifique un identificador de publicador como parte de la dirección URL de la siguiente manera:
https://api.appnexus.com/report?publisher_id=PUBLISHER_ID
El time_granularity valor de los datos es daily. Para obtener instrucciones sobre cómo recuperar un informe, consulte el servicio de informes o el ejemplo siguiente.
Período de tiempo
El report_interval campo de la solicitud JSON se puede establecer en uno de los siguientes:
- yesterday
- last_7_days
- last_30_days
- month_to_date
- last_month
Período de retención de datos
El período de retención de datos para este informe es de 428 días.
Nota:
Para ejecutar un informe para un período de tiempo personalizado, establezca los campos y end_date en la start_date solicitud de informe. Para obtener más información sobre estos campos, vea Report Service.
Dimensions
| Column | Tipo | ¿Filtro? | Ejemplo | Descripción |
|---|---|---|---|---|
month |
time | no | "2010-02" |
El mes de la subasta. |
day |
time | no | "2010-02-01" |
El día de la subasta. |
placement_id |
Entero | sí | 546 |
Identificador de la ubicación. |
placement_name |
string | no | "300x250 Business" |
Nombre de la ubicación. |
placement |
string | no | "300x250 Business (546)" |
En desuso (a partir del 17 de octubre de 2016). |
geo_country |
string | sí | "US" |
|
geo_country_name |
string | no | "United States" |
Nombre del país geográfico. |
imp_type |
string | sí | "Kept" |
Tipo de impresiones. Para obtener los valores posibles, vea imp_type_id. |
imp_type_id |
Entero | sí | 1 |
Identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis): - 1 ("En blanco"): sin creatividad.- 2 ("PSA"): un anuncio de servicio público se sirvió porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible.- 3 ("Error predeterminado"): una creatividad predeterminada que se sirve debido a un problema de tiempo de espera.- 4 ("Valor predeterminado"): una creatividad predeterminada que se sirve porque no había pujas válidas.- 5 ("Guardado"): la creatividad de su anunciante se ha servido en el sitio del editor.- 6 ("Reventa"): la impresión del editor se vendió a un comprador de terceros.- 7 ("RTB"): la creatividad de su anunciante se ha servido en el inventario de terceros.- 8 ("Error de PSA"): un anuncio de servicio público servido debido a un problema de tiempo de espera o a la falta de una creatividad predeterminada.- 9 ("Impresión externa"): una impresión de un rastreador de impresiones.- 10 ("Clic externo"): un clic de un rastreador de clics. |
creative_id |
Entero | sí | 654 |
Identificador de la creatividad. |
site_id |
Entero | sí | 555 |
Identificador del sitio. Para obtener más información, consulte El servicio de sitio. |
site_name |
string | no | "My Site" |
Nombre del sitio. Para obtener más información, consulte El servicio de sitio. |
brand_id |
Entero | sí | 3 |
Identificador de la marca asociada a una creatividad que se sirve en el inventario del publicador. |
brand_name |
string | no | "Ace Hardware" |
Nombre de la marca asociada a una creatividad que se sirve en el inventario del publicador. |
brand |
string | no | "Ace Hardware (3)" |
En desuso (a partir del 17 de octubre de 2016). |
width |
Entero | sí | 250 |
Ancho de la creatividad. |
height |
Entero | sí | 300 |
El alto de la creatividad. |
site |
string | no | "My Site (555)" |
En desuso (a partir del 17 de octubre de 2016). |
site_code |
string | no | "Site Name Code" |
Código personalizado para el sitio. |
placement_code |
string | no | "Photos Code" |
Código personalizado para la ubicación. |
media_type |
string | sí | "Banner", "Pop", "Interstitial", "Video", "Text" |
El estilo de visualización general de una creatividad que se sirve en el inventario del publicador. Puede usar el servicio de tipos de medios para ver la lista completa de tipos de medios. |
mediatype_id |
Entero | sí | 444 |
Identificador del tipo de medio asociado a la creatividad que se ha servido. Para obtener más información, vea El servicio de tipo multimedia. |
deal_id |
Entero | sí | 2345 |
El identificador de la transacción. Para obtener más información sobre las ofertas que ha negociado con los compradores, consulte Servicio de ofertas. |
deal_name |
string | no | "Private deal for buyer 1085 with floor of $2.50" |
Nombre de la oferta. |
deal |
string | no | "Private deal for buyer 1085 with floor of $2.50 (45)" |
En desuso (a partir del 17 de octubre de 2016). |
deal_code |
string | no | "Custom code" |
Código personalizado para la oferta. |
brand_offer_category_id |
Entero | sí | 1256 |
Identificador de la categoría de oferta de marca asociada a la impresión. Consulte category_id en la página Servicio de marca . |
brand_offer_category_name |
string | no | "Luxury Cars" |
Nombre de la categoría de oferta de marca asociada a la impresión. Consulte category_id en la página Servicio de marca . |
creative_audit_status_id |
Entero | sí | 0 |
Identificador del estado de auditoría de la creatividad asociada a la impresión: - 0 = sin auditoría- 1 = vendedor solo auditado- 2 = appnexus auditado |
creative_audit_status |
string | no | "Unaudited" |
Estado de auditoría de la creatividad asociada a la impresión: - "Unaudited"- "Self Audit Only"- "AppNexus Audited" |
size |
string | sí | "728x90" |
Ancho y alto de la creatividad asociada a la impresión. |
Métricas
| Column | Tipo | Ejemplo | Fórmula | Description |
|---|---|---|---|---|
imps |
Entero | 34534 |
Duendes | Número total de impresiones (incluidos los valores predeterminados). |
clicks |
Entero | 345 |
Clics | Número total de clics en todas las impresiones. |
total_convs |
Entero | 205 |
total_convs | Número total de conversiones de post view y post click. |
convs_rate |
double | 0.000856 |
total_convs/imps | Tasa de conversiones a impresiones. |
ctr |
double | 0.002327 |
clics o imps | Tasa de clics en impresiones. |
publisher_revenue |
Dinero | 400.05 |
publisher_revenue | Los ingresos pagados al publicador (en función de revshare o CPM). |
publisher_rpm |
Dinero | 1.71 |
(publisher_revenue/imps) x 1000 | Ingresos del publicador por cada 1000 impresiones. |
convs_per_mm |
double | 221.877080097625 |
(total_convs/imps) x 1000 000 | Número de conversiones por millón de impresiones. |
Ejemplos
Create la solicitud de informe JSON
El archivo JSON debe incluir el report_type de "publisher_brand_review", así como las columnas (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (, , ) y especificar en el "format" que se deben devolver los datos ("csv", "excel"o "html"). daymonthyear Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.
$ cat publisher_brand_review
{"report":
{
"format": "csv",
"report_interval": "yesterday",
"row_per": ["placement_id"],
"columns": ["placement_id","imp_type","creative_id","brand_id"],
"report_type": "publisher_brand_review"
}
}
POST la solicitud al servicio de informes
POST la solicitud JSON para recuperar un identificador de informe.
$ curl -b cookies -c cookies -X post -d @publisher_brand_review "https://api.appnexus.com/report?publisher_id=384186"
{
"response":{
"status":"OK",
"report_id":"97a181df6d77a8f3cd5a45eff4ea3dab"
}
}
GET estado del informe del servicio de informes
Realice una GET llamada con el identificador de informe para recuperar el estado del informe. Continúe realizando esta GET llamada hasta que execution_status sea "ready". A continuación, use el servicio de descarga de informes para guardar los datos del informe en un archivo, como se describe en el paso siguiente.
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=97a181df6d77a8f3cd5a45eff4ea3dab'
{
"response": {
"status": "OK",
"report": {
"name": null,
"created_on": "2014-11-19 21:57:00",
"json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"placement_id\"],\"columns\":[\"placement_id\",\"imp_type\",\"creative_id\",\"brand_id\"],\"report_type\":\"publisher_brand_review\",\"filters\":[{\"seller_member_id\":\"958\"},{\"publisher_id\":\"384186\"}]}}",
"url": "report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab"
},
"execution_status": "ready"
}
}
GET los datos del informe del servicio de descarga de informes
Para descargar los datos del informe en un archivo, realice otra GET llamada con el identificador de informe, pero esta vez al servicio de descarga de informes . Puede encontrar el identificador de servicio e informe en el url campo de la respuesta a la llamada anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo del formato de archivo que especificó en la inicial POST.
Nota:
Si se produce un error durante la descarga, el encabezado de respuesta incluirá un código de error HTTP y un mensaje. Use -i o -v en la llamada para exponer el encabezado de respuesta.
curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab' > /tmp/publisher_brand_review.csv
Nota:
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.