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 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 | Sí | 767 |
El identificador del miembro. |
buyer_member_id |
Entero | sí | 567 |
El identificador del miembro comprador. |
buyer_member_name |
string | no | "Network" |
El nombre del miembro comprador. |
advertiser_id |
Entero | sí | 728 |
El identificador del anunciante. |
advertiser_name |
string | no | "Test" |
El nombre del anunciante. |
brand_id |
Entero | sí | 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 | sí | 6787 |
El número para identificar la editorial. |
publisher_currency |
string | sí | "USD" |
La moneda del editor. |
site_id |
Entero | sí | 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 | 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. |
geo_country |
string | sí | "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 | sí | 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 | 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" |
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 | 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_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 | 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_duration1 |
Entero | Sí | 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 | 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_delivery_typevideo_content_genrevideo_program_typevideo_content_ratingvideo_content_durationvideo_content_languagevideo_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.66051685393258 |
(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.