Análisis de vídeo en red

El informe Network Video Analytics se puede utilizar para ver las métricas de eventos de video de un miembro de la red. Para profundizar en análisis más granulares para un anunciante o editor específico, consulte los informes Network Video Advertiser Analytics y Network Video Publisher Analytics .

Nota:

  • Las métricas de vídeo se registran solo para creativos VAST.
  • Para obtener instrucciones sobre cómo recuperar un informe, consulte Servicio de informes o los ejemplos siguientes.

Período de tiempo

El report_interval campo se puede establecer de una de las siguientes formas:

  • 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 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 Servicio de informes.

Dimensions

Column Tipo ¿Filtro? Ejemplo Descripción
hour time "2010-02-01 06:00: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 "2010-02-01" El día de la subasta.
month time No "2010-02" El mes de la subasta.
buyer_member_id Entero 123 El identificador del miembro comprador. Si la impresión no se ha comprado, este campo muestra uno de los siguientes valores:
229 = PSA
0 = En blanco
319 = Predeterminado
buyer_member_name string No "My Network" El nombre del miembro comprador.
buyer_member string No "My Network (123)" En desuso (a partir del 17 de octubre de 2016).
split_id Entero 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 (si se incluye) será null.
split_name string "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 554 El Id. del creativo.

Nota: 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 del creativo.

Nota: Para los rastreadores de clics o impresiones externas, 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 767 El identificador del miembro.
seller_member_id Entero 456 El identificador del miembro vendedor.
seller_member_name string No "That Seller" El nombre del miembro vendedor.
seller_member string No "That Seller (456)" En desuso (a partir del 17 de octubre de 2016).
advertiser_id Entero 789 El identificador del anunciante. Si el valor es 0, o bien la impresión la compró un comprador externo, o bien se mostró un valor predeterminado o PSA.
advertiser_name string No "Verizon Wireless" El nombre del anunciante.
advertiser string No "Verizon Wireless (789)" En desuso (a partir del 17 de octubre de 2016).
advertiser_currency string "USD" La moneda del anunciante.
publisher_id Entero 321 El Id. del publicador.
publisher_name string No "Test" El nombre del editor.
publisher string No "Test (123)" En desuso (a partir del 17 de octubre de 2016).
publisher_currency string "USD" La moneda del editor.
site_id Entero 194 El identificador del sitio.

Nota: Para las impresiones de más de 100 días, la site_id será 0.
site_name string No "Site Name" El nombre del sitio.
site string No "Site Name (194)" En desuso (a partir del 17 de octubre de 2016).
placement_id Entero 456 El id. de la ubicación.

Nota: Para las impresiones de más de 100 días, las ubicaciones se agregarán en una fila con -1 el placement_idformato .
placement_name string No "Ivillage 160x600" El nombre del emplazamiento.

