Análisis de anunciantes

El informe de Análisis de anunciantes se puede usar para ver los datos de rendimiento, ingresos y ganancias en las campañas y creatividades de un anunciante específico. Este informe está disponible para los usuarios de red y anunciantes.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Report Service o el ejemplo siguiente. Este informe requiere especificar el identificador de anunciante como parte de la dirección URL, por ejemplo:

https://api.appnexus.com/report?advertiser_id=ADVERTISER_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_2_days
• 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 las estadísticas que se muestran en otra parte de Microsoft Invest o Microsoft Monetize para 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. Para obtener más información, vea Fechas y horas en Informes en la documentación de la interfaz de usuario.

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"	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.
adjustment_id	Entero	Yes	890	Número de identificación único del ajuste que se usa para realizar cambios en el costo de los medios o impresiones, clics y conversiones que se ven en los informes de un publicador.
advertiser_code	string	No	"Advertiser Code"	Código personalizado para el anunciante.
advertiser_currency	string	Sí	"USD"	El tipo de dinero utilizado por el anunciante.
advertiser_id	Entero	Yes	3	Número de identificación único para cada anunciante.
buyer_member_id	Entero	Yes	210	Número de identificación único para el miembro comprador.
seller_member_id	Entero	Yes	765	Número de identificación único del miembro vendedor.
seller_member_name	string	No	"AdMeld"	Nombre del miembro vendedor.
seller_member	string	No	"AdMeld (765)"	En desuso (a partir del 17 de octubre de 2016).
campaign_id	Entero	Yes	728	Número de identificación único de la campaña.
campaign_name	string	No	"Test"	Nombre de la campaña.
campaign	string	No	"Test (123)"	En desuso (a partir del 17 de octubre de 2016).
campaign_code	string	No	"Campaign Code"	Código personalizado para la campaña.
campaign_priority	Entero	No	4	La prioridad de las pujas de una campaña destinada al inventario directo. La escala es de 1 a 10, siendo 1 la más baja y 10 la más alta.
split_id	Entero	Yes	342	Identificador de la división que compró las impresiones en este conjunto de datos. Las divisiones solo se aplican a los elementos de línea aumentadas. En el caso de los informes que contengan campañas, el split_id valor (si se incluye) será null.
split_name	string	Sí	"Mobile Split A"	Nombre de la división que compró las impresiones en este conjunto de datos. Las divisiones solo se aplican a los elementos de línea aumentadas. Para cualquier informe que contenga campañas, ( split_name si se incluye) será null.
creative_id	Entero	Yes	554	Número de identificación único de la creatividad. Nota: - En el caso de las impresiones anteriores a 14 meses, las creatividades se agregarán en una fila con 0 como .creative_id - Para seguimientos de clics o impresiones externos, creative_id será "External Clicks" o "External Imps".
creative_name	string	No	"Q1 2010 728x90"	Nombre para mostrar de la creatividad. Nota: - En el caso de las impresiones anteriores a 14 meses, las creatividades se agregarán en una fila con "All creative data older than 14 months" como .creative_name - Para seguimientos de clics o impresiones externos, creative_name será "External Clicks" o "External Imps".
creative	string	No	"Q1 2010 - 728x90 (554)"	En desuso (a partir del 17 de octubre de 2016).
placement_id	Entero	Yes	546	Número de identificación único de la ubicación. Nota: - Para las impresiones anteriores a 14 meses, las ubicaciones se agregarán en una fila con -1 como placement_id.
placement_name	string	No	"300x250 Business"	Nombre de la ubicación. Nota: En el caso de las impresiones anteriores a 14 meses, las ubicaciones se agregarán en una fila con "All placement data older than 100 days" como placement_name.
placement	string	No	"FP 728x90 (567)"	En desuso (a partir del 17 de octubre de 2016).
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 vendedores, consulte Deal Buyer Access Service.
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	"External seller deal code"	Código personalizado para la oferta. En el caso de las ofertas con asociados de suministro externos, esta suele ser la cadena que se usa para identificar la oferta.
placement_code	string	No	"FP 728x90"	Código personalizado para la ubicación.
size	string	Sí	"728x90"	Tamaño de la colocación/creatividad servida.
geo_country	string	Sí	"US"	Código del país geográfico.
geo_country_name	string	No	"United States"	Nombre del país geográfico.
creative_recency_bucket	string	Sí	"15-30 minutes"	En desuso. Si solicita esta dimensión, solo se devolverá un valor predeterminado. Use el informe Frecuencia creativa del anunciante & censura para ver los datos de recencia creativa.
creative_recency_bucket_id	string	No	3	En desuso. Si solicita esta dimensión, solo se devolverá un valor predeterminado. Use el informe Frecuencia creativa del anunciante & censura para ver los datos de recencia creativa.
creative_frequency_bucket	string	Sí	"11-20"	En desuso. Si solicita esta dimensión, solo se devolverá un valor predeterminado. Use el informe Frecuencia creativa del anunciante & censura para ver los datos de frecuencia creativa.
creative_frequency_bucket_id	string	No	4	En desuso. Si solicita esta dimensión, solo se devolverá un valor predeterminado. Use el informe Frecuencia creativa del anunciante & censura para ver los datos de frecuencia creativa.
gender	string	Sí	"m", "f", "u"	El sexo del usuario. Nota: En el caso de las impresiones anteriores a 100 días, el género será "u". El publicador define el valor del género en la solicitud de puja. Xandr no tiene control sobre él, aparte de procesar el valor.
imp_type_id	Entero	Yes	1	Identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis): - 1 ("Blank"): no se sirve creativo. - 2 ("PSA"): se sirvió un anuncio de servicio público porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible. - 3 ("Default Error"): una creatividad predeterminada que se sirve debido a un problema de tiempo de espera. - 4 ("Default"): un creativo predeterminado servido porque no había ofertas válidas. - 5 ("Kept"): la creatividad de su anunciante se ha servido en el sitio de su editor. - 6 ("Resold"): la impresión del editor se vendió a un comprador de terceros. - 7 ("RTB"): la creatividad de su anunciante se sirve en el inventario de terceros. - 8 ("PSA Error"): un anuncio de servicio público servido debido a un problema de tiempo de espera o a la falta de una creatividad predeterminada. - 9 ("External Impression"): una impresión de un rastreador de impresiones. - 10 ("External Click"): un clic de un seguimiento de clics.
imp_type	string	Sí	"Kept"	Tipo de impresión. Para obtener los valores posibles, vea imp_type_id.
bid_type	string	Sí	"Manual"	La fase de optimización en la que se encontraba el nodo al pujar por esta impresión. Nota: El término "renunciar" se anexa a los tipos de oferta siguientes si la valoración de esa impresión está por debajo del "precio de renuncia" del lugar. Valores permitidos: - "Manual": se aplica cuando se puja por un objetivo de CPM, ya sea Base, EAP o ECP. - "Learn": se aplica cuando se puja con optimización (CPA, CPC o margen) y todavía no tenemos suficientes datos para optimizar la puja. - "Optimized": se aplica cuando se puja con optimización (CPA, CPC o margen) y tenemos suficientes datos para optimizar la puja. - "Unknown": el nodo estaba en una fase de optimización desconocida. - "Optimized give up" - "Learn give up" - "Manual give up"
insertion_order_id	Entero	Yes	648359	Número de identificación único del orden de inserción.
insertion_order_name	string	No	"InsertionOrderABC"	Nombre del orden de inserción.
insertion_order	string	No	"InsertionOrderABC648359"	En desuso (a partir del 17 de octubre de 2016).
insertion_order_code	string	No	"Insertion Order Code"	Código personalizado para el orden de inserción.
line_item_id	Entero	Yes	947764	Número de identificación único del elemento de línea.
line_item_name	string	No	"LineItemDEF"	Nombre del elemento de línea.
line_item	string	No	"LineItemDEF947764"	En desuso (a partir del 17 de octubre de 2016).
line_item_code	string	No	"Line Item Code"	Código personalizado para el elemento de línea.
supply_type	string	No	"web"	Tipo de inventario. Posibles valores: - "web" - "mobile_web" - "mobile_app".
pixel_id	Entero	Yes	1942	Número de identificación único del píxel de conversión. Nota: Esta dimensión devolverá un máximo de 10 píxeles de conversión. Además, puede filtrar por no más de 10 píxeles de conversión.
publisher_id	Entero	Yes	374967	Número de identificación único del publicador.
publisher_name	string	No	"Publisher XYZ"	Nombre del publicador.
publisher	string	No	"Publisher XYZ 347967"	En desuso (a partir del 17 de octubre de 2016).
publisher_code	string	No	"Publisher Code"	Código personalizado para el publicador.
seller_type	string	Sí	"Real Time", "Direct"	Tipo de vendedor.
supply_type	string	Sí	"web"	Tipo de inventario. Posibles valores: - "web" - "mobile_web" - "mobile_app".
media_type	string	No	"Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin"	El estilo de visualización general de la creatividad. Puede usar el servicio de tipos de medios para ver la lista completa de tipos de medios.
mediatype_id	Entero	Yes	2	Número de identificación único del tipo de medio al que pertenece el subtipo.
user_group_for_campaign	string	Sí	"Test"	Grupo de usuarios de prueba o control de la campaña. Consulta el "labels" campo en el Servicio de campaña para obtener más detalles.
venue	Entero	Yes	321512	Nombre del clúster de dominio, sitio, etiqueta y país de usuario que usa el sistema de optimización de Xandr para determinar las valoraciones de las pujas. Una campaña no puede dirigirse a un lugar explícitamente.
billing_period_start_date	datetime	No	"2015-05-25 19:19:53"	La fecha más temprana del período de facturación del pedido de inserción. Nota: Alpha-Beta Aviso Este campo o característica forma parte de la funcionalidad actualmente en la fase Alfa o Beta. Por lo tanto, está sujeto a cambios.
billing_period_end_date	datetime	No	"2015-05-30 19:19:53"	La última fecha del período de facturación del pedido de inserción. Nota: Alpha-Beta Aviso Este campo o característica forma parte de la funcionalidad actualmente en la fase Alfa o Beta. Por lo tanto, está sujeto a cambios.
billing_period_external_code	string	No	"houseware245"	Código personalizado para el período de facturación (budget_interval).

