Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 | Sí | 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 | Sí | 344 |
El Id. interno del anunciante cuya campaña y creatividad sirvieron en la impresión. |
campaign_id |
Entero | Sí | 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 | Sí | 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 | Sí | "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 | Sí | 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 | Sí | 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 | Sí | 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 | Sí | "728x90" |
Tamaño del recurso creativo/emplazamiento |
geo_country |
string | Sí | "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 | Sí | "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 | Sí | "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 | Sí | 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 | Sí | 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 | Sí | 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 | Sí | "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 | Sí | "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 | Sí |
'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 | Sí | 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 | Sí | "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 | Sí | "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 | Sí | "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 | Sí | 480 |
La duración 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. |
El tipo de dispositivo en el que se ha establecido la reproducción de la creatividad. |
video_content_duration |
Entero | Sí | 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 | Sí | "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_genrevideo_program_typevideo_content_ratingvideo_content_durationvideo_content_languagevideo_content_networkvideo_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.