Compartir a través de


Análisis de dispositivos de red

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

  • ¿Cuántas impresiones ha visto para modelos y marcas de dispositivos específicos?
  • ¿Cuántas impresiones ha visto para tipos de conexión específicos (por ejemplo, Wifi/Estático o basado en operador)?
  • ¿Cómo funcionan determinados tipos de dispositivos con respecto a otros (es decir, tabletas frente a teléfonos)?
  • ¿Cómo funcionan ciertas marca y modelos de dispositivos con respecto a otros (es decir, Android frente a Apple)?
  • ¿Cómo funcionan ciertos tipos de conexiones con respecto a otras (es decir, Wifi/Estática frente a basadas en operadores)?

Período de tiempo y zona horaria

El report_interval campo se puede establecer en uno de los siguientes:

  • 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 en los últimos 30 días. Sin embargo, dado que los datos por hora no están disponibles para este informe, start_date y end_date no pueden ser idénticos y deben tener el formato en "YYYY-MM-DD" lugar de "YYYY-MM-DD HH:MM:SS". El timezone campo de la solicitud JSON solo "UTC"se puede establecer en , pero esto no es necesario, ya que la zona horaria tiene como valor predeterminado "UTC" si no se especifica.

Período de retención de datos

Los datos de este informe se conservan durante 428 días.

Dimensions

