Análisis de dispositivos de red

El informe de análisis de dispositivos de red permite recuperar datos de rendimiento de compra y venta en función de los dispositivos en los que se han servido las impresiones. Esto es especialmente importante para las redes que trabajan con anunciantes en aplicaciones que trafican con creatividades que fomentan la instalación de aplicaciones y que, por lo tanto, quieren confirmación de que sus creatividades se dirigen a dispositivos compatibles con sus aplicaciones. También le ayuda a responder a las siguientes preguntas:

  • ¿Cuántas impresiones has visto de marcas y modelos de dispositivos concretos?
  • ¿Cuántas impresiones has visto de tipos de conexión específicos (por ejemplo, Wifi/Estática o basada en operador)?
  • ¿Cómo funcionan ciertos tipos de dispositivos en relación con otros (es decir, tabletas frente a teléfonos)?
  • ¿Cómo funcionan ciertas marcas y modelos de dispositivos en relación con otros (es decir, Android frente a Apple)?
  • ¿Cómo funcionan determinados tipos de conexiones en relación con otros (es decir, Wifi/Estática frente a Basada en operador)?

Período de tiempo y zona horaria

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

  • hoy
  • yesterday
  • last_2_days
  • last_7_days
  • last_14_days
  • last_30_days
  • month_to_date
  • month_to_yesterday

Como alternativa, los start_date campos y end_date se pueden establecer en un intervalo de los últimos 30 días. Sin embargo, dado que los datos por hora no están disponibles para este informe, el start_date y end_date no puede ser idéntico y debe tener formato como "YYYY-MM-DD" en lugar de "YYYY-MM-DD HH:MM:SS". El timezone campo de la solicitud JSON solo se puede establecer en "UTC", pero esto no es necesario, ya que la zona horaria se "UTC" establece de forma predeterminada si no se especifica.

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

Dimensions

