Análisis de audio de red

El informe análisis de audio de red se puede usar para ver las métricas de eventos de audio de un miembro de red.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Report Service o el ejemplo siguiente.

Período de tiempo

El report_interval campo se puede establecer en uno de los siguientes:

• last_available_day
• hoy
• last_24_hours
• yesterday
• last_48_hours
• last_7_days
• last_14_days
• last_7_available_days
• last_14_available_days
• month_to_date
• last_30_available_days
• month_to_yesterday
• last_30_days
• last_month
• last_100_days
• last_365_days

Período de retención de datos

Los datos de este informe tienen el siguiente período de retención:

• Retención por hora: 100 días
• Retención diaria: 500 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
hour	time	Yes	"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	Yes	"2010-02-01"	El día de la subasta.
month	time	No	"2010-02"	El mes de la subasta.
buyer_member_id	Entero	Yes	123	Identificador del miembro de compra de la impresión. Si no se compró la impresión, este campo muestra uno de los valores siguientes: 229 = PSA 0 = En blanco 319 = Valor predeterminado
buyer_member_name	string	No	"My Network"	Nombre del miembro comprador de la impresión.
buyer_member	string	No	"My Network (123)"	El nombre y el identificador del miembro de compra de la impresión.
creative_id	Entero	Yes	554	Identificador de la creatividad asociada a la impresión. Nota: Para los rastreadores de clics o impresiones externos, creative_id será "External Clicks" o "External Imps".
creative_name	string	No	"Q1 2010 728x90"	Nombre de la creatividad asociada a la impresión. Nota: Para los rastreadores de clics o impresiones externos, creative_id será "External Clicks" o "External Imps".
creative	string	No	"Q1 2010 728x90 (554)"	El nombre y el identificador de la creatividad asociada a la impresión.
member_id	Entero	Yes	767	Identificador del miembro.
seller_member_id	Entero	Yes	456	Identificador del miembro vendedor de la impresión.
seller_member_name	string	No	"That Seller"	Nombre del miembro vendedor de la impresión.
seller_member	string	No	"That Seller (456)"	El nombre y el identificador del miembro vendedor de la impresión.
advertiser_id	Entero	Yes	789	El id. del anunciante cuya creatividad sirvió en esta impresión. Si el valor es 0, la impresión la compró un comprador externo o se mostró o PSAdefault .
advertiser_name	string	No	"Verizon Wireless"	El nombre del anunciante cuyo creativo sirvió en esta impresión.
advertiser	string	No	"Verizon Wireless (789)"	El nombre y el identificador del anunciante cuya creatividad sirvió en esta impresión.
advertiser_currency	string	Sí	"USD"	La moneda del anunciante cuya creatividad sirvió en esta impresión.
publisher_id	Entero	Yes	321	Identificador del publicador en el que se produjo esta impresión en el inventario.
publisher_name	string	No	"Facebook"	Nombre del publicador en el que se produjo esta impresión en el inventario.
publisher	string	No	"Facebook (321)"	Nombre e identificador del publicador en el que se produjo esta impresión en el inventario.
publisher_currency	string	Sí	"USD"	Moneda del publicador en cuyo inventario se produjo esta impresión.
site_id	Entero	Yes	194	Identificador del sitio donde se produjo la impresión. Nota: Para las impresiones anteriores a 100 días, site_id será 0.
site_name	string	No	"Site Name"	Nombre del sitio donde se produjo la impresión.
site	string	No	"Site Name (194)"	El nombre y el identificador del sitio donde se produjo la impresión.
placement_id	Entero	Yes	456	Identificador de la ubicación a través de la que se produjo esta impresión. Nota: Para las impresiones anteriores a 100 días, las ubicaciones se agregarán en una fila con -1 como el identificador y un nombre genérico.
placement_name	string	No	"Ivillage 160x600"	Nombre de la ubicación a través de la que se produjo esta impresión. Nota: Para las impresiones anteriores a 100 días, las ubicaciones se agregarán en una fila con -1 como el identificador y un nombre genérico.
placement_code	string	No	"Ivillage Code"	Código personalizado para la ubicación.
placement	string	No	"Ivillage 160x600 (456)"	El nombre y el identificador de la ubicación a través de la que se produjo esta impresión.
insertion_order_id	Entero	Yes	321	Identificador del pedido de inserción con el que se compró esta impresión.
insertion_order_name	string	No	"Insertion Order"	Nombre del pedido de inserción con el que se compró esta impresión.
insertion_order	string	No	"Insertion Order (321)"	El nombre y el identificador del pedido de inserción con el que se compró esta impresión.
line_item_id	Entero	Yes	111	Identificador del artículo de línea con el que se compró esta impresión.
line_item_name	string	No	"Default Line Item"	Nombre del artículo de línea con el que se compró esta impresión.
line_item	string	No	"Default Line Item (111)"	El nombre y el identificador del elemento de línea con el que se compró esta impresión.
campaign_id	Entero	Yes	222	El identificador de la campaña que compró esta impresión. (No se aplica a todos los anunciantes).
campaign_name	string	No	"Default Campaign"	Nombre de la campaña que compró esta impresión. (No se aplica a todos los anunciantes).
campaign	string	No	"Default Campaign (222)"	El nombre y el identificador de la campaña que compró esta impresión. (No se aplica a todos los anunciantes).
campaign_group_type_id	Entero	Yes	987	Identificador del tipo de grupo de campaña usado en la generación de informes divididos.
size	string	Sí	"728x90"	Tamaño de la colocación/creatividad que se sirve en la impresión.
brand_id	Entero	Tes	3	Identificador de la marca asociada a una creatividad. Note: para imp_type_id = 6, no hay información disponible en el campo brand_id de este informe. Consulte el Informe de revisión de marca del vendedor en su lugar.
brand_name	string	No	"Ace Hardware"	Nombre de la marca asociada a un creativo. Nota: 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 vendedor en su lugar.
brand	string	No	"Ace Hardware (3)"	El nombre y el identificador de la marca asociada a una creatividad.
geo_country	string	Sí	"US"	El código del país o región geográfico en el que se produjo la impresión.
geo_country_name	string	No	"United States"	Nombre del país o región geográfico en el que se produjo la impresión.
deal_id	Entero	Yes	2345	Identificador de la transacción asociada a la transacción para la impresión. Nota: Para obtener más información sobre las ofertas negociadas entre compradores y vendedores, consulta Servicio de oferta y Servicio de acceso de compradores.
deal_name	string	No	"Private deal for buyer 1085 with floor of $2.50"	Nombre de la oferta asociada a la transacción para la impresión.
deal	string	No	"Private deal for buyer 1085 with floor of $2.50 (45)"	El nombre y el identificador de la transacción asociada a la transacción para la impresión.
trafficker_for_insertion_order	string	Sí	"Maurice Truman"	El tratante de la orden de inserción. Vea el "labels" campo en el servicio de pedido de inserción para obtener más detalles.
salesrep_for_insertion_order	string	Sí	"Beverly Heller"	El representante de ventas del pedido de inserción. Para obtener más información, consulte el "labels" campo del servicio de pedido de insercióne.
creative_recency_bucket_id	string	no	"4"	Identificador del cubo de recencia creativa. Consulte Creative Recency Bucket para ver los valores posibles.
creative_recency_bucket	string	sí	"15-30 minutes"	Cubo de la fecha en que se mostró la creatividad. Consulte Creative Recency Bucket para ver los valores posibles.
creative_frequency_bucket	string	sí	"11-20"	Cubo de la frecuencia con la que se mostró la creatividad. Consulte Cubo de frecuencia creativa para ver los valores posibles.
creative_frequency_bucket_id	string	no	"3"	Identificador del cubo de frecuencia creativa. Consulte Cubo de frecuencia creativa para ver los valores posibles.
site_domain	string	no	bestsiteever.com	Dominio del sitio asociado a una impresión.
supply_type_filterable	string	sí	"web"	Si se va a filtrar por tipo de suministro. El canal clasificado por el vendedor para denominar el suministro en términos de web, web optimizado para dispositivos móviles e impresiones de aplicaciones móviles. Los valores posibles son: - "web" - "mobile_app" - "mobile_web"
media_subtype	Entero	sí	3	Subtipo multimedia para la creatividad que significa el estilo de visualización específico de las creatividades.
creative_duration	Entero	sí	15	Longitud del anuncio en segundos.
split_id	Entero	sí	889	Identificador de la división del artículo de línea en el que se compró esta impresión.
split_name	string	no	"split1"	Nombre de la división del artículo de línea con el que se compró esta impresión.
split	string	no	"split1(889)"	El nombre y el identificador de la división del elemento de línea con el que se compró esta impresión.
content_duration_secs	Entero	sí	12	Longitud de la duración del contenido en segundos.
content_delivery_type_id	Entero	sí	889	Identificador del tipo de entrega de contenido de streaming. Por ejemplo, Live, Video On Demand (VOD).
content_genre_id	Entero	sí	771	El id. del género principal del programa en el que se reproducirá el anuncio. Por ejemplo, Game-Show, History, Music.
content_program_type_id	Entero	sí	987	Identificador de categorización de nivel superior del programa en el que se reproducirá el anuncio. Por ejemplo, Movie, Series, Special, Show, , , EventClip
content_rating_id	Entero	sí	322	Identificador del tipo de clasificación del contenido. Por ejemplo, All, Children (7+), Teens (13+), , Young Adults (14+)Adults (18+)
deal_alias	string	No	"Deal1"	Alias de la oferta, como aparecerá en la interfaz de usuario.
mobile_application_id	Entero	Yes	77775	Identificador de la aplicación móvil en el dispositivo donde se produjo la impresión.
buying_currency	string	Sí	"USD"	Moneda de transacción que el comprador usó para comprar esta impresión.
audio_context	string	Sí	"pre-roll"	Tipo de la creatividad de audio. Consulte Contexto de audio a continuación para ver los valores posibles.