Column Tipo ¿Filtro? Ejemplo Descripción
month time Yes "2010-02" El mes de la subasta.
day time "2010-02-01" El día de la subasta.
device_make_id Entero 1 Identificador del dispositivo en el que se ha servido la impresión. La marca suele ser el fabricante del dispositivo (es decir, Apple). Para recuperar una lista completa de identificadores y nombres de creación de dispositivos, use el servicio Device Make.
device_make_name string No "4G Systems" Nombre del dispositivo en el que se ha servido la impresión. La marca suele ser el fabricante del dispositivo (es decir, Apple).
device_make string No "4G Systems (1)" En desuso.
device_model_id Entero 15 Identificador del modelo de dispositivo en el que se ha proporcionado la impresión. El modelo es generalmente el producto específico (es decir, iPhone). Para recuperar una lista completa de los identificadores y nombres del modelo de dispositivo, use el servicio Device Make.
device_model_name string No "DX650" Nombre del modelo de dispositivo en el que se ha proporcionado la impresión. El modelo suele ser el producto específico (es decir, iPhone).
device_model string No "DX650 (15)" En desuso.
device_type string "tablets" Tipo de dispositivo en el que se ha servido 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" Tipo de conexión a Internet en el momento de la impresión. Posibles valores:
- "Carrier-based"
- "Wifi or Static"
operating_system_id Entero Yes 24 Identificador del sistema operativo del dispositivo.
- Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio extendido del sistema operativo 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" Nombre del sistema operativo del dispositivo.
- Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
operating_system_family_id Entero Yes 2 Identificador de la familia de sistemas operativos asociada al dispositivo en el que se sirvió la impresión.
- Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
operating_system_family_name string "Android" Nombre de la familia de sistemas operativos asociada al dispositivo en el que se sirvió la impresión.
- Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
browser_id Entero Yes Identificador del explorador en el que se ha servido la impresión. Para recuperar una lista completa de los identificadores y nombres del explorador, use el Servicio de explorador.
browser_name string Identificador del explorador en el que se ha servido la impresión.
browser string En desuso.
entity_member_id Entero Yes 123 Si imp_type es así:
1 (En blanco)
2 (PSA)
3 (Error predeterminado)
4 (Valor predeterminado)
6 (Revender)
8 (PSA resultante del error predeterminado), el identificador del miembro comprador; de lo contrario, el identificador del miembro vendedor.
buyer_member_id Entero Yes 123 Identificador del miembro de compra. Si no se compró la impresión, este campo muestra uno de los valores siguientes:
229 = PSA
0 = En blanco
319 = Valor predeterminado
buyer_member_name string No "My Network" Nombre del miembro que compra.
buyer_member string No "My Network (123)" En desuso.
seller_member_id Entero Yes 456 Identificador del miembro vendedor.
seller_member_name string No "That Seller" Nombre del miembro vendedor.
seller_member string No "That Seller (456)" En desuso.
buyer_type string "Real Time" Tipo de medios comprados por el miembro comprador. Valores posibles: "Real Time" o "Direct".
seller_type string "Real Time" El tipo de medios vendidos por el miembro vendedor. Valores posibles: "Real Time" o "Direct".
advertiser_id Entero Yes 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" Nombre del anunciante.
advertiser string No "Mobile Zombies (789)" En desuso.
advertiser_code string No "MZB1010" Código personalizado para el anunciante.
insertion_order_id Entero Yes 321 Identificador del orden de inserción.
insertion_order_name string No "Mobile Insertion Order" Nombre del orden de inserción.
insertion_order string No "Mobile Insertion Order (321)" En desuso.
insertion_order_code string No "Mobile Insertion Order Code" Código personalizado para el orden de inserción.
line_item_id Entero Yes 111 Identificador del elemento de línea.
line_item_name string No "Mobile Line Item" Nombre del elemento de línea.
line_item string No "Mobile Line Item (111)" En desuso.
line_item_code string No "Mobile Line Item Code" Código personalizado para el elemento de línea.
campaign_id Entero Yes 222 Identificador de la campaña.
campaign_name string No "Mobile Campaign" Nombre de la campaña.
campaign string No "Mobile Campaign (222)" En desuso.
campaign_code string No "Mobile Campaign Code" Código personalizado para la campaña.
deal_name string "My New Deal" Nombre de la oferta asociada a la transacción para la impresión.
split_id Entero Yes 342 Identificador de la división que compró las impresiones en este conjunto de datos. Las divisiones solo se aplican a los elementos de línea aumentadas. Para cualquier informe que contenga campañas, ( split_id si se incluye) será null.
split_name string "Mobile split A" Nombre de la división que compró las impresiones en este conjunto de datos. Las divisiones solo se aplican a los elementos de línea aumentadas. Para cualquier informe que contenga campañas, ( split_name si se incluye) será null.
deal_id Entero Yes 123 Identificador de la transacción asociada a la transacción para la impresión.
pixel_id Entero Yes 3849 Identificador del píxel de conversión.
media_type string "Banner" Tipo multimedia de la creatividad. Posibles valores:
- "Banner"
- "Pop"
- "Interstitial"
- "Video"
- "Text"
- "Expandable"
- "Skin"
Para recuperar una lista completa de tipos de medios, use el servicio de tipos de medios.
mediatype_id Entero Yes 1 Identificador del tipo de medio de la creatividad.
size string "728x90" Tamaño de la colocación/creatividad servida.
geo_country string "US" Código del país.
geo_country_name string No "United States" Nombre del país.
payment_type string "cpm", "revshare" Tipo de pago a un agente.
revenue_type string No "CPA" La base en la que el anunciante paga al miembro.
revenue_type_id Entero Yes 4 Identificador del tipo de ingresos. Posibles valores:
-1 = Sin pago
0 = CPM plano
1 = Costo más CPM
2 = Costo más margen
3 = CPC
4 = CPA
5 = Revshare
6 = Tarifa plana
7 = Variable CPM
8 = CPM estimado
publisher_name string No "AppSite" Nombre del publicador.
publisher string "AppSite (123)" Nombre del publicador seguido del identificador (formato Xandr).
publisher_code string No "AS123" Código personalizado para el publicador.
pub_rule_name string No "Publisher Rule Name" Nombre de la regla del publicador.
pub_rule string No "Publisher Rule Name (555)" Nombre de la regla del publicador seguido del identificador (formato Xandr).
pub_rule_code string No "AppSitePR123" Código personalizado para la regla del publicador.
bid_type string "Manual" La fase de optimización en la que se encontraba el nodo al pujar por la impresión.