Column Tipo ¿Filtro? Ejemplo Descripción
month time "2010-02" El mes de la subasta.
day time "2010-02-01" El día de la subasta.
device_make_id Entero 1 El identificador del dispositivo marca en el que se ha enviado la impresión. La marca es generalmente el fabricante del dispositivo (es decir, Apple). Para obtener una lista completa de nombres e identificadores de marcas de dispositivos, use el servicio Device make.
device_make_name string No "4G Systems" El nombre del dispositivo marca en el que se ha enviado la impresión. La marca es generalmente el fabricante del dispositivo (es decir, Apple).
device_make string No "4G Systems (1)" En desuso.
device_model_id Entero 15 El identificador del modelo de dispositivo en el que se ha enviado la impresión. El modelo es generalmente el producto específico (es decir, iPhone). Para obtener una lista completa de los identificadores y nombres de modelo de dispositivo, use el servicio Device Make.
device_model_name string No "DX650" El nombre del modelo de dispositivo en el que se ha enviado la impresión. El modelo es generalmente el producto específico (es decir, iPhone).
device_model string No "DX650 (15)" En desuso.
device_type string "tablets" El tipo de dispositivo en el que se ha enviado la impresión. Los posibles valores son:
- "desktops & laptops"
- "tablets"
- "mobile phones"
- "tv"
- "game consoles"
- "set top box"
- "media players"
- "other devices"
connection_type string "Carrier-based" El tipo de conexión a Internet en el momento de la impresión. Posibles valores:
- "Carrier-based"
- "Wifi or Static"
operating_system_id Entero 24 El Id. del sistema operativo del dispositivo.
- Use el servicio Familia del sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio Operating System Extended para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
operating_system_name string "Android 2.3.5 Gingerbread" El nombre del sistema operativo del dispositivo.
- Use el servicio Familia del sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio Operating System Extended para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
operating_system_family_id Entero 2 El id. de la familia del sistema operativo asociado al dispositivo en el que se sirvió la impresión.
- Use el servicio Familia del sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio Operating System Extended para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
operating_system_family_name string "Android" El nombre de la familia del sistema operativo asociada con el dispositivo en el que se sirvió la impresión.
- Use el servicio Familia del sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio Operating System Extended para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
browser_id Entero El Id. del navegador en el que se ha servido la impresión. Para obtener una lista completa de los identificadores y nombres del explorador, use el servicio de explorador.
browser_name string El Id. del navegador en el que se ha servido la impresión.
browser string En desuso.
entity_member_id Entero 123 Si imp_type es:
1 (En blanco)
2 (PSA)
3 (Error predeterminado)
4 (Predeterminado)
6 (Revendido)
8 (PSA resultante de un error de incumplimiento), la identificación del miembro comprador; de lo contrario, el ID del miembro vendedor.
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.
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.
buyer_type string "Real Time" El tipo de medios adquiridos por el miembro comprador. Valores posibles: "Real Time" o "Direct".
seller_type string "Real Time" El tipo de contenido multimedia vendido por el miembro vendedor. Valores posibles: "Real Time" o "Direct".
advertiser_id Entero 789 El identificador del anunciante. Si el valor es 0, la impresión la compró un comprador externo o se mostró un valor predeterminado o PSA.
advertiser_name string No "Mobile Zombies" El nombre del anunciante.
advertiser string No "Mobile Zombies (789)" En desuso.
advertiser_code string No "MZB1010" El código personalizado para el anunciante.
insertion_order_id Entero 321 El identificador de la orden de inserción.
insertion_order_name string No "Mobile Insertion Order" El nombre de la orden de inserción.
insertion_order string No "Mobile Insertion Order (321)" En desuso.
insertion_order_code string No "Mobile Insertion Order Code" El código personalizado de la orden de inserción.
line_item_id Entero 111 El identificador del elemento de línea.
line_item_name string No "Mobile Line Item" El nombre de la línea de pedido.
line_item string No "Mobile Line Item (111)" En desuso.
line_item_code string No "Mobile 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 "Mobile Campaign" El nombre de la campaña.
campaign string No "Mobile Campaign (222)" En desuso.
campaign_code string No "Mobile Campaign Code" El código personalizado de la campaña.
deal_name string "My New Deal" El nombre de la oferta asociada a la transacción de la impresión.
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.
deal_id Entero 123 El identificador de la oferta asociada a la transacción de la impresión.
pixel_id Entero 3849 El identificador del píxel de conversión.
media_type string "Banner" El tipo de medio de la creatividad. Posibles valores:
- "Banner"
- "Pop"
- "Interstitial"
- "Video"
- "Text"
- "Expandable"
- "Skin"
Para obtener una lista completa de los tipos de medios, use el servicio de tipos de medios.
mediatype_id Entero 1 El identificador del tipo de medio de la creatividad.
size string "728x90" El tamaño de la ubicación/creatividad servida.
geo_country string "US" El código del país o región.
geo_country_name string No "United States" Nombre del país/región.
payment_type string "cpm", "revshare" El tipo de pago a un agente.
revenue_type string No "CPA" La base sobre la que el anunciante paga al miembro.
revenue_type_id Entero 4 El identificador del tipo de ingresos. Posibles valores:
-1 = Sin pago
0 = CPM fijo
1 = Coste más CPM
2 = Coste más margen
3 = CPC
4 = CPA
5 = Revshare
6 = tarifa plana
7 = CPM variable
8 = CPM estimado
publisher_name string No "AppSite" El nombre del editor.
publisher string "AppSite (123)" El nombre del editor seguido del identificador (formato Xandr).
publisher_code string No "AS123" El código personalizado para el editor.
pub_rule_name string No "Publisher Rule Name" El nombre de la regla del editor.
pub_rule string No "Publisher Rule Name (555)" El nombre de la regla de publicación seguida del identificador (formato Xandr).
pub_rule_code string No "AppSitePR123" El código personalizado de la regla del editor.
bid_type string "Manual" La fase de optimización en la que se encontraba el nodo cuando puja por la impresión.