Nota: Para las impresiones de más de 100 días, las ubicaciones se agregarán en una fila con "All placement data older than 100 days" el placement_nameformato .
placement_code string No "Ivillage Code" El código personalizado de la ubicación.
insertion_order_id Entero 321 El identificador de la orden de inserción.
insertion_order_name string No "Insertion Order" El nombre de la 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 111 El identificador del elemento de línea.
line_item_name string No "Default Line Item" El nombre de la línea de pedido.
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" El código personalizado de la línea de pedido.
campaign_id Entero 222 El identificador de la campaña.
campaign_name string No "Default Campaign" El nombre de la campaña.
campaign string No "Default Campaign (222)" En desuso (a partir del 17 de octubre de 2016).
size string "728x90" El tamaño de la ubicación/creatividad servida.
brand_id Entero Tes 3 El 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. En su lugar, consulte el Informe de revisión de marca del vendedor .
brand_name string No "Ace Hardware" El 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. En su lugar, consulte el Informe de revisión de marca del vendedor .
brand string No "Ace Hardware (3)" En desuso (a partir del 17 de octubre de 2016).
geo_country string "US" El código del país o región geográficos.
geo_country_name string No "United States" Nombre del país o región geográficos.
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 cadena suele identificar el acuerdo.
deal_id Entero 2345 El identificador de la oferta. Para obtener más información sobre los acuerdos negociados entre compradores y vendedores, consulte Servicio de ofertas y Servicio de acceso de compradores 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).
trafficker_for_insertion_order string "Maurice Truman" El traficante de la orden de inserción. Consulta el "labels" campo en el servicio de órdenes de inserción para obtener más información.
salesrep_for_insertion_order string "Beverly Heller" El representante de ventas de la orden de inserción. Consulta el "labels" campo en el servicio de órdenes de inserción para obtener más información.
creative_recency_bucket_id string no "4" El identificador del cubo de actualidad de la creatividad. Consulte Creative Recency Buckets a continuación para conocer los posibles valores.
creative_recency_bucket string "15-30 minutes" El cubo de la fecha en la que se ha mostrado el objeto creativo. Consulte Creative Recency Buckets a continuación para conocer los posibles valores.
creative_frequency_bucket string "11-20" El cubo de la frecuencia con la que se mostró la creatividad. Consulte Creative Frequency Buckets a continuación para conocer los posibles valores.
creative_frequency_bucket_id string no "3" El Id. del cubo de frecuencias de creatividad. Consulte Creative Frequency Buckets a continuación para conocer los posibles valores.
site_domain string no bestsiteever.com El dominio donde se produjo la impresión. En el caso de las aplicaciones móviles, puede ser la 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 hemos recibido un dominio válido como referencia. Por ejemplo, el dominio puede estar en blanco o tener un formato incorrecto.
mobile_application_id Entero 343200656 Un id. de Apple App Store, de aplicación de Android o de aplicación de Windows que se pueda segmentar.
supply_type string "mobile_web" El canal clasificado por el vendedor para denominar la oferta en términos de impresiones web, web optimizada para dispositivos móviles y aplicaciones móviles. Los valores posibles son:
- "web"
- "mobile_app"
- "mobile_web"
video_playback_method string "1" El método de reproducción del creativo. Consulte Método de reproducción de video a continuación para conocer los posibles valores.
video_context string "3" El tipo de creatividad de vídeo. Consulte Contexto de video a continuación para ver los posibles valores.
video_player_size_id string "2" El id. del ancho del reproductor de vídeo. Consulta Tamaño del reproductor a continuación para conocer los posibles valores.
imp_type_id Entero 3 El id. 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) servida.
2 = PSA : Un anuncio de servicio público sirvió porque ninguna otra creatividad era elegible.
3 = Error predeterminado: una creatividad predeterminada se publicó debido a un problema de tiempo de espera.
4 = Predeterminado: una creatividad predeterminada publicada porque ninguna puja de campañas o ninguna otra creatividad era apta.
5 = Conservado: uno de sus anunciantes administrados sirvió una creatividad.
6 = Revendida: La impresión se vendió a un comprador externo.
7 = RTB: su creatividad se publicó 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 rastreador de clics.
bidder_id Entero 45 El identificador del licitador asociado.
creative_duration Entero 30 La duración del vídeo creativo en segundos.
video_delivery_type string No "vod" El tipo de entrega de contenido en 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, , BiographyAdventure, Business, Comedy, etc.
video_program_type string No "series" La categorización de nivel superior del formato del programa de vídeo en el que se reproducirá el anuncio. Por ejemplo, Movie, , SpecialSeries, Show, EventClip, , etc.
video_content_rating string No "teens" El grupo de público identificado por el editor para el que se clasifica el contenido. Por ejemplo, All, , Teens (13+)Children (7+)Young Adults (14+), o .Adults (18+)
content_duration_secs Entero 480 La duración 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
El tipo de dispositivo en el que se ha establecido la reproducción de la creatividad.
video_content_duration Entero 100 La duración del contenido del vídeo en segundos.
video_content_language string No "Spanish" El 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, , DisneyCBC, AMC, Fox, etc.
code_1 string No "Code A" Un alias agregado al objeto de colocación que se puede reportar como una subdimensión de Ubicación. El informe muestra el valor actual del alias y no refleja los valores históricos. Esta información solo se puede informar a los vendedores.
code_2 string No "Code B" Un alias agregado al objeto de colocación que se puede reportar como una subdimensión de Ubicación. El informe muestra el valor actual del alias y no refleja los valores históricos. Esta información solo se puede informar a los vendedores.
code_3 string No "Code C" Un alias agregado al objeto de colocación que se puede reportar como una subdimensión de Ubicación. El informe muestra el valor actual del alias y no refleja los valores históricos. Esta información solo se puede informar a los vendedores.
is_takeover booleano "Yes" Indica si una impresión fue Blanked o Defaulted porque al menos uno de los anuncios de la solicitud de varios anuncios era una toma de control. Devuelve true si la impresión forma parte de una solicitud de adquisición; de lo contrario, devuelve false.

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 Diablillos El número total de impresiones (servidas y revendidas).
ad_requests Entero 1234 ad_requests El número de solicitudes de anuncios asociadas con el emplazamiento.
ad_responses Entero 2340 ad_responses El número de respuestas entregadas al explorador del usuario (o servidor mediador). Una respuesta puede dar lugar a una impresión, un error en el reproductor o una subasta sin evento de impresión.

