Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El informe de análisis del editor se puede usar para ver los datos de ingresos y beneficios en los sitios y ubicaciones de un editor específico. Este informe está disponible tanto para los usuarios de red como para los usuarios del editor.
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 editor como parte de la dirección URL, tal como se indica a continuación:
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
- de duración
Período de retención de datos
La mayoría de los datos de este informe se conservan 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 el individuo:
- Recursos creativos
- Colocaciones
- Marcas
En algunos casos, los informes de análisis pueden mostrar entregas que no coinciden con Lifetime QuickStats de un anunciante o editor determinado. Esto se debe a la forma en que se agregan los datos de los informes de Analytics de más de 100 días y 14 meses. Los datos de los informes de facturación se conservan en 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 Servicio de informes.
Dimensions
| Column | Tipo | ¿Filtro? | Ejemplo | Descripción |
|---|---|---|---|---|
hour |
time | no | "2010-02-01 06:00:00" |
La hora de la subasta. Nota: Para las impresiones de más de 100 días, se devolverá el día 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 |
El Id. del publicador. |
publisher_code |
string | no | "My Publisher Code" |
El código personalizado para el editor. |
publisher_currency |
string | no | "USD" |
La moneda del editor. |
pub_rule_id |
Entero | sí | 736 |
El id. de la regla de editor. |
pub_rule_name |
string | no | "My Publisher Rule" |
El nombre de la regla del editor. |
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 |
El identificador del miembro vendedor. |
geo_country |
string | sí | "US" |
El código del país o región geográficos. |
geo_country_name |
string | no | "United States" |
El nombre del país o región geográficos. |
size |
string | sí | "728x90" |
El tamaño de la ubicación/creatividad servida. |
placement_id |
Entero | sí | 546 |
El id. de la ubicación. Nota: Para las impresiones de más de 100 días, las ubicaciones se agregarán en una fila con -1 el placement_idformato . |
placement_name |
string | no | "300x250 Business" |
El nombre del emplazamiento. Ten en cuenta que, para las impresiones de más de 100 días, las ubicaciones se agregarán en una fila con "Todos los datos de emplazamientos de más de 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 | Sí | 2345 |
El identificador de la oferta. 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" |
El nombre del trato. |
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" |
El código personalizado de la oferta. |
brand_id |
Entero | sí | 3 |
Id. de la marca asociada a un creativo que se sirve en el inventario del editor. Para imp_type_id = 6, no hay información disponible en el brand_id campo para este informe. En su lugar, consulta el Informe de reseñas de marca del editor . |
brand_name |
string | no | "Ace Hardware" |
El nombre de la marca asociada a un creativo que se sirve en el inventario del editor. Para imp_type_id = 6, no hay información disponible en el brand_name campo para este informe. En su lugar, consulta el Informe de reseñas de marca del editor . |
brand |
string | no | "Ace Hardware (3)" |
En desuso (a partir del 17 de octubre de 2016). |
supply_type |
string | no | El tipo de inventario. Posibles valores: - "web"- "mobile_web"- "mobile_app" |
|
imp_type_id |
Entero | sí | 1 |
El identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis): - 1 ("Blank"): No se sirve ninguna creatividad.- 2 ("PSA"): se publicó un anuncio de servicio público porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible.- 3 ("Error predeterminado"): una creatividad predeterminada servida debido a un problema de tiempo de espera.- 4 ("Predeterminado"): se publicó una creatividad predeterminada porque no había pujas válidas.- 5 ("Conservado"): el recurso creativo de su anunciante se sirve en el sitio de su editor.- 6 ("Revendida"): la impresión de su editor se vendió a un comprador externo.- 7 ("RTB"): el recurso creativo del anunciante publicado 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 falta de una creatividad predeterminada.- 9 ("Impresión externa"): una impresión de un rastreador de impresiones. |
imp_type |
name | sí | "Kept" |
El tipo de impresiones. Para conocer los posibles valores, véase 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 editor. Puede usar el Servicio de tipos de medios para ver la lista completa de los tipos de medios. |
adjustment_id |
Entero | sí | 22 |
El ID de un ajuste que ha establecido mediante el servicio de ajustes. Las redes usan ajustes para ayudar a mostrar sus ingresos reales en los informes de Xandr. |
site_id |
Entero | sí | 555 |
El identificador del sitio. Para obtener más información, consulte el Servicio de sitio. |
site_name |
string | sí | "My Site" |
El 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 lugar seguido del identificador del lugar asociado al inventario. |
mediatype_id |
Entero | sí | 444 |
El identificador del tipo de medio asociado al creativo que se ha servido. Para obtener más información, consulte el servicio de tipos multimedia. |
Métricas
| Column | Tipo | Ejemplo | Fórmula | Descripción |
|---|---|---|---|---|
imps_total |
Entero | 234223 |
Diablillos | El número total de impresiones (incluidas las predeterminadas). |
imps_requests |
Entero | 234300 |
imps_requests | El número total de llamadas de anuncios (solicitudes de impresión). 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 un total de solicitudes inflado basado en la suposición de que el vídeo ha caducado. Para obtener una mejor métrica de solicitud de vídeo, debe usar las solicitudes de anuncios en el informe de red de entrega y llenado del vendedor o en el informe de análisis de vídeo de red. |
imps_sold |
Entero | 234123 |
imps_sold | El número total de impresiones vendidas a anunciantes directos y en tiempo real. |
imps_default |
Entero | 100 |
imps_default | El número total de impresiones no vendidas (creatividad predeterminada servida). |
imps_blank |
Entero | 12 |
imps_blank | El 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 anuncio de servicio público. |
imps_default_error |
Entero | 3 |
imps_default_error | El número de impresiones que se han predeterminado debido a un error de tiempo de espera. |
imps_default_bidder |
Entero | 5 |
imps_default_bidder | El número de impresiones que se produjeron de forma predeterminada porque no había pujas válidas. |
imps_kept |
Entero | 405 |
imps_kept | El número de impresiones que el anunciante compró a tu editor. |
imps_resold |
Entero | 506 |
imps_resold | El número de impresiones que tu editor vendió a un tercero. |
imps_rtb |
Entero | 94 |
imps_rtb | El número de impresiones que el anunciante compró a un tercero. |
imps_filled |
Entero | 4900 |
imps_filled | El número de impresiones en blanco, PSA, predeterminadas, conservadas, revendidas y externas. |
external_impression |
Entero | 0 |
external_impression | El número de impresiones externas. |
external_click |
Entero | 0 |
external_click | El número de clics externos. |
clicks |
Entero | 545 |
clics | El número total de clics en todas las impresiones. |
post_view_convs_pixel |
Entero | 23 |
Conversiones de vista de publicación para el píxel. Para obtener más información sobre cómo atribuimos las conversiones posteriores a la vista (y otras), consulte Atribución de conversiones (Microsoft Monetize) o Atribución de conversiones (Microsoft Invest). | |
post_clicks_convs_pixel |
Entero | 15 |
Conversiones de clics posteriores para el píxel. Para obtener más información sobre cómo atribuimos las conversiones posteriores a la vista (y otras), consulte Atribución de conversiones (Microsoft Monetize) o Atribución de conversiones (Microsoft Invest). | |
publisher_revenue |
dinero | 400.05 |
publisher_revenue | Los ingresos pagados al editor (basados en revshare o CPM). |
publisher_revenue_pub_curr |
dinero | 400.05 |
publisher_revenue_pub_curr | Los ingresos pagados a la editorial (basados en revshare o CPM), en la moneda de la editorial. |
publisher_filled_revenue |
dinero | 350.02 |
publisher_filled_revenue | Los ingresos pagados al editor (basados en revshare o CPM) por las impresiones completadas. |
publisher_filled_revenue_publisher_curr |
dinero | 350.02 |
publisher_filled_revenue | Los ingresos pagados al editor (basados en revshare o CPM) por las impresiones completadas, en la moneda del editor. |
publisher_default_revenue |
dinero | 350.02 |
publisher_default_revenue | Los ingresos pagados al editor (en función de revshare o CPM) por las impresiones predeterminadas. |
publisher_default_revenue_publisher_curr |
dinero | 350.02 |
publisher_default_revenue | Los ingresos pagados a la editorial (basados en revshare o CPM) por las impresiones predeterminadas, en la moneda de la editorial. |
total_convs |
Entero | 205 |
total_convs | El número total de conversiones de visualización de publicación y de clics de publicaciones. |
ctr |
double | 0.002327 |
Clics / Diablillos | La tasa de clics a impresiones. |
click_thru_pct |
double | 1.12359550561797 |
(clics / diablillos) * 100 | La tasa de clics a impresiones como porcentaje. |
convs_rate |
double | 0.000856 |
total_convs / diablillos | La tasa de conversiones a impresiones. |
convs_per_mm |
double | 221.877080097625 |
(total_convs / diablillos) x 1.000.000 | El número de conversiones por millón de impresiones. |
publisher_rpm |
dinero | 1.71 |
(publisher_revenue / diablillos) x 1000 | Los ingresos del editor por cada 1000 impresiones. |
publisher_rpm_pub_curr |
dinero | 1.71 |
(publisher_revenue / diablillos) x 1000 | Los ingresos del editor por cada 1000 impresiones, en la moneda del editor. |
publisher_filled_rpm |
dinero | (publisher_revenue / imps_filled) x 1000 | Los ingresos del editor por cada 1000 impresiones rellenadas. | |
publisher_filled_rpm_publisher_currency |
dinero | (publisher_revenue / imps_filled) x 1000 | Los ingresos del editor por cada 1000 impresiones rellenadas, en la moneda del editor. | |
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 editor por cada 1000 impresiones predeterminadas, en la moneda del editor. |
imps_viewed |
Entero | 30,450 |
imps_viewed | El número de impresiones medidas que fueron visibles, según la definición de visibilidad de IAB, que establece que una impresión es visible si el 50 % de los píxeles están a la vista durante 1 segundo consecutivo. |
view_measured_imps |
Entero | 10,120 |
view_measured_imps | El número total de impresiones que se midieron para la visibilidad. |
view_rate |
double | 58% |
view_rate | El porcentaje de impresiones visibles del total de impresiones medidas para la visibilidad. (Diablillos vistos / Ver diablillos medidos) |
view_measurement_rate |
double | 45% |
view_measurement_rate | El porcentaje de impresiones medidas para la visibilidad del número total de impresiones. (Ver Imps / Imps medidos) |
video_skips |
Entero | 10 |
El número total de veces que un usuario se ha saltado el vídeo. Use esta métrica para generar informes al comprar inventario omitible. | |
video_starts |
Entero | 11 |
El número total de veces que se ha descargado e iniciado 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 la duración total. | |
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 se reprodujeron las creatividades de vídeo durante toda la duración. | |
video_served |
Entero | 10 |
El número total de respuestas de vídeo servidas al jugador. Una respuesta de anuncio se produce cuando el documento VAST (XML) se sirve en respuesta a una solicitud. Una respuesta a un anuncio no indica necesariamente una impresión correcta. Para una impresión, se debe servir el primer fotograma del vídeo. | |
video_errors |
Entero | 2 |
El número total de veces que se ha producido un error de vídeo. | |
revenue_per_video_complete |
dinero | 25.76 |
Los ingresos por finalización del vídeo. | |
cost_per_video_complete |
dinero | 22.76 |
El coste por finalización del vídeo. | |
video_completion_rate |
double | 1.12359550561797% |
(finalización de vídeo/impresiones totales) x 100 | La proporción entre las impresiones y las finalizaciones de vídeo, expresada como porcentaje. |
video_start_rate |
double | 1.12359550561797% |
El porcentaje de veces que se ha descargado e iniciado el primer segmento del vídeo creativo. | |
video_skip_rate |
double | 1.12359550561797% |
El porcentaje de veces que el usuario ha optado por omitir el vídeo. |
Cubos de edad
| Bucket ID | Nombre del depósito |
|---|---|
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: Preparar 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 JSON de la solicitud 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.