Análisis de vídeo de anunciantes de red

Artículo
05/18/2024

El informe de Network Advertiser Video Analytics se puede usar para ver las métricas de eventos de vídeo de un anunciante específico que es más detallado que los datos proporcionados en el informe de Network Video Analytics . Este informe solo está disponible para los usuarios de red.

Nota:

Las métricas de vídeo solo se graban para las creatividades vastas.

Para obtener instrucciones de uso, consulte el ejemplo siguiente. Tenga en cuenta que este informe requiere que se especifique un 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 se puede establecer en uno de los siguientes:

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

Período de retención de datos

Los datos de este informe se conservan durante 420 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`	date	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`	date	No	`2010-02-01`	Día del mes.
`month`	date	date	`2010-02`	Mes del año.
`seller_member_id`	Entero	Yes	`567`	Identificador interno del miembro vendedor.
`seller_member_name`	string	No	`"AdMeld"`	Nombre para mostrar del miembro vendedor.
`seller_member`	string	No	`"AdMeld (567)"`	En desuso.
`advertiser_id`	Entero	Yes	`344`	El identificador interno del anunciante cuya campaña y creatividad sirvieron en la impresión.
`campaign_id`	Entero	Yes	`728`	Número para identificar la campaña.
`campaign_name`	string	No	`"Test"`	Nombre para mostrar de la campaña
`campaign`	string	No	`"Test (123)"`	En desuso.
`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. Para cualquier informe que contenga campañas, ( `split_id` 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`	Identificador de la creatividad. 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. Nota: Para los rastreadores de clics o impresiones externos, `creative_name` será `"External Clicks"` o `"External Imps"`.
`creative`	string	No	`"Q1 2010 728x90 (554)"`	En desuso.
`placement_id`	Entero	Yes	`567`	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	`"Photos 728x90"`	Nombre 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 `"All placement data older than 100 days"` como `placement_name`.
`placement`	string	No	`"Photos 728x90 (123)"`	En desuso.
`placement_code`	string	No	`"Placement Code"`	Código personalizado para la ubicación.
`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 cadena normalmente identifica la oferta.
`deal_id`	Entero	Yes	`2345`	El identificador de la transacción. Para obtener más información sobre las ofertas negociadas entre compradores y vendedores, consulte Servicio de oferta y Servicio de acceso de compradores 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.
`size`	string	Sí	`"728x90"`	Tamaño de la creatividad/ubicación
`geo_country`	string	Sí	`"US"`	Código de país geográfico
`geo_country_name`	string	No	`"Unites States"`	Nombre del país
`creative_recency_bucket`	string	Sí	`"11-20"`	Cubo de la fecha en que se mostró la creatividad. Consulte Cubos de recencia creativa a continuación para ver los valores posibles.
`creative_recency_bucket_id`	string	No	`"4"`	Identificador del cubo de recencia creativa. Consulte Cubos de recencia creativa a continuación para ver los valores posibles.
`creative_frequency_bucket`	string	Sí	`"15-30 minutes"`	Cubo de la frecuencia con la que se mostró la creatividad. Consulte Cubos de frecuencia creativa a continuación para ver los valores posibles.
`creative_frequency_bucket_id`	string	No	`"3"`	Identificador del cubo de frecuencia creativa. Consulte Cubos de frecuencia creativa a continuación para ver los valores posibles.
`insertion_order_id`	Entero	Yes	`654`	Identificador del orden de inserción
`insertion_order_name`	string	No	`"Insertion Order Name"`	Nombre del orden de inserción
`insertion_order`	string	No	`"Insertion Order Name (654)"`	En desuso.
`line_item_id`	Entero	Yes	932	Número para identificar el elemento de línea
`line_item_name`	string	No	`"$3 CPM Verizon Remarketing"`	Nombre para mostrar del elemento de línea
`line_item`	string	No	`"$3 CPM Verizon Remarketing (932)"`	En desuso.
`publisher_id`	Entero	Yes	`321`	Número para identificar el publicador
`publisher_name`	string	No	`"Test"`	Nombre para mostrar del publicador
`publisher`	string	No	`"Test (123)"`	En desuso.
`trafficker_for_insertion_order`	string	Sí	`"Chris Mack"`	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í	`"Jonathan Smith"`	El representante de ventas del pedido de inserción. Vea el `"labels"` campo en el servicio de pedido de inserción para obtener más detalles.
`site_domain`	string	no	`bestsiteever.com`	Dominio donde se produjo la impresión. En el caso de las aplicaciones móviles, puede ser la dirección URL de la ubicación de la aplicación en la tienda de aplicaciones. Hay dos valores adicionales que pueden aparecer en lugar de un dominio, específicamente: `"deals.unknown"` o `"managed.unknown"`. Esto significa que no recibimos un dominio válido como referencia. Por ejemplo, el dominio puede estar en blanco o de otro modo malformado.
`application_id`	string	Sí	`'343200656' (iOS)` o `com.rovio.angrybirds'(Android)`	Un identificador de apple App Store de destino, un nombre de paquete de Google Play o un identificador de aplicación de Windows.
`supply_type`	string	Sí	`mobile_web`	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"`.
`video_playback_method`	string	Sí	`"1"`	Método de reproducción para la creatividad. Consulte El método de reproducción de vídeo siguiente para ver los valores posibles.
`video_context`	string	Sí	`"3"`	Tipo de la creatividad de vídeo. Consulte Contexto de vídeo a continuación para ver los valores posibles.
`video_player_size_id`	string	Sí	`"2"`	Identificador del ancho del reproductor de vídeo. Consulta Tamaño del reproductor a continuación para ver los valores posibles.
`video_content_genre`	string	No	`"action"`	El género principal del programa en el que se reproducirá el anuncio. Por ejemplo, `Action`, `Adventure`, `Biography`, `Business`, , `Comedy`etc.
`video_program_type`	string	No	`"series"`	Categorización de nivel superior del formato del programa de vídeo en el que se reproducirá el anuncio. Por ejemplo, , `SeriesMovie`, `Special`, `Show`, `Event`, , `Clip`etc.
`video_content_rating`	string	No	`"teens"`	Grupo de audiencias identificado por el publicador para el que se clasifica el contenido. Por ejemplo, , `AllChildren (7+)` , `Teens (13+)`, `Young Adults (14+)`o `Adults (18+)`.
`content_duration_secs`	Entero	Yes	`480`	Longitud del contenido del vídeo en segundos.
`device_type`	string	Sí	`Desktops & Laptops, Mobile Phones, Tablets, TV, Game Consoles, Media Players, Set Top Box, and Other Devices.`	Tipo de dispositivo en el que se estableció la creatividad para reproducirse.
`video_content_duration`	Entero	Yes	`100`	Longitud del contenido del vídeo en segundos.
`video_content_language`	string	No	`"Spanish"`	Idioma del programa de vídeo en el que se reproducirá el anuncio. Por ejemplo, `Spanish`.
`video_content_network`	string	No	`"AMC"`	La red que entrega el contenido de vídeo. Por ejemplo, `9 Story`, `CBC`, `Disney`, `AMC`, , `Fox`etc.
`video_delivery_type`	string	No	`"vod"`	Tipo de entrega de contenido de streaming. Por ejemplo, `Video On Demand (VOD)` y `Live`.