Nota: Un diablillo se refiere a cuando el reproductor de video carga el video y comienza el primer cuadro. Los vídeos servidos se refieren al documento VAST que se sirve en respuesta a una solicitud del reproductor de vídeo.
clicks Entero 1 clics El número total de clics en todas las impresiones.
cost dinero 16.833378 costo El importe total del coste multimedia para el editor directo y el inventario en tiempo real comprado.
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 coste total.
cpm dinero 1.66051685393258 (costo / diablillos) x 1000 El coste por cada 1000 impresiones.
total_convs Entero 5 total_convs El número total de conversiones posteriores a la vista y a los clics.
convs_rate double 0.000221877080097626 total_convs / diablillos La tasa de conversiones a impresiones.
ctr double 0.000221877080097626 Clics / Diablillos La tasa de clics a impresiones.
rpm dinero 2.60548314606741 (ingresos / diablillos) x 1000 Los ingresos por cada 1000 impresiones.
rpm_including_fees dinero 2.60548314606741 (revenue_including_fees / diablillos) x 1000 En desuso. Los ingresos menos las comisiones por cada 1000 impresiones.
total_network_rpm dinero 2.60548314606741 (ingresos / diablillos) x 1000 Los ingresos por cada 1000 impresiones.
ppm dinero 0.944966292134831 (ganancias / imps) x 1000 En desuso. El beneficio por cada 1000 impresiones.
ppm_including_fees dinero 0.662460674157303 (profit_including_fees / diablillos) x 1000 En desuso. El beneficio, incluidas las tarifas adicionales por cada 1000 impresiones.
cpm_including_fees dinero 2.60548314606741 (cost_including_fees / diablillos) x 1000 En desuso. El coste, incluidas las tarifas adicionales por cada 1000 impresiones.
errors Entero 5 errores El número total de veces que se ha producido un error.
starts Entero 360 Se inicia El número total de veces que se ha descargado e iniciado el primer segmento de la creatividad de vídeo.
start_rate double 25.85 Inicios / Diablillos El número de inicios del vídeo dividido por el número de impresiones.
skips Entero 20 Saltos El número total de veces que un usuario se ha saltado 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 ha reproducido el vídeo durante todo el período de tiempo.
completion_rate double 85.45 Finalizaciones / Imps El número de finalizaciones de vídeo dividido por el número de impresiones.
render_rate double 60% render_rate El porcentaje de vídeos publicados según el número de respuestas de anuncios entregadas al explorador del usuario. (Impresiones/respuestas de anuncios)
revenue_per_video_complete double 15.869 Ingresos / finalizaciones Los ingresos por finalización del vídeo.
cost_per_video_complete double 2.056 Costo / finalizaciones El coste por finalización del vídeo.
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 2 segundos consecutivos.
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)
started_video_completion_rate double 85.45 finalizaciones / video_starts El número de finalizaciones de vídeo dividido 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 La cantidad total de costos acumulados durante el período de tiempo informado. Esto generalmente incluye dos tipos de costos, costos presupuestados (costo de medios, costo de datos, tarifas de socios, tarifas de servicio, comisiones) e ingresos del editor si realiza un seguimiento de los pagos del editor en la plataforma.

Nota: Hemos agregado lógica para evitar la doble contabilización de las tarifas de terceros durante el período de cambio de ruptura.
total_cost_ecpm dinero 123.45 (total_cost/imps) * 1,000 El costo total por cada 1,000 diablillos.
total_cost_ecpc dinero 123.45 total_cost/clics El coste total por clic.
total_cost_ecpa dinero 123.45 total_cost/conversiones El coste 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/diablillos) * 1,000 Beneficio de la red por cada 1.000 diablillos.
network_profit_ecpc dinero 123.45 network_profit/clics Beneficio por clic de red.
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 la red.
profit_ecpm dinero 123.45 ((booked_revenue - total_cost)/diablillos) * 1,000 Beneficio por cada 1.000 diablillos.
profit_ecpc dinero 123.45 (booked_revenue - total_cost)/clics 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 beneficio del comprador.
Average View Time Entero 28 sum (creative_duration * ((0,125 × inicios) + (0,25 × first_quartiles) + (0,25 × second_quartiles) + (0,25 × third_quartiles) + (0,125 × finalizaciones)) / sum (comienza)) Una estimación de la duración media en segundos (redondeado a 0 decimales) del creativo visto. Esto se calcula aproximando la duración vista como el punto medio entre los eventos de vídeo (por ejemplo, un evento de inicio estimaría que se ve el 12,5 % de la creatividad).
Average View Time Percent porcentaje 89% suma (((0,125 × inicios) + (0,25 × first_quartiles) + (0,25 × second_quartiles) + (0,25 × third_quartiles) + (0,125 × finalizaciones))∕inicios) El tiempo medio de visualización expresado como porcentaje del tiempo total posible de visualización.
fill_rate double 85.00 (imps_resold+imps_kept)/total_ad_requests El porcentaje del total de impresiones (tanto revendidas como retenidas) del número total de solicitudes de anuncio enviadas a Xandr para su subasta.

Cubos de frecuencia creativos

Bucket ID Nombre del depósito
-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 actualidad creativos

Bucket ID Nombre del depósito
-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 ratón por encima
5 Reproducción automática, sonido desconocido

Contexto del vídeo

Id. de método Método
0 Unknown
1 Repetición previa
2 Tirada media
3 Post-roll
4 Salida

Tamaño del reproductor

Id. Nombre
0 small
1 medium
2 large

Ejemplos

Crear 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 la granularidad (year, month, day) y especificar el formato en el que se deben devolver los datos (csv, excel, o html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, vea el servicio de informes.

$ 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 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" 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 ID del informe, pero esta vez al servicio de descarga de informes . Puede encontrar el servicio y el ID de informe en el url campo 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 .

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.