Nota: El término "renuncia" se agrega a los tipos de ofertas a continuación si la valoración de esa impresión cae por debajo del "precio de renuncia" del lugar. Valores permitidos:
- "Manual": Se aplica cuando se puja con un objetivo de CPM, ya sea Base, EAP o ECP.
- "Learn": Se aplica cuando se puja con optimización (CPA, CPC o margen) y aún no tenemos datos suficientes para pujar optimizada.
- "Optimized": se aplica cuando se puja con optimización (CPA, CPC o margen) y tenemos datos suficientes para pujar optimizada.
- "Unknown": el nodo se encontraba en una fase de optimización desconocida.
- "Optimized give up"
- "Learn give up"
- "Manual give up"
imp_type_id Entero 6 El identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis):
1 ("Blank"): No se sirve ninguna creatividad.
2 ("PSA"): se publicó un anuncio de servicio público porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible.
3 ("Error predeterminado"): una creatividad predeterminada servida debido a un problema de tiempo de espera.
4 ("Predeterminado"): se publicó una creatividad predeterminada porque no había pujas válidas.
5 ("Conservado"): el recurso creativo de su anunciante se sirve en el sitio de su editor.
6 ("Revendida"): la impresión de su editor se vendió a un comprador externo.
7 ("RTB"): el recurso creativo del anunciante publicado en el inventario de terceros.
8 ("Error de PSA"): un anuncio de servicio público servido debido a un problema de tiempo de espera o falta de una creatividad predeterminada.
9 ("Impresión externa"): una impresión de un rastreador de impresiones.
10 ("Clic externo"): un clic de un rastreador de clics.
imp_type string "Resold" El tipo de impresión. Para conocer los posibles valores, consulta imp_type_id.
venue string "Venue Name" El nombre del clúster de dominio, sitio, etiqueta y país o región del usuario que usa nuestro sistema de optimización para determinar las valoraciones de las pujas. Una campaña no puede dirigirse a un lugar explícitamente.
operating_system_family_id Entero 2 El id. de la familia del sistema operativo asociado al dispositivo en el que se sirvió la impresión.
- Use el servicio Familia del sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio Operating System Extended para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
operating_system_family_name string "Android" El nombre de la familia del sistema operativo asociada con el dispositivo en el que se sirvió la impresión.
- Use el servicio Familia del sistema operativo para obtener una lista de familias de sistemas operativos.
Use el servicio extendido del sistema operativo para buscar qué versiones de sistema operativo están dentro de una familia de sistemas operativos determinada.

Métricas