Nota: El término "renunciar" se anexa a los tipos de oferta siguientes si la valoración de esa impresión está por debajo del "precio de renuncia" del lugar. Valores permitidos:
- "Manual": se aplica cuando se puja por un objetivo de CPM, ya sea Base, EAP o ECP.
- "Learn": se aplica cuando se puja con optimización (CPA, CPC o margen) y todavía no tenemos suficientes datos para optimizar la puja.
- "Optimized": se aplica cuando se puja con optimización (CPA, CPC o margen) y tenemos suficientes datos para optimizar la puja.
- "Unknown": el nodo estaba en una fase de optimización desconocida.
- "Optimized give up"
- "Learn give up"
- "Manual give up"
imp_type_id Entero Yes 6 Identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis):
1 ("En blanco"): sin creatividad.
2 ("PSA"): un anuncio de servicio público se sirvió porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible.
3 ("Error predeterminado"): una creatividad predeterminada que se sirve debido a un problema de tiempo de espera.
4 ("Valor predeterminado"): una creatividad predeterminada que se sirve porque no había pujas válidas.
5 ("Guardado"): la creatividad de su anunciante se ha servido en el sitio del editor.
6 ("Reventa"): la impresión del editor se vendió a un comprador de terceros.
7 ("RTB"): la creatividad de su anunciante se ha servido 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 a la 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" Tipo de impresión. Para obtener los valores posibles, vea imp_type_id.
venue string "Venue Name" Nombre del clúster de dominio, sitio, etiqueta y país de usuario que utiliza 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 Yes 2 Identificador de la familia de sistemas operativos asociada al dispositivo en el que se sirvió la impresión.
- Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos.
- Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.
operating_system_family_name string "Android" Nombre de la familia de sistemas operativos asociada al dispositivo en el que se sirvió la impresión.
- Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos.
Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada.

Métricas

Column Tipo Ejemplo Fórmula Descripción
imps Entero 2340 Duendes El número total de impresiones (servidas y revendidas).
imps_blank Entero 3 imps_blank Número de impresiones que se sirven con un espacio en blanco.
imps_psa Entero 5 imps_psa Número de impresiones que sirvieron a un PSA.
imps_default_error Entero 0 imps_default_error Número de impresiones predeterminadas debido a un problema de tiempo de espera.
imps_default_bidder Entero 0 imps_default_bidder Número de impresiones predeterminadas porque no había pujas válidas.
imps_kept Entero 0 imps_kept El número de impresiones que el anunciante compró a su editor.
imps_resold Entero 0 imps_resold Número de impresiones que el editor vendió a un tercero.
imps_rtb Entero 2332 imps_rtb El número de impresiones que tu anunciante compró a un tercero.
clicks Entero 1 Clics Número total de clics en todas las impresiones.
click_thru_pct double 1.12359550<br>561797% (clics/imps) x 100 Tasa de clics en impresiones como porcentaje.
ctr double 0.00022187
7080097626
clics o imps Tasa de clics en impresiones.
total_convs Entero 1 total_convs Número total de conversiones posteriores y posteriores al clic.
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 después de hacer clic.
convs_per_mm double 221.877080
097625
(total_convs/imps) x 1000 000 Número de conversiones por millón de impresiones.
convs_rate double 0.00022187
7080097626
total_convs/imps Tasa de conversiones a impresiones.
cost dinero 16.833378 costar Cantidad total de costo multimedia para el publicador directo y el inventario de terceros comprado.
cpm dinero 1.66051685
393258
(costo /imps) x 1000 Costo multimedia por cada 1000 impresiones.
revenue dinero 25.767257 booked_revenue + reseller_revenue Los ingresos totales reservados a través de anunciantes directos (artículo de línea) y editores directos (impresiones revendidas).
booked_revenue dinero 25.767257 booked_revenue Los ingresos totales reservados a través de anunciantes directos (artículo de línea).
reseller_revenue dinero 0 reseller_revenue Los ingresos totales de las impresiones revendidas a través de publicadores directos.
total_rpm dinero 2.60548314
606741
(ingresos/imps) x 1000 Ingresos por 1000 impresiones. Este valor se mostrará en USD, así como potencialmente en moneda de compra y moneda de venta (si ha seleccionado esas dimensiones).
profit dinero 0.084102 booked_revenue: total_cost Ingresos reservados menos costo total.
ppm dinero 0.94496629
2134831
(beneficio /imps) x 1000 En desuso. El beneficio por 1000 impresiones.
total_publisher_rpm dinero 1.6605168
5393258
(costo /imps) x 1000 Costo por cada 1000 impresiones pagadas a publicadores directos y de terceros, incluidos errores.
sold_publisher_rpm double 147.786 (costo /imps) x 1000 ----- sin errores Costo por cada 1000 impresiones pagadas a editores directos y de terceros, sin incluir errores.
sold_network_rpm double 231.888 (ingresos/imps) x 1000 ----- sin errores Ingresos por 1000 impresiones que no eran errores.
total_cost dinero 123.45 total_cost = media_cost + data_costs + partner_fees + comisiones + serving_fees + publisher_revenue Importe total de los costos acumulados durante el período de tiempo notificado. Por lo general, esto incluye dos tipos de costos, costos presupuestados (costo de medios, costo de datos, cuotas de asociados, cuotas de servicio, comisiones) e ingresos del publicador si realiza un seguimiento de los pagos del publicador en la plataforma.

