Compartir a través de


Análisis de vídeo de red

El informe de Network Video Analytics se puede usar para ver las métricas de eventos de vídeo de un miembro de red. Para profundizar en análisis más detallados para un anunciante o publicador específico, consulte los informes Network Video Advertiser Analytics y Network Video Publisher Analytics .

Nota:

  • Las métricas de vídeo solo se graban para las creatividades vastas.
  • Para obtener instrucciones sobre cómo recuperar un informe, consulte Report Service o los ejemplos siguientes.

Período de tiempo

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

  • hoy
  • yesterday
  • last_hour
  • last_24_hours
  • last_48_hours
  • month_to_date
  • month_to_yesterday
  • last_2_days
  • last_7_days
  • last_14_days
  • last_30_days
  • last_7_available_days
  • last_14_available_days
  • last_30_available_days
  • 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 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. 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 que compra.
buyer_member string No "My Network (123)" En desuso (a partir del 17 de octubre de 2016).
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 "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_id será "External Clicks" o "External Imps".
creative string No "Q1 2010 728x90 (554)" En desuso (a partir del 17 de octubre de 2016).
member_id Entero Yes 767 Identificador del miembro.
seller_member_id Entero Yes 456 Identificador del miembro vendedor.
seller_member_name string No "That Seller" Nombre del miembro vendedor.
seller_member string No "That Seller (456)" En desuso (a partir del 17 de octubre de 2016).
advertiser_id Entero Yes 789 El identificador del anunciante. Si el valor es 0, un comprador externo compró la impresión o se mostró un valor predeterminado o PSA.
advertiser_name string No "Verizon Wireless" Nombre del anunciante.
advertiser string No "Verizon Wireless (789)" En desuso (a partir del 17 de octubre de 2016).
advertiser_currency string "USD" Moneda del anunciante.
publisher_id Entero Yes 321 Identificador del publicador.
publisher_name string No "Test" Nombre del publicador.
publisher string No "Test (123)" En desuso (a partir del 17 de octubre de 2016).
publisher_currency string "USD" Moneda del publicador.
site_id Entero Yes 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.
site string No "Site Name (194)" En desuso (a partir del 17 de octubre de 2016).
placement_id Entero Yes 456 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 "Ivillage 160x600" 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 "Ivillage Code" Código personalizado para la ubicación.
insertion_order_id Entero Yes 321 Identificador del orden de inserción.
insertion_order_name string No "Insertion Order" Nombre del orden de inserción.
insertion_order string No "Insertion Order (321)" En desuso (a partir del 17 de octubre de 2016).
line_item_id Entero Yes 111 Identificador del elemento de línea.
line_item_name string No "Default Line Item" Nombre del elemento de línea.
line_item string No "Default Line Item (111)" En desuso (a partir del 17 de octubre de 2016).
line_item_code string No "Default Line Item Code" Código personalizado para el elemento de línea.
campaign_id Entero Yes 222 Identificador de la campaña.
campaign_name string No "Default Campaign" Nombre de la campaña.
campaign string No "Default Campaign (222)" En desuso (a partir del 17 de octubre de 2016).
size string "728x90" Tamaño de la colocación/creatividad servida.
brand_id Entero Tes 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.
brand string No "Ace Hardware (3)" En desuso (a partir del 17 de octubre de 2016).
geo_country string "US" Código del país geográfico.
geo_country_name string No "United States" Nombre del país geográfico.
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 (a partir del 17 de octubre de 2016).
trafficker_for_insertion_order string "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 "Beverly Heller" 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.
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_recency_bucket string "15-30 minutes" Cubo de la fecha en que se mostró la creatividad. Consulte Cubos de recencia creativa a continuación para ver los valores posibles.
creative_frequency_bucket string "11-20" 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.
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.
mobile_application_id Entero Yes 343200656 Un identificador de App Store de Apple de destino, un identificador de aplicación de Android o un identificador de aplicación de Windows.
supply_type string "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 "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 "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 "2" Identificador del ancho del reproductor de vídeo. Consulta Tamaño del reproductor a continuación para ver los valores posibles.
imp_type_id Entero Yes 3 Identificador del tipo de impresión asociado. Valores posibles: un valor entero que se traduce de la siguiente manera:
0 = Error de evento de vídeo
1 = En blanco: respuesta "200 OK" (en blanco).
2 = PSA: un anuncio de servicio público servido porque ninguna otra creatividad era apta.
3 = Error predeterminado: una creatividad predeterminada que se sirve debido a un problema de tiempo de espera.
4 = Valor predeterminado: una creatividad predeterminada que se sirve porque ninguna oferta de campaña o ninguna otra creatividad era apta.
5 = Mantenido: uno de los anunciantes administrados atendió a un creativo.
6 = Revendida: la impresión se vendió a un comprador de terceros.
7 = RTB: su creatividad se sirve en el inventario de terceros.
8 = Error de PSA: un anuncio de servicio público servido debido a un problema de tiempo de espera.
9 = Impresión externa: una impresión de un rastreador de impresiones.
10 = Clic externo: un clic de un seguimiento de clics.
bidder_id Entero Yes 45 Identificador del pujador asociado.
creative_duration Entero Yes 30 Duración de la creatividad de vídeo en segundos.
video_delivery_type string No "vod" Tipo de entrega de contenido de streaming. Por ejemplo, Video On Demand (VOD) y Live.
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, , Comedyetc.
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, , Clipetc.
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 - Desktops & Laptops
- Mobile Phones
- Tablets
- TV
- Game Consoles
- Media Players
- Set Top Box
- 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, , Foxetc.
code_1 string No "Code A" Alias agregado al objeto de selección de ubicación que se puede notificar como una subdimensiona de Placement. El informe muestra el valor actual del alias y no refleja los valores históricos. Esta información solo se puede notificar a los vendedores.
code_2 string No "Code B" Alias agregado al objeto de selección de ubicación que se puede notificar como una subdimensiona de Placement. El informe muestra el valor actual del alias y no refleja los valores históricos. Esta información solo se puede notificar a los vendedores.
code_3 string No "Code C" Alias agregado al objeto de selección de ubicación que se puede notificar como una subdimensiona de Placement. El informe muestra el valor actual del alias y no refleja los valores históricos. Esta información solo se puede notificar a los vendedores.

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 El número total de impresiones (servidas y revendidas).
ad_requests Entero 1234 ad_requests Número de solicitudes de anuncios asociadas a la ubicación.
ad_responses Entero 2340 ad_responses 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.
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 booked_revenue: total_cost Ingresos reservados menos costo total.
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.
rpm dinero 2.60548314606741 (ingresos/imps) x 1000 Ingresos por 1000 impresiones.
rpm_including_fees dinero 2.60548314606741 (revenue_including_fees/imps) x 1000 En desuso. Ingresos menos comisiones por cada 1000 impresiones.
total_network_rpm dinero 2.60548314606741 (ingresos/imps) x 1000 Ingresos por 1000 impresiones.
ppm dinero 0.944966292134831 (beneficio /imps) x 1000 En desuso. El beneficio por 1000 impresiones.
ppm_including_fees dinero 0.662460674157303 (profit_including_fees/imps) x 1000 En desuso. Beneficio que incluye tarifas adicionales por cada 1000 impresiones.
cpm_including_fees dinero 2.60548314606741 (cost_including_fees/imps) x 1000 En desuso. El costo incluye tarifas adicionales por cada 1000 impresiones.
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.45 completions/imps Número de finalizaciones de vídeo divididas por el número de impresiones.
render_rate double 60% render_rate Porcentaje de vídeos entregados en función del número de respuestas de anuncios entregadas al explorador del usuario. (Impresiones y respuestas de anuncios)
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.
imps_viewed Entero 30,450 imps_viewed 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 se puede ver si el 50 % de los píxeles están en vista durante 2 segundos consecutivos.
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)
started_video_completion_rate double 85.45 completions/video_starts Número de finalizaciones de vídeo divididas por el número de inicios de vídeo.
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 dinero 123.45 (booked_revenue + reseller_revenue): total_cost La suma de los ingresos reservados y los ingresos del revendedor menos el costo total.
network_profit_ecpm dinero 123.45 (network_profit/imps) * 1000 Beneficio de red por 1000 imps.
network_profit_ecpc dinero 123.45 network_profit/clics Beneficio de red por clic.
network_profit_ecpa dinero 123.45 network_profit/conversiones Beneficio de red por conversión.
network_profit_margin dinero 123.45 network_profit/(booked_revenue + reseller_revenue) Margen de beneficio de red.
profit_ecpm dinero 123.45 ((booked_revenue - total_cost)/imps) * 1000 Beneficio por 1000 imps.
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.
profit_margin dinero 123.45 (booked_revenue - total_cost)/booked_revenue Margen de ganancia del comprador.
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.
fill_rate double 85.00 (imps_resold+imps_kept)/total_ad_requests Porcentaje de impresiones totales (tanto revendidas como retenidas) del número total de solicitudes de anuncios enviadas a Xandr para la subasta.

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

Ejemplos

Creación de una solicitud de informe con formato JSON

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

{
    "report":
    {
        "report_type":"video_analytics_network",
        "columns":[
            "hour",
            "seller_member_id",
            "buyer_member_id",
            "advertiser_id",
            "publisher_id",
            "imps",
            "ad_requests",
            "ad_responses",
            "25_pcts",
            "completions",
            "completion_rate",
            "convs_rate"
        ],
        "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 '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":"2010-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"video_analytics_network\",\"columns\":[\"hour\",\"seller_member_id\",
   \"buyer_member_id\",\"advertiser_id\",\"publisher_id\",\"imps\",\"25_pcts\",\"completions\",\"completion_rate\",\"convs_rate\"],
            \"row_per\":[\"hour\",\"seller_member_id\",\"buyer_member_id\",\"advertiser_id\",\"publisher_id\"],
            \"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.

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

Nota:

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