Métricas

Column	Tipo	Ejemplo	Fórmula	Description
imps	Entero	234123	Duendes	Número total de impresiones servidas.
attributed_revenue	Dinero	10.45	post_view_revenue + post_click_revenue	Cantidad de ingresos de todas las vistas posteriores registradas y clics posteriores.
attributed_pc_revenue	Dinero	121.68	post_click_revenue	Cantidad de ingresos de todas las vistas posteriores registradas.
attributed_pv_revenue	Dinero	14	post_view_revenue	Cantidad de ingresos de todos los clics posteriores registrados.
clicks	Entero	545	Clics	Número total de clics en todas las impresiones.
click_convs_rate	double	0.057	total_convs/clics	Tasa de conversiones a clics.
click_conv_rate	double	0.000064	total_convs/clics	Tasa de conversiones a clics. Nota: Este campo es idéntico a click_convs_rate.
click_thru_pct	double	0.000%	clics o imps	Porcentaje de usuarios que ven una creatividad que ha hecho clic en ella.
cpa	Dinero	1.25	booked_revenue_dollars/(post_view_convs + post_click_convs)	Costo por adquisición.
cpc	Dinero	0.45	booked_revenue_dollars/clics	Costo por clic.
cpm	Dinero	0.18	(booked_revenue_dollars /imps) * 1000	El costo por cada 1000 impresiones.
post_view_convs	Entero	75	post_view_convs	Número total de conversiones de vistas posteriores registradas.
post_view_revenue	Dinero	150.00	post_view_revenue	Cantidad total de ingresos registrados después de la vista.
post_click_convs	Entero	15	post_click_convs	El número total de conversiones registradas después de hacer clic.
post_click_revenue	Dinero	300.00	post_click_revenue	Cantidad total de ingresos registrados después de hacer clic.
total_revenue	Dinero	450.00	post_view_revenue + post_click_revenue	Cantidad total de ingresos de la vista posterior y del clic posterior.
total_convs	Entero	90	post_view_convs + post_click_convs	Número total de conversiones de post view y post click.
conv_rate	double	0.018654	(post_click_convs + post_view_convs) / imps	Tasa de conversiones de clics y vistas posteriores a impresiones.
convs_rate	double	0.0003844	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.
ecpa_adv_curr	Dinero	1.13	booked_revenue_adv_curr/(post_view_convs + post_click_convs)	Costo por adquisición en el tipo de moneda del anunciante.
ecpc_adv_curr	Dinero	0.16	booked_revenue_adv_curr/clics	Costo por clic en el tipo de moneda del anunciante.
ecpm_adv_curr	Dinero	0.014	booked_revenue_adv_curr /imps * 1000	Costo por 1000 impresiones en el tipo de moneda del anunciante.
post_view_convs_rate	double	0.000320	post_view_convs/imps	Tasa de conversiones posteriores a impresiones.
post_click_convs_rate	double	0.000064	post_click_convs/imps	Tasa de conversiones de clic posteriores a impresiones.
post_click_conversion_pixel	Entero	52	post_click_convs para ese pixel_id	Número de conversiones de clic posteriores para un píxel específico. Para obtener más información sobre cómo se atribuyen las conversiones posteriores a la vista (y otras), atribución de conversión (monetizar) o atribución de conversión (Invertir).
post_click_revenue_pixel	Dinero	184.25	post_click_revenue para ese pixel_id	Cantidad de ingresos obtenidos por un píxel específico.
post_view_conversion_pixel	Entero	174	post_view_convs para ese pixel_id	Número de conversiones posteriores a la vista de un píxel específico. Para obtener más información sobre cómo se atribuyen las conversiones posteriores a la vista (y otras), vea Conversion Attribution (Monetize) o Conversion Attribution (Invest).
post_view_revenue_pixel	Dinero	303.54	post_view_revenue para ese pixel_id	Cantidad de ingresos obtenidos por un píxel específico.
ppm	Dinero	0.944966292134831	(beneficio /imps) x 1000	El beneficio por 1000 impresiones.
rpm	Dinero	2.60548314606741	(ingresos/imps) x 1000	Ingresos por 1000 impresiones.
spend_adv_curr	Dinero	357.18	booked_revenue_adv_curr	Importe total invertido por el anunciante en la moneda preferida del anunciante.
total_revenue_pixel	Dinero	41.253	post_click_revenue + post_view_revenue para ese pixel_id	Los ingresos totales obtenidos por un píxel específico.
ctr	double	0.002327	clics o imps	Tasa de clics en impresiones.
spend	Dinero	304.36	gastar	El gasto total del vendedor en las compras de medios directos y en tiempo real.
media_cost	Dinero	2.15	costo de medios	Cantidad total gastada en comprar todas las impresiones.
ecpm	Dinero	1.30	(gasto /imps) x 1000	El anunciante efectivo gasta por cada 1000 impresiones.
ecpc	Dinero	1.25	gasto/ clics	El gasto efectivo del anunciante por clic.
ecpa	Dinero	1.20	gasto/total_convs	El gasto efectivo del anunciante por conversión o adquisición.
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)
avg_bid_reduction	double	18%	avg_bid_reduction	La reducción media de la puja que obtuvo en el artículo de línea o la campaña. Este valor representa la diferencia (como porcentaje) entre la oferta y el costo medio real que pagó por la impresión que ganó (por ejemplo, debido a la reducción de la puja). Este valor solo es válido para las pujas RTB (es decir, no administrado). Actualmente, este valor no se calcula con precisión para los elementos de línea para los que el payment_auction_event_type campo se ha establecido en 2.
video_skips	Entero	10	video_skips	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	video_starts	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	video_25_pcts	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	video_50_pcts	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	video_75_pcts	El número total de veces que las creatividades de vídeo completaron el 75 % de toda la duración.
video_completions	Entero	12	video_completions	El número total de veces que las creatividades de vídeo se reproducen durante todo el tiempo.
video_served	Entero	10	video_served	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	video_errors	Número total de veces que se produjo un error de vídeo.
revenue_per_video_complete	Dinero	25.76	revenue_per_video_complete	Ingresos por finalización de vídeo.
cost_per_video_complete	Dinero	22.76	cost_per_video_complete	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%	video_start_rate	Porcentaje de veces que se descargó e inició el primer segmento de la creatividad de vídeo.
video_skip_rate	double	1.12359550561797%	video_skip_rate	Porcentaje de veces que el usuario optó por omitir el vídeo.

