Análisis de anunciantes

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

Para obtener instrucciones sobre cómo recuperar un informe, consulte Servicio de informes o el ejemplo siguiente. Este informe requiere especificar el id. 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
• 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 las estadísticas que se muestran en otras partes de Microsoft Invest o Microsoft Monetize para 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. Para obtener más información, consulta 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 Servicio de informes.

Dimensions

Column	Tipo	¿Filtro?	Ejemplo	Descripción
hour	time	No	"2010-02-01 06: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.
adjustment_id	Entero	Sí	890	El número de identificación único del ajuste que se usa para realizar cambios en el coste multimedia o las impresiones, los clics y las conversiones que aparecen en los informes de un editor.
advertiser_code	string	No	"Advertiser Code"	El código personalizado para el anunciante.
advertiser_currency	string	Sí	"USD"	El tipo de dinero que usa el anunciante.
advertiser_id	Entero	Sí	3	El número de identificación único de cada anunciante.
buyer_member_id	Entero	Sí	210	El número de identificación único del miembro comprador.
seller_member_id	Entero	Sí	765	El número de identificación único del miembro vendedor.
seller_member_name	string	No	"AdMeld"	El nombre del miembro vendedor.
seller_member	string	No	"AdMeld (765)"	En desuso (a partir del 17 de octubre de 2016).
campaign_id	Entero	Sí	728	El número de identificación único de la campaña.
campaign_name	string	No	"Test"	El 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"	El código personalizado de la campaña.
campaign_priority	Entero	No	4	Prioridad de puja de una campaña destinada al inventario directo. La escala es del 1 al 10, siendo 1 el más bajo y 10 el más alto.
split_id	Entero	Sí	342	El identificador de la división que compró las impresiones de este conjunto de datos. Las divisiones solo se aplican a las líneas de pedido aumentadas. Para cualquier informe que contenga campañas, el split_id valor (si se incluye) será nulo.
split_name	string	Sí	"Mobile Split A"	El nombre de la división que compró las impresiones de este conjunto de datos. Las divisiones solo se aplican a las líneas de pedido aumentadas. Para cualquier informe que contenga campañas, el split_name (si se incluye) será null.
creative_id	Entero	Sí	554	El número de identificación único de la creatividad. Nota: - Para las impresiones de más de 14 meses, las creatividades se agregarán en una fila con 0 el creative_idformato . - Para los rastreadores de clics o impresiones externas, creative_id será "External Clicks" o "External Imps".
creative_name	string	No	"Q1 2010 728x90"	El nombre para mostrar del creativo. Nota: - Para las impresiones de más de 14 meses, las creatividades se agregarán en una fila con "All creative data older than 14 months" el creative_nameformato . - Para los rastreadores de clics o impresiones externas, 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	Sí	546	El número de identificación exclusivo del emplazamiento. Nota: - Para las impresiones de más de 14 meses, las ubicaciones se agregarán en una fila con -1 el placement_idformato .
placement_name	string	No	"300x250 Business"	El nombre del emplazamiento. Nota: Para las impresiones de más de 14 meses, las ubicaciones se agregarán en una fila con "All placement data older than 100 days" el placement_nameformato .
placement	string	No	"FP 728x90 (567)"	En desuso (a partir del 17 de octubre de 2016).
deal_id	Entero	Sí	2345	El identificador de la oferta. Para obtener más información sobre los acuerdos que ha negociado con los vendedores, consulte Servicio de acceso al comprador 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	"External seller deal code"	El código personalizado de la oferta. En el caso de los acuerdos con socios de suministro externos, esta es generalmente la cadena que se utiliza para identificar el trato.
placement_code	string	No	"FP 728x90"	El código personalizado de la ubicación.
size	string	Sí	"728x90"	El tamaño de la ubicación/creatividad servida.
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.
creative_recency_bucket	string	Sí	"15-30 minutes"	En desuso. Si solicita esta dimensión, solo se devolverá un valor predeterminado. Utiliza el informe Frecuencia & actualidad de creatividades de anunciantes para ver los datos de actualidad de creatividades.
creative_recency_bucket_id	string	No	3	En desuso. Si solicita esta dimensión, solo se devolverá un valor predeterminado. Utiliza el informe Frecuencia & actualidad de creatividades de anunciantes para ver los datos de actualidad de creatividades.
creative_frequency_bucket	string	Sí	"11-20"	En desuso. Si solicita esta dimensión, solo se devolverá un valor predeterminado. Utilice el informe Frecuencia de creatividades & actualidad de anunciantes para ver los datos de frecuencia de creatividades.
creative_frequency_bucket_id	string	No	4	En desuso. Si solicita esta dimensión, solo se devolverá un valor predeterminado. Utilice el informe Frecuencia de creatividades & actualidad de anunciantes para ver los datos de frecuencia de creatividades.
gender	string	Sí	"m", "f", "u"	El sexo del usuario. Nota: Para las impresiones de más de 100 días, el sexo será "u". El valor del sexo lo define el publicador en la solicitud de oferta. Xandr no tiene control sobre él aparte de procesar el valor.
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 ningún creativo. - 2 ("PSA"): Se ha publicado un anuncio de servicio público porque no había pujas válidas y no había ningún creativo predeterminado disponible. - 3 ("Default Error"): una creatividad predeterminada servida debido a un problema de tiempo de espera. - 4 ("Default"): se publicó una creatividad predeterminada porque no había pujas válidas. - 5 ("Kept"): El creativo de su anunciante se sirve en el sitio de su editor. - 6 ("Resold"): La impresión del editor se vendió a un comprador externo. - 7 ("RTB"): el recurso creativo del anunciante que 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 falta de una creatividad predeterminada. - 9 ("External Impression"): una impresión de un rastreador de impresiones. - 10 ("External Click"): un clic de un rastreador de clics.
imp_type	string	Sí	"Kept"	El tipo de impresión. Para conocer los posibles valores, consulta imp_type_id.
bid_type	string	Sí	"Manual"	La fase de optimización en la que se encontraba el nodo cuando puja por esta impresión. Nota: El término "renuncia" se agrega a los tipos de ofertas a continuación si la valoración de esa impresión cae por debajo del "precio de renuncia" del lugar. Valores permitidos: - "Manual": Se aplica cuando se puja con un objetivo de CPM, ya sea Base, EAP o ECP. - "Learn": Se aplica cuando se puja con optimización (CPA, CPC o margen) y aún no tenemos datos suficientes para pujar optimizada. - "Optimized": se aplica cuando se puja con optimización (CPA, CPC o margen) y tenemos datos suficientes para pujar optimizada. - "Unknown": el nodo se encontraba en una fase de optimización desconocida. - "Optimized give up" - "Learn give up" - "Manual give up"
insertion_order_id	Entero	Sí	648359	El número de identificación único de la orden de inserción.
insertion_order_name	string	No	"InsertionOrderABC"	El nombre de la 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"	El código personalizado de la orden de inserción.
line_item_id	Entero	Sí	947764	El número de identificación único del elemento de línea.
line_item_name	string	No	"LineItemDEF"	El nombre de la línea de pedido.
line_item	string	No	"LineItemDEF947764"	En desuso (a partir del 17 de octubre de 2016).
line_item_code	string	No	"Line Item Code"	El código personalizado de la línea de pedido.
supply_type	string	No	"web"	El tipo de inventario. Posibles valores: - "web" - "mobile_web" - "mobile_app".
pixel_id	Entero	Sí	1942	El 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, no puede filtrar por más de 10 píxeles de conversión.
publisher_id	Entero	Sí	374967	El número de identificación único de la editorial.
publisher_name	string	No	"Publisher XYZ"	El nombre del editor.
publisher	string	No	"Publisher XYZ 347967"	En desuso (a partir del 17 de octubre de 2016).
publisher_code	string	No	"Publisher Code"	El código personalizado para el editor.
seller_type	string	Sí	"Real Time", "Direct"	El tipo de vendedor.
supply_type	string	Sí	"web"	El 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 los tipos de medios.
mediatype_id	Entero	Sí	2	El número de identificación único del tipo de medio al que pertenece el subtipo.
user_group_for_campaign	string	Sí	"Test"	El grupo de usuarios de prueba o control de la campaña. Consulte el "labels" campo en el Servicio de campaña para obtener más detalles.
venue	Entero	Sí	321512	El nombre del clúster de dominio, sitio, etiqueta y país o región del usuario que usa el sistema de optimización de Xandr para determinar las valoraciones de las ofertas. 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 de la orden de inserción. Nota: Alpha-Beta Aviso Este campo o característica forma parte de la funcionalidad que actualmente se encuentra en 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 de la orden de inserción. Nota: Alpha-Beta Aviso Este campo o característica forma parte de la funcionalidad que actualmente se encuentra en fase Alfa o Beta. Por lo tanto, está sujeto a cambios.
billing_period_external_code	string	No	"houseware245"	El código personalizado para el período de facturación (budget_interval).

