Análisis de vídeo de editores de red

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

Nota:

video_content_genre 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 editor 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 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
  • 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 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" El día de la subasta.
month date no "2010-02" El mes de la subasta.
member_id Entero 767 El identificador del miembro.
buyer_member_id Entero 567 El identificador del miembro comprador.
buyer_member_name string no "Network" El nombre del miembro comprador.
advertiser_id Entero 728 El identificador del anunciante.
advertiser_name string no "Test" El nombre del anunciante.
brand_id Entero 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 .
publisher_id Entero 6787 El número para identificar la editorial.
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.
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.
geo_country string "US" El código geográfico de país o región.
geo_country_name string no "United States" Nombre del país/región.
placement_id Entero 546 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 "300x250 Business" 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 "300x250 Business Code" El código personalizado de la ubicación.
site_domain string no bestsiteever.com El dominio del sitio de una impresión.
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" Cuándo y dónde se reproduce la 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_delivery_type1 string No "vod" El tipo de entrega de contenido en 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, , BiographyAdventure, Business, Comedy, etc.
video_program_type1 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_rating1 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_duration1 Entero 100 La duración del contenido del vídeo en segundos.
video_content_language1 string No "Spanish" El 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, , DisneyCBC, AMC, Fox, etc.
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.
clicks Entero 545 clics El número total de clics en todas las impresiones.
total_convs Entero 90 post_click_convs + post_view_convs El número total de conversiones posteriores a la vista y a los clics.
ctr double 0.2327836 Clics / Diablillos * 100 La tasa de clics a impresiones.
convs_rate double 0.0384413 total_convs / diablillos * 100 La tasa de conversiones a impresiones.
network_revenue dinero 1201.13 network_revenue Los ingresos de la red se reservan a través de anunciantes directos y se revenden a compradores en tiempo real
total_network_rpm dinero 2.60548314606741 (network_revenue / diablillos) x 1000 Los ingresos de red por cada 1000 impresiones.
publisher_revenue dinero 400.05 publisher_revenue Los ingresos pagados al editor (basados en 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 inversión de la red. Devuelto como porcentaje, por ejemplo, 0,94 = 94 %
sold_network_rpm double 231.888 (ingresos / diablillos) x 1000 ----- sin errores Los ingresos por cada 1000 impresiones que no fueron errores.
total_publisher_rpm dinero 1.6605168
5393258
(costo / diablillos) x 1000 El coste por cada 1000 impresiones pagadas a editores directos y de terceros, incluidos los errores.
sold_publisher_rpm double 147.786 (costo / diablillos) x 1000 ----- sin errores El coste por cada 1000 impresiones pagadas a editores directos y de terceros, sin incluir los errores.
network_ppm dinero 9.23 (ganancias / imps) x 1000 En desuso. El beneficio por cada 1000 impresiones.
imps_sold Entero 42500 imps_sold El número de impresiones que has vendido a otros miembros.
video_errors Entero 23 errores El número total de errores que sirven a las impresiones de vídeo
ad_responses Entero 2340 atendido 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.
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.
network_profit_ecpm dinero 123.45 ((booked_revenue + reseller_revenue - total_cost)/diablillos) * 1,000 Beneficio de la red por cada 1.000 diablillos.
network_profit_ecpc dinero 123.45 (booked_revenue + reseller_revenue - total_cost)/clics Beneficio por clic de red.
network_profit_ecpa dinero 123.45 (booked_revenue + reseller_revenue - total_cost)/conversiones 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 la red.
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.

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

Ejemplo

Crear 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 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 GET llamada hasta que se execution_status ."ready" Después, 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 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_publisher.csv

Nota:

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