Column Tipo Ejemplo Fórmula Descripción
imps Entero 2340 Diablillos El número total de impresiones (servidas y revendidas).
imps_blank Entero 3 imps_blank El número de impresiones servidas con un espacio en blanco.
imps_psa Entero 5 imps_psa El número de impresiones que sirvieron para un anuncio de servicio público.
imps_default_error Entero 0 imps_default_error El número de impresiones que se produjeron de forma predeterminada debido a un problema de tiempo de espera.
imps_default_bidder Entero 0 imps_default_bidder El número de impresiones que se produjeron de forma predeterminada porque no había pujas válidas.
imps_kept Entero 0 imps_kept El número de impresiones que el anunciante compró a tu editor.
imps_resold Entero 0 imps_resold El número de impresiones que tu editor vendió a un tercero.
imps_rtb Entero 2332 imps_rtb El número de impresiones que el anunciante compró a un tercero.
clicks Entero 1 clics El número total de clics en todas las impresiones.
click_thru_pct double 1.12359550<br>561797% (clics / diablillos) x 100 La tasa de clics a impresiones como porcentaje.
ctr double 0.00022187
7080097626
Clics / Diablillos La tasa de clics a impresiones.
total_convs Entero 1 total_convs El número total de conversiones posteriores a la vista y a los clics.
post_view_convs Entero 15 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.
convs_per_mm double 221.877080
097625
(total_convs / diablillos) x 1.000.000 El número de conversiones por millón de impresiones.
convs_rate double 0.00022187
7080097626
total_convs / diablillos La tasa de conversiones a impresiones.
cost dinero 16.833378 costo El importe total del coste multimedia para el editor directo y el inventario de terceros comprado.
cpm dinero 1.66051685
393258
(costo / diablillos) x 1000 El coste de los medios por cada 1000 impresiones.
revenue dinero 25.767257 booked_revenue + reseller_revenue Los ingresos totales registrados a través de anunciantes directos (línea de pedido) y editores directos (impresiones de reventa).
booked_revenue dinero 25.767257 booked_revenue Los ingresos totales reservados a través de anunciantes directos (línea de pedido).
reseller_revenue dinero 0 reseller_revenue Los ingresos totales de las impresiones revendidas a través de editores directos.
total_rpm dinero 2.60548314
606741
(ingresos / diablillos) x 1000 Los ingresos por cada 1000 impresiones. Este valor se mostrará en USD, así como potencialmente como moneda de compra y moneda de venta (si has seleccionado esas dimensiones).
profit dinero 0.084102 booked_revenue - total_cost Ingresos reservados menos coste total.
ppm dinero 0.94496629
2134831
(ganancias / imps) x 1000 En desuso. El beneficio por cada 1000 impresiones.
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.
sold_network_rpm double 231.888 (ingresos / diablillos) x 1000 ----- sin errores Los ingresos por cada 1000 impresiones que no fueron errores.
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.
device_type string Tablets,mobile phones Este es el tipo de dispositivo que se usa.
convs_device_make string Apple (26) Este es el dispositivo en el que se produjo la conversión. Esto se puede comparar con Device Make para determinar en qué dispositivo se produjo la impresión.
device_make string Apple (26) Es el nombre de la marca del dispositivo.
convs_device_type string Tablets, mobile phones Esto se puede comparar con el tipo de dispositivo para determinar en qué dispositivo se produjo la conversión.
video_skips Entero 10 El número total de veces que un usuario se ha saltado el vídeo. Use esta métrica para generar informes al comprar inventario omitible.
video_starts Entero 11 El número total de veces que se ha descargado e iniciado el primer segmento de la creatividad de vídeo.
video_25_pcts Entero 10 El número total de veces que las creatividades de vídeo completaron el 25 % de toda la duración.
video_50_pcts Entero 10 El número total de veces que las creatividades de vídeo completaron el 50 % de la duración total.
video_75_pcts Entero 10 El número total de veces que las creatividades de vídeo completaron el 75 % de toda la duración.
video_completions Entero 12 El número total de veces que se reprodujeron las creatividades de vídeo durante toda la duración.
video_served Entero 10 El número total de respuestas de vídeo servidas al jugador. Una respuesta de anuncio se produce cuando el documento VAST (XML) se sirve en respuesta a una solicitud. Una respuesta a un anuncio no indica necesariamente una impresión correcta. Para una impresión, se debe servir el primer fotograma del vídeo.
video_errors Entero 2 El número total de veces que se ha producido un error de vídeo.
revenue_per_video_complete dinero 25.76 Los ingresos por finalización del vídeo.
cost_per_video_complete dinero 22.76 El coste por finalización del vídeo.
video_completion_rate double 1.12359550561797% (finalización de vídeo/impresiones totales) x 100 La proporción entre las impresiones y las finalizaciones de vídeo, expresada como porcentaje.
video_start_rate double 1.12359550561797% El porcentaje de veces que se ha descargado e iniciado el primer segmento del vídeo creativo.
video_skip_rate double 1.12359550561797% El porcentaje de veces que el usuario ha optado por omitir el vídeo.

Ejemplo

Crear una solicitud de informe con formato JSON

El archivo JSON debe incluir el report_type"network_device_analytics", así como las columnas (dimensiones y métricas) que report_interval 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. En este ejemplo, queremos ver los datos de rendimiento sobre las impresiones en Estados Unidos del anunciante 1459 de cada uno de los últimos 14 días. En concreto, para cada combinación de marca de dispositivo, modelo de dispositivo, tipo de conexión y tipo de impresión, queremos el número de impresiones, el número de clics, el dinero total gastado, el dinero gastado por cada 1000 impresiones, el dinero que nos paga el anunciante y el beneficio total (dinero ganado, dinero gastado).

$ cat network_device_analytics

{
    "report": {
        "report_type": "network_device_analytics",
        "filters": [
            {
                "advertiser_id": 1459
            },
            {
                "geo_country": "US"
            }
        ],
        "columns": [
            "day",
            "connection_type",
            "imp_type",
            "imps",
            "clicks",
            "cost",
            "cpm",
            "booked_revenue",
            "profit"
        ],
        "report_interval": "last_14_days",
        "format": "csv",
    }
}

POST la solicitud al servicio de informes

POST la solicitud JSON para recuperar un id. de informe.

$ curl -b cookies -c cookies -X POST -d @network_device_analytics '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 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=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2013-02-01 12:19:53",
            "json_request": "{\"report\":{\"report_type\":\"network_device_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"device_make_id\",\"device_model_id\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}

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=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2013-02-01 12:19:53",
            "json_request": "{\"report\":{\"report_type\":\"network_device_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"device_make_id\",\"device_model_id\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "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 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 .

Sugerencia

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/network_device_analytics.csv

Nota:

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