Análisis de vídeo del publicador de red

Artículo
11/04/2024

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

Nota:

video_content_genre las métricas de vídeo solo se graban para los creativos de VAST.

Para obtener instrucciones de uso, consulte el ejemplo siguiente. Tenga en cuenta que este informe requiere que se especifique un identificador de publicador como parte de la dirección URL, por ejemplo:

https://api.appnexus.com/report?publisher_id=PUBLISHER_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
month_to_date
month_to_yesterday
last_available_day
last_7_available_days
last_14_available_days
last_30_available_days
last_month

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"`	El día de la subasta.
`month`	date	no	`"2010-02"`	El mes de la subasta.
`member_id`	Entero	Yes	`767`	Identificador del miembro.
`buyer_member_id`	Entero	sí	`567`	Identificador del miembro de compra.
`buyer_member_name`	string	no	`"Network"`	Nombre del miembro que compra.
`advertiser_id`	Entero	sí	`728`	El identificador del anunciante.
`advertiser_name`	string	no	`"Test"`	Nombre del anunciante.
`brand_id`	Entero	sí	`3`	Identificador de la marca asociada a una creatividad. 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_name`	string	no	`"Ace Hardware"`	Nombre de la marca asociada a un creativo. Para `imp_type_id = 6`, no hay información disponible en el `brand_name` campo para este informe. Consulte el Informe de revisión de marca del vendedor en su lugar.
`publisher_id`	Entero	sí	`6787`	Número para identificar el publicador.
`publisher_currency`	string	sí	`"USD"`	Moneda del publicador.
`site_id`	Entero	sí	`194`	Identificador del sitio. Nota: Para las impresiones anteriores a 100 días, `site_id` será `0`.
`site_name`	string	no	`"Site Name"`	Nombre del sitio.
`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.
`geo_country`	string	sí	`"US"`	Código de país geográfico.
`geo_country_name`	string	no	`"United States"`	Nombre del país.
`placement_id`	Entero	sí	`546`	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	`"300x250 Business"`	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_code`	string	no	`"300x250 Business Code"`	Código personalizado para la ubicación.
`site_domain`	string	no	`bestsiteever.com`	Dominio del sitio de una impresión.
`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"`	Cuándo y dónde se reproduce 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_delivery_type1`	string	No	`"vod"`	Tipo de entrega de contenido de streaming. Por ejemplo, `Video On Demand (VOD)` y `Live`.
`video_content_genre1`	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_type1`	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_rating1`	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_duration1`	Entero	Yes	`100`	Longitud del contenido del vídeo en segundos.
`video_content_language1`	string	No	`"Spanish"`	Idioma del programa de vídeo en el que se reproducirá el anuncio. Por ejemplo, `Spanish`.
`video_content_network1`	string	No	`"AMC"`	La red que entrega el contenido de vídeo. Por ejemplo, `9 Story`, `CBC`, `Disney`, `AMC`, , `Fox`etc.

Nota:

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

video_delivery_type
video_content_genre
video_program_type
video_content_rating
video_content_duration
video_content_language
video_content_network

Métricas

Column	Tipo	Ejemplo	Fórmula	Descripción
`imps`	Entero	`2340`	Duendes	Número total de impresiones.
`clicks`	Entero	`545`	Clics	Número total de clics en todas las impresiones.
`total_convs`	Entero	`90`	post_click_convs + post_view_convs	Número total de conversiones posteriores y posteriores al clic.
`ctr`	double	`0.2327836`	clics/ imps * 100	Tasa de clics en impresiones.
`convs_rate`	double	`0.0384413`	total_convs /imps * 100	Tasa de conversiones a impresiones.
`network_revenue`	dinero	`1201.13`	network_revenue	Ingresos de red reservados a través de anunciantes directos y revendidos a compradores en tiempo real
`total_network_rpm`	dinero	`2.60548314606741`	(network_revenue/imps) x 1000	Ingresos de red por cada 1000 impresiones.
`publisher_revenue`	dinero	`400.05`	publisher_revenue	Los ingresos pagados al editor (en función de revshare o cpm).
`network_profit`	dinero	`801.08`	(booked_revenue + reseller_revenue): total_cost	Beneficio de red menos costo total.
`network_roi`	double	`2.94`	(network_revenue/media_cost) - 1	En desuso. Retorno de la red de la inversión. Se devuelve como un porcentaje, por ejemplo, 0,94 = 94 %
`sold_network_rpm`	double	`231.888`	(ingresos/imps) x 1000 ----- sin errores	Ingresos por 1000 impresiones que no eran errores.
`total_publisher_rpm`	dinero	`1.6605168` `5393258`	(costo /imps) x 1000	Costo por cada 1000 impresiones pagadas a publicadores directos y de terceros, incluidos errores.
`sold_publisher_rpm`	double	`147.786`	(costo /imps) x 1000 ----- sin errores	Costo por cada 1000 impresiones pagadas a editores directos y de terceros, sin incluir errores.
`network_ppm`	dinero	`9.23`	(beneficio /imps) x 1000	En desuso. El beneficio por 1000 impresiones.
`imps_sold`	Entero	`42500`	imps_sold	Número de impresiones que ha vendido a otros miembros.
`video_errors`	Entero	`23`	errores	El número total de errores que atienden las impresiones de vídeo
`ad_responses`	Entero	`2340`	Servido	Número de respuestas entregadas al explorador del usuario (o servidor de mediación). Una respuesta puede dar lugar a una impresión, un error en el reproductor o una subasta sin evento de impresión. 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.
`network_profit_ecpm`	dinero	`123.45`	((booked_revenue + reseller_revenue - total_cost)/imps) * 1000	Beneficio de red por 1000 imps.
`network_profit_ecpc`	dinero	`123.45`	(booked_revenue + reseller_revenue - total_cost)/clicks	Beneficio de red por clic.
`network_profit_ecpa`	dinero	`123.45`	(booked_revenue + reseller_revenue - total_cost)/conversions	Beneficio de red por conversión.
`network_profit_margin`	dinero	`123.45`	(booked_revenue + reseller_revenue - total_cost)/(booked_revenue + reseller_revenue)	Margen de beneficio de red.
`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 × inicia) + (0,25 × first_quartiles) + (0,25 × second_quartiles) + (0,25 × third_quartiles) + (0,125 × finalizaciones))∕inicia)	Tiempo medio de vista expresado como porcentaje del tiempo de vista total posible.

