API de plataforma digital: Publisher Analytics
El informe de Publisher Analytics se puede usar para ver los datos de ingresos y ganancias en los sitios y ubicaciones de un publicador específico. Este informe está disponible para los usuarios de red y publicador.
Para obtener instrucciones sobre cómo recuperar un informe, consulte el Servicio de informes o los ejemplos siguientes. 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
Período de tiempo
El report_interval campo de la solicitud JSON se puede establecer en uno de los siguientes:
- current_hour
- last_hour
- hoy
- yesterday
- last_48_hours
- last_7_days
- last_30_days
- month_to_date
- month_to_yesterday
- quarter_to_date
- last_month
- Vida
Período de retención de datos
La mayoría de los datos de este informe se mantienen permanentemente (excepciones que se indican a continuación). Después:
- 100 días, ya no puede informar sobre los datos por hora. Sin embargo, los intervalos diarios, mensuales y acumulativos siguen estando disponibles.
- 14 meses, ya no puede informar sobre individuos:
- Creativos
- Colocaciones
- Marcas
En algunos casos, los informes de Analytics pueden mostrar una entrega que no coincide con los QuickStats de duración de un anunciante o publicador determinado. Esto se debe a la forma en que se agregan los datos de informes de Analytics anteriores a 100 días y 14 meses. Los datos de los informes de facturación se conservan de forma no agregada indefinidamente.
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 |
|---|---|---|---|---|
hour |
time | no | "2010-02-01 06:00:00" |
La hora de la subasta. Nota: En el caso de las impresiones anteriores a 100 días, el día se devolverá en lugar de la hora. |
day |
time | no | "2010-02-01" |
El día de la subasta. |
month |
time | no | "2010-02" |
El mes de la subasta. |
publisher_id |
Entero | sí | 923 |
Identificador del publicador. |
publisher_code |
string | no | "My Publisher Code" |
Código personalizado para el publicador. |
publisher_currency |
string | no | "USD" |
Moneda del publicador. |
pub_rule_id |
Entero | sí | 736 |
Identificador de la regla del publicador. |
pub_rule_name |
string | no | "My Publisher Rule" |
Nombre de la regla del publicador. |
pub_rule |
string | no | "My Publisher Rule (736)" |
En desuso (a partir del 17 de octubre de 2016). |
pub_rule_code |
string | no | "My Publisher Rule Code" |
|
seller_member_id |
Entero | sí | 456 |
Identificador del miembro vendedor. |
geo_country |
string | sí | "US" |
El código del país geográfico. |
geo_country_name |
string | no | "United States" |
Nombre del país geográfico. |
size |
string | sí | "728x90" |
Tamaño de la colocación/creatividad servida. |
placement_id |
Entero | sí | 546 |
Identificador de la ubicación. Nota: En el caso de las impresiones anteriores a 100 días, las ubicaciones se agregarán en una fila con -1 como placement_id. |
placement_name |
string | no | "300x250 Business" |
Nombre de la ubicación. Tenga en cuenta que, para las impresiones anteriores a 100 días, las ubicaciones se agregarán en una fila con "Todos los datos de selección de ubicación anteriores a 100 días" como placement_name. |
placement |
string | no | "Photos 728x90 (567)" |
En desuso (a partir del 17 de octubre de 2016). |
placement_code |
string | no | "Photos Code" |
|
deal_id |
Entero | Yes | 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_id |
Entero | sí | 3 |
Identificador de la marca asociada a una creatividad que se sirve en el inventario del publicador. Para imp_type_id = 6, no hay información disponible en el brand_id campo para este informe. Consulte el informe de revisión de marca del publicador en su lugar. |
brand_name |
string | no | "Ace Hardware" |
Nombre de la marca asociada a una creatividad que se sirve en el inventario del publicador. Para imp_type_id = 6, no hay información disponible en el brand_name campo para este informe. Consulte el informe de revisión de marca del publicador en su lugar. |
brand |
string | no | "Ace Hardware (3)" |
En desuso (a partir del 17 de octubre de 2016). |
supply_type |
string | no | Tipo de inventario. Posibles valores: - "web"- "mobile_web"- "mobile_app" |
|
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. |
imp_type |
name | sí | "Kept" |
Tipo de impresiones. Para obtener los valores posibles, vea imp_type_id. |
media_type |
string | no | "Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin" |
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. |
adjustment_id |
Entero | sí | 22 |
El identificador de un ajuste que ha establecido mediante el servicio de ajuste. Las redes usan ajustes para ayudar a mostrar sus ingresos reales en los informes de Xandr. |
site_id |
Entero | sí | 555 |
Identificador del sitio. Para obtener más información, consulte El servicio de sitio. |
site_name |
string | sí | "My Site" |
Nombre del sitio. Para obtener más información, consulte El servicio de sitio. |
site |
string | sí | "My Site (555)" |
En desuso (a partir del 17 de octubre de 2016). |
venue |
string | sí | "Venue 55" |
La palabra Venue seguida del identificador del lugar asociado del inventario. |
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. |
Métricas
| Column | Tipo | Ejemplo | Fórmula | Description |
|---|---|---|---|---|
imps_total |
Entero | 234223 |
Duendes | Número total de impresiones (incluidos los valores predeterminados). |
imps_requests |
Entero | 234300 |
imps_requests | Número total de llamadas de anuncios (solicitudes de impresiones). Advertencia: Esta métrica suele ser inexacta para el inventario de vídeo debido a retrasos ocasionales en la recepción de eventos de vídeo, lo que puede dar lugar a totales de solicitudes inflados en función de la suposición de que el vídeo ha expirado. Para obtener una mejor métrica de solicitudes de vídeo, debe usar solicitudes de anuncios en el informe de red de entrega y relleno de vendedores o en el informe de Análisis de vídeo de red. |
imps_sold |
Entero | 234123 |
imps_sold | Número total de impresiones vendidas a anunciantes directos y en tiempo real. |
imps_default |
Entero | 100 |
imps_default | Número total de impresiones no vendidas (creatividad predeterminada servida). |
imps_blank |
Entero | 12 |
imps_blank | Número de impresiones que se han servido con un espacio en blanco. |
imps_psa |
Entero | 10 |
imps_psa | El número de impresiones que se sirvieron con un PSA. |
imps_default_error |
Entero | 3 |
imps_default_error | Número de impresiones que se han producido de forma predeterminada debido a un error de tiempo de espera. |
imps_default_bidder |
Entero | 5 |
imps_default_bidder | Número de impresiones predeterminadas porque no había pujas válidas. |
imps_kept |
Entero | 405 |
imps_kept | El número de impresiones que el anunciante compró a su editor. |
imps_resold |
Entero | 506 |
imps_resold | Número de impresiones que el editor vendió a un tercero. |
imps_rtb |
Entero | 94 |
imps_rtb | El número de impresiones que tu anunciante compró a un tercero. |
imps_filled |
Entero | 4900 |
imps_filled | Número de impresiones en blanco, PSA, predeterminadas, mantenidas, revendidas y externas. |
external_impression |
Entero | 0 |
external_impression | Número de impresiones externas. |
external_click |
Entero | 0 |
external_click | Número de clics externos. |
clicks |
Entero | 545 |
Clics | Número total de clics en todas las impresiones. |
post_view_convs_pixel |
Entero | 23 |
Conversiones posteriores a la vista para el píxel. Para obtener más información sobre cómo se atribuyen las conversiones posteriores a la vista (y otras), vea Atribución de conversión (Microsoft Monetizar) o Atribución de conversión (Microsoft Invest). | |
post_clicks_convs_pixel |
Entero | 15 |
Conversiones de clic posteriores para el píxel. Para obtener más información sobre cómo se atribuyen las conversiones posteriores a la vista (y otras), vea Atribución de conversión (Microsoft Monetizar) o Atribución de conversión (Microsoft Invest). | |
publisher_revenue |
Dinero | 400.05 |
publisher_revenue | Los ingresos pagados al publicador (en función de revshare o CPM). |
publisher_revenue_pub_curr |
Dinero | 400.05 |
publisher_revenue_pub_curr | Los ingresos pagados al publicador (en función de revshare o CPM), en la moneda del publicador. |
publisher_filled_revenue |
Dinero | 350.02 |
publisher_filled_revenue | Los ingresos pagados al publicador (en función de revshare o CPM) por las impresiones rellenadas. |
publisher_filled_revenue_publisher_curr |
Dinero | 350.02 |
publisher_filled_revenue | Los ingresos pagados al publicador (en función de revshare o CPM) por las impresiones rellenadas, en la moneda del publicador. |
publisher_default_revenue |
Dinero | 350.02 |
publisher_default_revenue | Los ingresos pagados al publicador (en función de revshare o CPM) por impresiones predeterminadas. |
publisher_default_revenue_publisher_curr |
Dinero | 350.02 |
publisher_default_revenue | Los ingresos pagados al publicador (en función de revshare o CPM) por impresiones predeterminadas, en la moneda del publicador. |
total_convs |
Entero | 205 |
total_convs | Número total de conversiones de post view y post click. |
ctr |
double | 0.002327 |
clics o imps | Tasa de clics en impresiones. |
click_thru_pct |
double | 1.12359550561797 |
(clics/imps) * 100 | Tasa de clics en impresiones como porcentaje. |
convs_rate |
double | 0.000856 |
total_convs/imps | Tasa de conversiones a impresiones. |
convs_per_mm |
double | 221.877080097625 |
(total_convs/imps) x 1000 000 | Número de conversiones por millón de impresiones. |
publisher_rpm |
Dinero | 1.71 |
(publisher_revenue/imps) x 1000 | Ingresos del publicador por cada 1000 impresiones. |
publisher_rpm_pub_curr |
Dinero | 1.71 |
(publisher_revenue/imps) x 1000 | Los ingresos del publicador por 1000 impresiones, en la moneda del publicador. |
publisher_filled_rpm |
Dinero | (publisher_revenue/imps_filled) x 1000 | Ingresos del publicador por cada 1000 impresiones rellenadas. | |
publisher_filled_rpm_publisher_currency |
Dinero | (publisher_revenue/imps_filled) x 1000 | Los ingresos del publicador por cada 1000 impresiones rellenadas, en la moneda del publicador. | |
publisher_default_rpm |
Dinero | 1.71 |
(publisher_revenue/imps_default) x 1000 | Los ingresos del publicador por cada 1000 impresiones predeterminadas. |
publisher_default_rpm_publisher_curr |
Dinero | 1.71 |
(publisher_revenue/imps_default) x 1000 | Los ingresos del publicador por cada 1000 impresiones predeterminadas, en la moneda del publicador. |
imps_viewed |
Entero | 30,450 |
imps_viewed | El número de impresiones medidas que se pueden ver según la definición de visualización de IAB, que indica que una impresión es visible si el 50 % de los píxeles se ven durante 1 segundo consecutivo. |
view_measured_imps |
Entero | 10,120 |
view_measured_imps | Número total de impresiones que se midieron para la visibilidad. |
view_rate |
double | 58% |
view_rate | Porcentaje de impresiones que se pudieron ver del número total de impresiones medidas para la visibilidad. (Imps/View Measured Imps) |
view_measurement_rate |
double | 45% |
view_measurement_rate | Porcentaje de impresiones medidas para la visibilidad del número total de impresiones. (Ver imps/imps medidos) |
video_skips |
Entero | 10 |
Número total de veces que un usuario omitió el vídeo. Use esta métrica para informar al comprar inventario omitible. | |
video_starts |
Entero | 11 |
El número total de veces que se descargó e inició el primer segmento de la creatividad de vídeo. | |
video_25_pcts |
Entero | 10 |
El número total de veces que las creatividades de vídeo completaron el 25 % de toda la duración. | |
video_50_pcts |
Entero | 10 |
El número total de veces que las creatividades de vídeo completaron el 50 % de toda la duración. | |
video_75_pcts |
Entero | 10 |
El número total de veces que las creatividades de vídeo completaron el 75 % de toda la duración. | |
video_completions |
Entero | 12 |
El número total de veces que las creatividades de vídeo se reproducen durante todo el tiempo. | |
video_served |
Entero | 10 |
El número total de respuestas de vídeo que se han servido al reproductor. Una respuesta de anuncio se produce cuando se proporciona el documento VAST (XML) en respuesta a una solicitud. Una respuesta de anuncio no indica necesariamente una impresión correcta. Para una impresión, el primer fotograma del vídeo debe ser servido. | |
video_errors |
Entero | 2 |
Número total de veces que se produjo un error de vídeo. | |
revenue_per_video_complete |
Dinero | 25.76 |
Ingresos por finalización de vídeo. | |
cost_per_video_complete |
Dinero | 22.76 |
Costo por finalización de vídeo. | |
video_completion_rate |
double | 1.12359550561797% |
(finalizaciones de vídeo/total de impresiones) x 100 | Relación entre las finalizaciones de vídeo y las impresiones, expresada como un porcentaje. |
video_start_rate |
double | 1.12359550561797% |
Porcentaje de veces que se descargó e inició el primer segmento de la creatividad de vídeo. | |
video_skip_rate |
double | 1.12359550561797% |
Porcentaje de veces que el usuario optó por omitir el vídeo. |
Depósitos de edad
| Id. de bucket | Nombre del cubo |
|---|---|
0 |
"unknown" |
1 |
"13-17" |
2 |
"18-24" |
3 |
"25-34" |
4 |
"35-44" |
5 |
"45-54" |
6 |
"'55-64" |
7 |
"65+" |
Ejemplos
Paso 1: Preparación de la solicitud de informe
$ cat the-file.json
{
"report": {
"format": "csv",
"report_interval": "yesterday",
"columns": [
"publisher_id",
"imp_type",
"geo_country",
"placement_id",
"imps_total",
"imps_kept",
"imps_resold",
"publisher_filled_revenue",
"total_convs"
],
"report_type": "publisher_analytics"
}
}
Paso 2: POST solicitud de JSON al servicio de informes
$ curl -b cookies -c cookies -X POST -d @the-file.json 'https://api.appnexus.com/report?publisher_id=5555'
{
"response": {
"status": "OK",
"report_id": "f589854c1697da8ff9ead66825c9bc04"
}
}
Paso 3: Comprobar el estado de la solicitud
$ curl -b cookies 'https://api.appnexus.com/report?id=f589854c1697da8ff9ead66825c9bc04'
{
"response": {
"status": "OK",
"report": {
"name": "",
"created_on": "2013-10-30 21:15:36",
"cache_hit": false,
"fact_cache_hit": false,
"fact_cache_error": "",
"header_info": "",
"row_count": "",
"report_size": "",
"internal_info": "",
"user_id": "2027",
"entity_id": "0",
"started_on": "1970-01-01 00:00:01",
"finished_on": "1970-01-01 00:00:01",
"query_time": ""
},
"execution_status": "pending"
}
}
Paso 4: Descargar los datos
curl -b cookies 'https://api.appnexus.com/report-download?id=f589854c1697da8ff9ead66825c9bc04' > /tmp/publisher_analytics.csv
Nota:
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.