Métricas

Column	Tipo	Ejemplo	Fórmula	Descripción
imps	Entero	234123	Diablillos	El número total de impresiones servidas.
attributed_revenue	dinero	10.45	post_view_revenue + post_click_revenue	El importe de los ingresos de todas las visualizaciones y clics de publicaciones registrados.
attributed_pc_revenue	dinero	121.68	post_click_revenue	El importe de los ingresos de todas las visualizaciones de publicaciones registradas.
attributed_pv_revenue	dinero	14	post_view_revenue	El importe de los ingresos de todos los clics de publicaciones registrados.
clicks	Entero	545	clics	El número total de clics en todas las impresiones.
click_convs_rate	double	0.057	total_convs / clics	La tasa de conversiones a clics.
click_conv_rate	double	0.000064	total_convs / clics	La tasa de conversiones a clics. Nota: Este campo es idéntico a click_convs_rate.
click_thru_pct	double	0.000%	Clics / Diablillos	El porcentaje de usuarios que han hecho clic en una creatividad para ver una creatividad.
cpa	dinero	1.25	booked_revenue_dollars / (post_view_convs + post_click_convs)	El coste por adquisición.
cpc	dinero	0.45	booked_revenue_dollars / clics	El coste por clic.
cpm	dinero	0.18	(booked_revenue_dollars / diablillos) * 1000	El coste por 1000 impresiones.
post_view_convs	Entero	75	post_view_convs	El número total de conversiones de visualización de publicación registradas.
post_view_revenue	dinero	150.00	post_view_revenue	El importe total de los ingresos registrados de la visualización de publicaciones.
post_click_convs	Entero	15	post_click_convs	Número total de conversiones de clics de publicación registradas.
post_click_revenue	dinero	300.00	post_click_revenue	El importe total de los ingresos por clic de publicación registrados.
total_revenue	dinero	450.00	post_view_revenue + post_click_revenue	La cantidad total de ingresos por visualización de publicaciones y clics de publicaciones.
total_convs	Entero	90	post_view_convs + post_click_convs	El número total de conversiones de visualización de publicación y de clics de publicaciones.
conv_rate	double	0.018654	(post_click_convs + post_view_convs) / diablillos	La tasa de conversiones en impresiones de publicaciones y clics y vistas de publicaciones.
convs_rate	double	0.0003844	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.
ecpa_adv_curr	dinero	1.13	booked_revenue_adv_curr / (post_view_convs + post_click_convs)	El coste por adquisición en el tipo de moneda del anunciante.
ecpc_adv_curr	dinero	0.16	booked_revenue_adv_curr / clics	El coste por clic en el tipo de moneda del anunciante.
ecpm_adv_curr	dinero	0.014	booked_revenue_adv_curr / diablillos * 1000	El coste por 1000 impresiones en el tipo de moneda del anunciante.
post_view_convs_rate	double	0.000320	post_view_convs / diablillos	La tasa de conversiones de visualización de publicaciones a impresiones.
post_click_convs_rate	double	0.000064	post_click_convs / diablillos	La tasa de conversiones de post clic en impresiones.
post_click_conversion_pixel	Entero	52	post_click_convs para ese pixel_id	El número de conversiones de clic de publicación de un píxel específico. Para obtener más información sobre cómo atribuimos las conversiones posteriores a la vista (y otras), atribución de conversiones (monetizar) o atribución de conversiones (invertir).
post_click_revenue_pixel	dinero	184.25	post_click_revenue para ese pixel_id	La cantidad de ingresos obtenidos para un píxel específico.
post_view_conversion_pixel	Entero	174	post_view_convs para ese pixel_id	Número de conversiones de visualización de publicaciones de un píxel específico. Para obtener más información sobre cómo atribuimos las conversiones posteriores a la vista (y otras), consulte Atribución de conversiones (monetizar) o Atribución de conversiones (invertir).
post_view_revenue_pixel	dinero	303.54	post_view_revenue para ese pixel_id	La cantidad de ingresos obtenidos para un píxel específico.
ppm	dinero	0.944966292134831	(ganancias / imps) x 1000	El beneficio por cada 1000 impresiones.
rpm	dinero	2.60548314606741	(ingresos / diablillos) x 1000	Los ingresos por cada 1000 impresiones.
spend_adv_curr	dinero	357.18	booked_revenue_adv_curr	El importe total gastado 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 para un píxel específico.
ctr	double	0.002327	Clics / Diablillos	La tasa de clics a impresiones.
spend	dinero	304.36	gasto	El gasto total del especialista en marketing en compras de medios directas y en tiempo real.
media_cost	dinero	2.15	Costo multimedia	El importe total gastado para comprar todas las impresiones.
ecpm	dinero	1.30	(gasto / diablillos) x 1000	El gasto efectivo del anunciante por cada 1000 impresiones.
ecpc	dinero	1.25	Gasto / clics	El gasto por clic efectivo del anunciante.
ecpa	dinero	1.20	gasto / total_convs	El gasto eficaz del anunciante por conversión/adquisición.
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)
avg_bid_reduction	double	18%	avg_bid_reduction	La reducción media de la puja que has obtenido en la línea de pedido o la campaña. Este valor representa la diferencia (como porcentaje) entre tu puja y el coste real de medios que pagaste por la impresión que ganaste (por ejemplo, debido a la reducción de la puja). Este valor solo es válido para las pujas RTB (es decir, no administradas). 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	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	video_starts	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	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 la duración total.
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 se reprodujeron las creatividades de vídeo durante toda la duración.
video_served	Entero	10	video_served	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	video_errors	El número total de veces que se ha producido un error de vídeo.
revenue_per_video_complete	dinero	25.76	revenue_per_video_complete	Los ingresos por finalización del vídeo.
cost_per_video_complete	dinero	22.76	cost_per_video_complete	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%	video_start_rate	El porcentaje de veces que se ha descargado e iniciado el primer segmento del vídeo creativo.
video_skip_rate	double	1.12359550561797%	video_skip_rate	El porcentaje de veces que el usuario ha optado por omitir el vídeo.

Ejemplos

Crear 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 el estado del informe desde el servicio de informes

Realice una GET llamada con el id. de informe para recuperar el estado del informe. Continúe realizando esta llamada hasta que se execution_status ."ready" Después, 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 del informe, pero esta vez al servicio de descarga de informes . Puede encontrar el servicio y el ID del informe en el campo URL de la respuesta anterior GET . Al identificar el archivo en el que desea guardarlo, asegúrese de usar la extensión de archivo que especificó en POSTel "format" archivo .

$ 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.