Método de reproducción de vídeo

Id. de método	Método
`0`	Unknown
`1`	Reproducción automática, sonido activado
`2`	Reproducción automática, sonido desactivado
`3`	Hacer clic y reproducir
`4`	Pasar el mouse sobre
`5`	Reproducción automática, sonido desconocido

Contexto de vídeo

Id. de método	Método
`0`	Unknown
`1`	Pre-roll
`2`	Mitad del lanzamiento
`3`	Post-roll
`4`	Flujo de salida

Tamaño del reproductor

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

Ejemplo

Creación de una solicitud de informe con formato JSON

$ cat video_analytics_network_publisher
{
    "report":
    {
        "report_type":"video_analytics_network_publisher",
        "columns":[
            "hour",
            "buyer_member",
            "brand_name",
            "deal_name",
            "deal_id",
            "imps_sold",
            "video_errors",
            "total_convs",
            "served"
        ],
        "row_per":[
            "hour",
            "buyer_member",
            "sold_network_rpm"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

`POST` la solicitud al servicio de informes

$ curl -b cookies -c cookies -X post -d @video_analytics_network_publisher "https://api.appnexus.com/report?publisher_id=4642"
{
   "response":{
      "status":"OK",
      "report_id":"f4ebb93755dd01dde4fc157f86198ea9"
   }
}

`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 GET llamada hasta que execution_status sea "ready". A continuación, use el servicio de descarga de informes para guardar los datos del informe en un archivo, como se describe en el paso siguiente.

$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=f4ebb93755dd01dde4fc157f86198ea9"
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:37:31",
         "json_request":"{\"report\":{\"report_type\":\"video_analytics_network_publisher\",\"columns\":[\"hour\",\"buyer_member\",\"brand_name\",
            \"deal_name\",\"deal_id\",\"imps_sold\",\"video_errors\",\"total_convs\",\"served\"],
            \"row_per\":[\"hour\",\"buyer_member\",\"sold_network_rpm\"],\"report_interval\":\"last_48_hours\",
            \"filters\":[{\"publisher_id\":\"4642\"}]}}",
         "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.

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_publisher.csv

Nota:

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

Compartir a través de

Análisis de vídeo del publicador de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Método de reproducción de vídeo

Contexto de vídeo

Tamaño del reproductor

Ejemplo

Creación de una solicitud de informe con formato 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 del publicador de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Método de reproducción de vídeo

Contexto de vídeo

Tamaño del reproductor

Ejemplo

Creación de una solicitud de informe con formato 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

`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