Nota:

Los datos de las siguientes dimensiones solo están disponibles si el publicador ha implementado la taxonomía de vídeo.

video_content_genre
video_program_type
video_content_rating
video_content_duration
video_content_language
video_content_network
video_delivery_typ

Métricas

Column	Tipo	Ejemplo	Fórmula	Descripción
`imps`	Entero	`234123`	Duendes	Número total de impresiones servidas.
`clicks`	Entero	`545`	Clics	Número total de clics en todas las impresiones.
`post_view_convs`	Entero	`75`	post_view_convs	Número total de conversiones posteriores a la vista registradas.
`post_click_convs`	Entero	`15`	post_click_convs	Número total de conversiones registradas después de hacer clic.
`total_convs`	Entero	`90`	post_click_convs + post_view_convs	Número total de conversiones posteriores y posteriores al clic.
`convs_rate`	double	`0.0003844`	total_convs/imps	Tasa de conversiones a impresiones.
`post_view_convs_rate`	double	`0.000320`	post_view_convs/imps	Tasa de conversiones posteriores a la vista en impresiones.
`post_click_convs_rate`	double	`0.000064`	post_click_convs/imps	Tasa de conversiones posteriores al clic en impresiones.
`ctr`	double	`0.2327836`	clics o imps	Tasa de clics en impresiones.
`profit`	dinero	`350.00`	booked_revenue: total_cost	Ingresos reservados menos costo total.
`revenue_ecpm`	dinero	`1.9221`	booked_revenue/clics	Ingresos totales por 1000 impresiones.
`cost_ecpm`	dinero	`0.4271259`	media_cost/imps * 1000	El costo por 1000 impresiones.
`profit_ecpm`	dinero	`0.4949`	beneficio/imps * 1000	El beneficio por 1000 impresiones. "Beneficio" se define como ingresos reservados menos costo total.
`revenue_ecpc`	dinero	`0.8256`	booked_revenue/clics	Ingresos totales por clic.
`revenue_ecpa`	dinero	`5.00`	booked_revenue/total_convs	Ingresos totales por conversión.
`cost_ecpc`	dinero	`0.1834`	media_cost/clics	Costo por clic.
`cost_ecpa`	dinero	`1.1111`	media_cost/total_convs	Costo por adquisición o conversión.
`profit_margin`	dinero	`0.7778`	booked_revenue	Beneficio dividido por `booked_revenue`. "Beneficio" se define como ingresos reservados menos costo total.
`media_cost`	dinero	`100.00`	media_cost	Cantidad total gastada.
`errors`	Entero	`5`	errores	Número total de veces que se produjo un error.
`starts`	Entero	`360`	Comienza	El número total de veces que se descargó e inició el primer segmento de la creatividad de vídeo.
`start_rate`	double	`25.85`	starts/imps	El número de inicios de vídeo se divide por el número de impresiones.
`skips`	Entero	`20`	Salta	Número total de veces que un usuario omitió el vídeo.
`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 de vídeo completaron el 25 % de toda la duración.
`50_pcts`	Entero	`654`	50% completado	El número total de veces que el vídeo completó el 50 % de toda la duración del tiempo.
`75_pcts`	Entero	`567`	75% completado	El número total de veces que el vídeo completó el 75 % de toda la duración del tiempo.
`completions`	Entero	`989`	100% completado	El número total de veces que se reproduce el vídeo durante todo el tiempo.
`completion_rate`	double	`85.4`5	completions/imps	Número de finalizaciones de vídeo divididas por el número de impresiones.
`revenue_per_video_complete`	double	`15.869`	ingresos o finalizaciones	Ingresos por finalización de vídeo.
`cost_per_video_complete`	double	`2.056`	costo/finalizaciones	Costo por finalización de vídeo.
`served`	Entero	`87649`	impresiones de vídeo servidas	El número total de impresiones de vídeo que se sirven. Nota: Un imp hace referencia a cuando el reproductor de vídeo carga el vídeo e inicia el primer fotograma. Vídeos servidos hace referencia al documento VAST que se está entregando en respuesta a una solicitud del reproductor de vídeo.
`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)
`total_cost`	dinero	`123.45`	total_cost = media_cost + data_costs + partner_fees + comisiones + serving_fees + publisher_revenue	Importe total de los costos acumulados durante el período de tiempo notificado. Por lo general, esto incluye dos tipos de costos, costos presupuestados (costo de medios, costo de datos, cuotas de asociados, cuotas de servicio, comisiones) e ingresos del publicador si realiza un seguimiento de los pagos del publicador en la plataforma. Nota: Hemos agregado lógica para evitar el recuento doble de cuotas de terceros durante el período de cambio importante.
`total_cost_ecpm`	dinero	`123.45`	(total_cost/imps) * 1000	Costo total por 1000 imps.
`total_cost_ecpc`	dinero	`123.45`	total_cost/clics	Costo total por clic.
`total_cost_ecpa`	dinero	`123.45`	total_cost/conversiones	Costo total por conversión.
`profit_ecpc`	dinero	`123.45`	(booked_revenue - total_cost)/clicks	Beneficio por clic.
`profit_ecpa`	dinero	`123.45`	(booked_revenue - total_cost)/conversiones	Beneficio por conversión.
`Average View Time`	Entero	`28`	sum (creative_duration * ((0,125 × comienza) + (0,25 × first_quartiles) + (0,25 × second_quartiles) + (0,25 × third_quartiles) + (0,125 × finalizaciones)) / suma (inicios))	Estimación de la duración media en segundos (redondeada a 0 posiciones decimales) de la creatividad que se ha visto. Esto se calcula aproximando la duración observada como el punto medio entre los eventos de vídeo (por ejemplo, un evento de inicio calcularía que se ve el 12,5 % de la creatividad).
`Average View Time Percent`	porcentaje	`89%`	sum (((0,125 × starts) + (0,25 × first_quartiles) + (0,25 × second_quartiles) + (0,25 × third_quartiles) + (0,125 × finalización))∕ comienza)	Tiempo medio de vista expresado como porcentaje del tiempo de vista total posible.

