Análisis de vídeo de anunciantes de red

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

Nota:

Las métricas de vídeo se registran solo para creativos VAST.

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 de una de las siguientes formas:

  • 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 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 date No "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 date No 2010-02-01 Día del mes.
month date date 2010-02 Mes del año.
seller_member_id Entero 567 El identificador interno del miembro vendedor.
seller_member_name string No "AdMeld" El nombre para mostrar del miembro vendedor.
seller_member string No "AdMeld (567)" En desuso.
advertiser_id Entero 344 El Id. interno del anunciante cuya campaña y creatividad sirvieron en la impresión.
campaign_id Entero 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 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_name será "External Clicks" o ."External Imps"
creative string No "Q1 2010 728x90 (554)" En desuso.
placement_id Entero 567 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 "Photos 728x90" 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 string No "Photos 728x90 (123)" En desuso.
placement_code string No "Placement Code" El código personalizado de la ubicación.
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.
size string "728x90" Tamaño del recurso creativo/emplazamiento
geo_country string "US" Código geográfico de país o región
geo_country_name string No "Unites States" Nombre del país o región
creative_recency_bucket string "11-20" 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_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_frequency_bucket string "15-30 minutes" 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.
insertion_order_id Entero 654 El identificador de la orden de inserción
insertion_order_name string No "Insertion Order Name" El nombre de la orden de inserción
insertion_order string No "Insertion Order Name (654)" En desuso.
line_item_id Entero 932 Número para identificar la línea de pedido
line_item_name string No "$3 CPM Verizon Remarketing" Nombre para mostrar de la línea de pedido
line_item string No "$3 CPM Verizon Remarketing (932)" En desuso.
publisher_id Entero 321 Número para identificar la editorial
publisher_name string No "Test" Nombre para mostrar del publicador
publisher string No "Test (123)" En desuso.
trafficker_for_insertion_order string "Chris Mack" 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 "Jonathan Smith" 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.
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.
application_id string '343200656' (iOS) o bien
com.rovio.angrybirds'(Android)
Un id. de Apple App Store segmentable, un nombre de paquete de Google Play o un id. de aplicación de Windows.
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.
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, and 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.
video_delivery_type string No "vod" El tipo de entrega de contenido en streaming. Por ejemplo, Video On Demand (VOD) y Live.
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_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 Diablillos El número total de impresiones servidas.
clicks Entero 545 clics El 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 posteriores al clic.
total_convs Entero 90 post_click_convs + post_view_convs El número total de conversiones posteriores a la vista y a los clics.
convs_rate double 0.0003844 total_convs / diablillos La tasa de conversiones a impresiones.
post_view_convs_rate double 0.000320 post_view_convs / diablillos La tasa de conversiones posteriores a la vista en impresiones.
post_click_convs_rate double 0.000064 post_click_convs / diablillos La tasa de conversiones posteriores al clic en impresiones.
ctr double 0.2327836 Clics / Diablillos La tasa de clics a impresiones.
profit dinero 350.00 booked_revenue - total_cost Ingresos reservados menos coste total.
revenue_ecpm dinero 1.9221 booked_revenue / clics Los ingresos totales por cada 1000 impresiones.
cost_ecpm dinero 0.4271259 media_cost / diablillos * 1.000 El coste por cada 1000 impresiones.
profit_ecpm dinero 0.4949 Beneficios/Imps * 1.000 El beneficio por cada 1000 impresiones. "Beneficios" se define como los ingresos contables menos el coste total.
revenue_ecpc dinero 0.8256 booked_revenue / clics Los ingresos totales por clic.
revenue_ecpa dinero 5.00 booked_revenue / total_convs Los ingresos totales por conversión.
cost_ecpc dinero 0.1834 media_cost / clics El coste por clic.
cost_ecpa dinero 1.1111 media_cost / total_convs El coste por adquisición o conversión.
profit_margin dinero 0.7778 Beneficios/booked_revenue Profit divided by booked_revenue. "Beneficios" se define como los ingresos contables menos el coste total.
media_cost dinero 100.00 media_cost El importe total gastado.
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.
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.
served Entero 87649 Impresiones de vídeo servidas El número total de impresiones de vídeo publicadas.

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.
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 1 segundo consecutivo.
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)
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.
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.
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.

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 Auto-play, sound on
2 Auto-play, sound off
3 Click-to-play
4 Mouse-over
5 Auto-play, sound unknown

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

Crear 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 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_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 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=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 del informe, pero esta vez al servicio de descarga de informes . Puede encontrar el servicio y el ID del informe en el url campo de la respuesta a su llamada anterior GET . Al identificar el archivo en el que desea guardarlo, asegúrese de usar la extensión de archivo del formato de archivo que especificó en POSTel 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_advertiser.csv

Nota:

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

Servicio de informes