Nota: Hemos agregado lógica para evitar el recuento doble de cuotas de terceros durante el período de cambio importante.
total_cost_ecpm dinero 123.45 (total_cost/imps) * 1000 Costo total por 1000 imps.
total_cost_ecpc dinero 123.45 total_cost/clics Costo total por clic.
total_cost_ecpa dinero 123.45 total_cost/conversiones Costo 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/imps) * 1000 Beneficio de red por 1000 imps.
network_profit_ecpc dinero 123.45 network_profit/clics Beneficio de red por clic.
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 red.
profit_ecpm dinero 123.45 ((booked_revenue - total_cost)/imps) * 1000 Beneficio por 1000 imps.
profit_ecpc dinero 123.45 (booked_revenue - total_cost)/clicks 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 ganancia 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) Este es el nombre de 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 Número total de veces que un usuario omitió el vídeo. Use esta métrica para informar al comprar inventario omitible.
video_starts Entero 11 El número total de veces que se descargó e inició 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 toda la duración.
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 las creatividades de vídeo se reproducen durante todo el tiempo.
video_served Entero 10 El número total de respuestas de vídeo que se han servido al reproductor. Una respuesta de anuncio se produce cuando se proporciona el documento VAST (XML) en respuesta a una solicitud. Una respuesta de anuncio no indica necesariamente una impresión correcta. Para una impresión, el primer fotograma del vídeo debe ser servido.
video_errors Entero 2 Número total de veces que se produjo un error de vídeo.
revenue_per_video_complete dinero 25.76 Ingresos por finalización de vídeo.
cost_per_video_complete dinero 22.76 Costo por finalización de vídeo.
video_completion_rate double 1.12359550561797% (finalizaciones de vídeo/total de impresiones) x 100 Relación entre las finalizaciones de vídeo y las impresiones, expresada como un porcentaje.
video_start_rate double 1.12359550561797% Porcentaje de veces que se descargó e inició el primer segmento de la creatividad de vídeo.
video_skip_rate double 1.12359550561797% Porcentaje de veces que el usuario optó por omitir el vídeo.

Ejemplo

Creación de una solicitud de informe con formato JSON

El archivo JSON debe incluir , report_type"network_device_analytics"así como las columnas (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (year, month, day) y especificar el formato en el que se deben devolver los datos (csv, excelo html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service. En este ejemplo, queremos ver datos de rendimiento sobre las impresiones de EE. UU. para el anunciante 1459 para cada uno de los últimos 14 días. En concreto, para cada combinación de creación de dispositivos, 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 invertido, el dinero invertido por cada 1000 impresiones, el dinero que nos ha pagado el anunciante y el beneficio total (dinero obtenido - dinero invertido).

$ 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 identificador 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 estado del informe del servicio de informes

Realice una GET llamada con el identificador de informe para recuperar el estado del informe. Continúe realizando esta GET llamada hasta que execution_status sea "ready". A continuación, 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 identificador de informe para recuperar el estado del informe. Continúe realizando esta GET llamada hasta que execution_status sea "ready". A continuación, 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 de informe, pero esta vez al servicio de descarga de informes . Puede encontrar el servicio y el identificador de informe en el url campo de la respuesta anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo de "format" que especificó en su inicial POST.

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.