Métricas

Column	Tipo	Ejemplo	Fórmula	Descripción
imps	Entero	2340	Duendes	El número total de impresiones (servidas y revendidas).
clicks	Entero	1	Clics	Número total de clics en todas las impresiones.
cost	dinero	16.833378	costar	Cantidad total de costo de medios para el publicador directo y el inventario comprado en tiempo real.
revenue	dinero	25.767257	booked_revenue + reseller_revenue	La suma de los ingresos reservados y los ingresos del revendedor.
profit	dinero	0.084102	ingresos: costo	Los ingresos totales de red menos el costo de red.
cpm	dinero	1.66051685393258	(costo /imps) x 1000	El costo por 1000 impresiones.
total_convs	Entero	5	total_convs	Número total de conversiones posteriores y posteriores al clic.
convs_rate	double	0.000221877080097626	total_convs/imps	Tasa de conversiones a impresiones.
ctr	double	0.000221877080097626	clics o imps	Tasa de clics en impresiones.
total_network_rpm	dinero	2.60548314606741	(network_revenue/imps) x 1000	Ingresos de red por cada 1000 impresiones.
errors	Entero	5	errores	Número total de veces que se produjo un error.
starts	Entero	360	Comienza	Número total de veces que se descargó e inició el primer segmento de la creatividad.
start_rate	double	25.85	starts/imps	El número de creatividades comienza dividido por el número de impresiones.
skips	Entero	20	Salta	Número total de veces que un usuario omitió las creatividades.
skip_rate	double	20.5	skips/imps	El número de saltos de vídeo dividido por el número de impresiones.
25_pcts	Entero	780	25% completado	El número total de veces que las creatividades completaron el 25 % de toda la duración.
50_pcts	Entero	654	50% completado	El número total de veces que las creatividades completaron el 50 % de toda la duración del tiempo.
75_pcts	Entero	567	75% completado	El número total de veces que las creatividades completaron el 75 % de toda la duración del tiempo.
completions	Entero	989	100% completado	El número total de veces que los creativos jugaron durante todo el tiempo.
completion_rate	double	85.45	completions/imps	El número de finalizaciones de creatividades dividido por el número de impresiones.
revenue_per_audio_complete	double	15.869	ingresos o finalizaciones	Los ingresos por finalización creativa de audio.
cost_per_audio_complete	double	2.056	costo/finalizaciones	Costo por finalización creativa de audio.
audio_fill	double	7.889	total de imps/impresiones de audio servidas	Número total de imps dividido por audio servido.
ad_responses	Entero	9999	ad_responses	Número total de respuestas de anuncios de audio.
served	Entero	87649	impresiones de audio servidas	Número total de impresiones de audio que se sirven.
device_type	string	"tablets"	device_type	Tipo de dispositivo en el que se ha servido la impresión. Los posibles valores son: - desktops & laptops - tablets - mobile phones - tv - game consoles - set top box - media players - other devices