Cubos 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+"`

Cubos 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"`

Método de reproducción de vídeo

Id. de método	Método
`0`	`Unknown`
`1`	`Auto-play, sound on`
`2`	`Auto-play, sound off`
`3`	`Click-to-play`
`4`	`Mouse-over`
`5`	`Auto-play, sound unknown`

Contexto de vídeo

Id. de método	Método
`0`	`Unknown`
`1`	`Pre-roll`
`2`	`Mid-roll`
`3`	`Post-roll`
`4`	`Outstream`

Tamaño del reproductor

Id.	Nombre
`0`	`small`
`1`	`medium`
`2`	`large`

Ejemplo

Creación de una solicitud de informe JSON

El archivo JSON debe incluir el report_type de "video_analytics_network_advertiser", 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 video_analytics_network_advertiser

{"report":
    {
        "report_type":"video_analytics_network_advertiser",
        "columns":[
            "hour",
            "seller_member_id",
            "campaign_id",
            "imps",
            "starts",
            "75_pcts",
            "completions",
            "cost_per_video_complete",
            "served"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

`POST` la solicitud al servicio de informes

POST la solicitud JSON para recuperar un identificador de informe.

$ curl -b cookies -c cookies -X post -d @video_analytics_network_advertiser "https://api.appnexus.com/report?advertiser_id=690"

{
   "response":{
      "status":"OK",
      "report_id":"09b6979a6a4c3805bdac8921378d3622"
   }
}

`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=09b6979a6a4c3805bdac8921378d3622'

{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:15:48",
         "json_request":"{\"report\":{\"report_type\":\"video_analytics_network_advertiser\",\"columns\":
          [\"hour\",\"seller_member_id\",\"campaign_id\",\"imps\",\"starts\",\"75_pcts\",
          \"completions\",\"cost_per_video_complete\",\"served\"],\"row_per\":
          [\"hour\",\"seller_member_id\",\"campaign_id\"],
          \"report_interval\":\"last_48_hours\",\"filters\":[{\"advertiser_id\":\"690\"}]}}",
         "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 identificador de servicio e informe en el url campo de la respuesta a la llamada anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo del formato de archivo que especificó en la inicial POST.

Nota:

Si se produce un error durante la descarga, el encabezado de respuesta incluirá un código de error HTTP y un mensaje. Use -i o -v en la llamada para exponer el encabezado de respuesta.

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

Nota:

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

Servicio de informes

Compartir a través de

Análisis de vídeo de anunciantes de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Cubos de frecuencia creativa

Cubos de recencia creativa

Método de reproducción de vídeo

Contexto de vídeo

Tamaño del reproductor

Ejemplo

Creación de una solicitud de informe JSON

`POST` la solicitud al servicio de informes

`GET` estado del informe del servicio de informes

`GET` los datos del informe del servicio de descarga de informes

Recursos adicionales

Compartir a través de

Análisis de vídeo de anunciantes de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Cubos de frecuencia creativa

Cubos de recencia creativa

Método de reproducción de vídeo

Contexto de vídeo

Tamaño del reproductor

Ejemplo

Creación de una solicitud de informe JSON

POST la solicitud al servicio de informes

GET estado del informe del servicio de informes

GET los datos del informe del servicio de descarga de informes

Tema relacionado

Recursos adicionales

`POST` la solicitud al servicio de informes

`GET` estado del informe del servicio de informes

`GET` los datos del informe del servicio de descarga de informes