Análisis de operador de red

El informe de análisis de operadores de red permite recuperar datos de rendimiento del lado de la compra y del lado de la venta en función de los operadores para dispositivos. Esto es especialmente útil para analizar cómo afectan los operadores al rendimiento de la campaña y al pago de los anunciantes. Además, en los casos en que los anunciantes configuran páginas de destino específicas para cada operador, este informe te ayuda a identificar los operadores en los que se publicaron las campañas.

Para obtener instrucciones sobre cómo solicitar y recuperar este informe, consulta el siguiente ejemplo .

Período de tiempo

El report_interval campo se puede establecer en uno de los siguientes (en zona horaria UTC):

  • hoy
  • yesterday
  • last_2_days
  • last_7_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 14 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

El período de retención de datos del informe es de 46 días.

Dimensions

Column Tipo ¿Filtro? Ejemplo Descripción
month time Sí "2010-02" El mes de la subasta.
day time Sí "2010-02-01" El día de la subasta.
carrier_id Entero Sí 20 El ID del operador del dispositivo en el que se ha servido la impresión. Para obtener una lista completa de identificadores y nombres de operadores, use el Servicio de operador.
carrier_name string No "Sprint - FR" El nombre del operador del dispositivo en el que se ha enviado la impresión.
carrier string No "Sprint - FR (20)" En desuso.
device_type string Sí "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 Sí "Carrier-based" El tipo de conexión a Internet en el momento de la impresión. Valores posibles: "Carrier-based" o "Wifi or Static".
entity_member_id Entero Sí 123 Si imp_type es 1 (En blanco), 2 (PSA), 3 (Error de incumplimiento), 4 (Incumplimiento), 6 (Revendido) o 8 (PSA resultante de un error de incumplimiento), la identificación del miembro comprador; de lo contrario, la identificación del miembro vendedor.
buyer_member_id Entero Sí 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 Sí 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 Sí "Real Time" El tipo de medios adquiridos por el miembro comprador. Valores posibles: "Real Time" o "Direct".
seller_type string Sí "Real Time" El tipo de contenido multimedia vendido por el miembro vendedor. Valores posibles: "Real Time" o "Direct".
advertiser_id Entero Sí 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 Sí 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 Sí 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 Sí 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.
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 2" 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.
pixel_id Entero Sí 3849 El identificador del píxel de conversión.
media_type string Sí "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 Sí 1 El identificador del tipo de medio de la creatividad.
size string Sí "728x90" El tamaño de la ubicación/creatividad servida.
geo_country string Sí "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 Sí "com", "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 Sí 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 string Sí "AppSite (123)" En desuso.
publisher_code string No "Publisher Code" 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)" En desuso.
pub_rule_code string No "AppSitePR123" El código personalizado de la regla del editor.
bid_type string Sí "Manual" La fase de optimización en la que se encontraba el nodo cuando puja por la impresión. Tenga en cuenta que 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. Para obtener más información, consulte ¿Qué es un lugar? y Renuncia al precio en la documentación de la interfaz de usuario.
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 Sí 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 Sí "Resold" El tipo de impresión. Para conocer los posibles valores, consulta imp_type_id.
venue string Sí "Venue Name" El nombre del clúster de dominio, sitio, etiqueta y país o región del usuario que usa el sistema de optimización de Xandr para determinar las valoraciones de las ofertas. Una campaña no puede dirigirse explícitamente a un lugar.

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.12359550561797% (clics / diablillos) x 100 La tasa de clics a impresiones como porcentaje.
ctr double 0.000221877080097626 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.877080097625 (total_convs / diablillos) x 1.000.000 El número de conversiones por millón de impresiones.
convs_rate double 0.000221877080097626 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.66051685393258 (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.
rpm dinero 2.60548314606741 (ingresos / diablillos) x 1000 Los ingresos por cada 1000 impresiones.
profit dinero 0.084102 booked_revenue - total_cost Ingresos reservados menos coste total.
ppm dinero 0.944966292134831 (ganancias / imps) x 1000 En desuso. El beneficio por cada 1000 impresiones.
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.
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.
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 de "network_carrier_analytics", 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 la forma en que "format" 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 el rendimiento de las campañas en teléfonos móviles y tabletas en tres operadores específicos. En concreto, para cada combinación de operador y tipo de dispositivo, 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_carrier_analytics

{
    "report": {
        "report_type": "network_carrier_analytics",
        "filters": [
            {
                "carrier_id": [
                    345,
                    567,
                    837
                ]
            },
            {
                "device_type": [
                    "mobile phones",
                    "tablets"
                ]
            }
        ],
        "columns": [
            "day",
            "carrier_id",
            "device_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_carrier_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_carrier_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"carrier_id\",\"device_make\",\"device_model\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "url": "report-download?id=097f59fc3ab7d02c5d60db42081d9b69"
      },
      "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 .

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=097f59fc3ab7d02c5d60db42081d9b69' > /tmp/network_carrier_analytics.csv

Nota:

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

  • Last updated on