Cubo de recencia creativa

Id. de bucket	Nombre del cubo
-2	"no-cookie-date"
-1	"no-cookie"
0	"< 1 minute"
1	"1-5 minutes"
2	"5-15 minutes"
3	"15-30 minutes"
4	"30-60 minutes"
5	"1-4 hours"
6	"4-12 hours"
7	"12-24 hours"
8	"1-2 days"
9	"2-7 days"
10	"8-14 days"
11	"14-30 days"

Cubo de frecuencia creativa

Id. de bucket	Nombre del cubo
-2	"no-cookie-date"
-1	"no-cookie"
0	"0"
1	"1"
2	"2-5"
3	"6-10"
4	"11-20"
5	"21-40"
6	"41-60"
7	"61-100"
8	"101-150"
9	"151-250"
10	"251-500"
11	"500+"

Contexto de audio

Id. de método	Método
0	"unknown"
1	"pre-roll"
2	"mid-roll"
3	"post-roll"
4	"outstream"

Ejemplo

Creación de una solicitud de informe con formato JSON

El archivo JSON debe incluir , report_type"audio_analytics_network"así como las columnas (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (year, month, day) y especificar el formato en el que se deben devolver los datos (csv, excelo html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.

$ cat audio_analytics_network 
{
   "report":{
      "report_type":"audio_analytics_network",
      "columns":[
         "seller_member_name",
         "audio_context",
         "imps",
         "clicks",
         "ctr",
         "convs_rate",
         "starts",
         "25_pcts",
         "50_pcts",
         "75_pcts",
         "completions"
      ],
      "report_interval":"last_48_hours",
      "format":"csv"
   }

POST la solicitud al servicio de informes

$ curl -b cookies -c cookies -X POST -d @audio_analytics_network 'https://api.appnexus.com/report' 
{ "response":{ 
    "status":"OK", 
    "report_id":"097f59fc3ab7d02c5d60db42081d9b69" 
    } 
}

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 servicio de descarga de informes 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=097f59fc3ab7d02c5d60db42081d9b69' 
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2021-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"audio_analytics_network\",\"columns\":[\"hour\",\"seller_member_name\",\"audio_context\", \"imps\",\"clicks\",\"ctr\",\"25_pcts\",\"50_pcts\",\"75_pcts\",\"completions\",\"convs_rate\"], \"row_per\":[\"hour\",\"seller_member_name\"], \"report_interval\":\"last_48_hours\"}}",
         "url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "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 servicio y el identificador de informe en el url campo 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.

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

Nota:

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