Ejemplos

Create una solicitud de informe con formato JSON

$ cat advertiser_analytics 
 
{ 
    "report": { 
        "report_type":"advertiser_analytics", 
        "columns": [ 
            "hour", 
            "seller_member_id", 
            "campaign_id", 
            "gender", 
            "imps", 
            "clicks", 
            "total_convs", 
            "ctr", 
            "convs_rate"
        ], 
        "report_interval": "last_48_hours", 
        "format":"csv" 
    } 
}

POST la solicitud al servicio de informes

La POST solicitud JSON y obtener un identificador de informe.

$ curl -b cookies -c cookies -X post -d @advertiser_analytics "https://api.appnexus.com/report?advertiser_id=690" 
 
{
    "response": {
        "status": "OK",
        "report_id": "2790c6627d058cd467f4267add49bedc",
        "existing": true,
        "dbg_info": {
            ...
        }
    }
}

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 llamada hasta que execution_status sea "ready". A continuación, use el report-download servicio para guardar los datos de informes en un archivo (descrito en el paso siguiente).

$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=dc0314bda06597582518c5fc3e1c47ef" 
 
{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-04-17 01:26:00",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "did not find any cache table for 1,3,6,44,30,31,32,34,15",
            "json_request": "{\"report\":{\"report_type\":\"advertiser_analytics\",\"columns\":[\"hour\",\"seller_member_id\",\"campaign_id\",\"gender\",\"imps\",\"clicks\",\"total_convs\",\"ctr\",\"convs_rate\"],\"report_interval\":\"last_48_hours\",\"format\":\"csv\",\"filters\":[{\"buyer_member_id\":\"948\"},{\"advertiser_id\":\"78216\"},{\"imp_type_id\":{\"operator\":\"!=\",\"value\":6}}]}}",
            "header_info": "Report ID:,2790c6627d058be467f4267add49bedc\r\nRun at:,2014-04-17 01:26:00\r\nStart date:,2014-04-15 01:00:00\r\nEnd date:,\r\nTimezone:,\r\nUser:,Jesse Seldess (9685)\r\n",
            "row_count": "0",
            "report_size": "75",
            "user_id": "9685",
            "entity_id": "0",
            "started_on": "2014-04-17 01:26:03",
            "finished_on": "2014-04-17 01:28:02",
            "query_time": "118",
            "url": "report-download?id=2790c6627d058be467f4267add49bedc"
        },
        "execution_status": "ready",
        "dbg_info": {
            ...
        }
    }
}

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 servicio y el identificador de informe en el campo url de la respuesta anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo de "format" que especificó en su inicial POST.

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/advertiser_analytics.csv 

Nota:

Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.