Análisis de operadores de red

Artículo
05/18/2024

El informe Network Carrier Analytics le permite recuperar datos de rendimiento de compra y venta basados en operadores para dispositivos. Esto resulta especialmente útil para analizar cómo afectan los operadores al rendimiento de la campaña y al pago de anunciantes. Además, en los casos en los que los anunciantes configuran páginas de aterrizaje específicas para cada operador, este informe le ayuda a identificar los operadores en los que se ejecutaron campañas.

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

Período de tiempo

El report_interval campo se puede establecer en uno de los siguientes (en la 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 en los últimos 14 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

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

Dimensions

Column	Tipo	¿Filtro?	Ejemplo	Descripción
`month`	time	Yes	`"2010-02"`	El mes de la subasta.
`day`	time	Yes	`"2010-02-01"`	El día de la subasta.
`carrier_id`	Entero	Sí	`20`	Identificador del operador del dispositivo en el que se ha notificado la impresión. Para recuperar una lista completa de identificadores y nombres de operador, use el Servicio de operador.
`carrier_name`	string	No	`"Sprint - FR"`	Nombre del operador del dispositivo en el que se ha servido la impresión.
`carrier`	string	No	`"Sprint - FR (20)"`	En desuso.
`device_type`	string	Sí	`"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	Sí	`"Carrier-based"`	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	Yes	`123`	Si `imp_type` es `1` (En blanco), `2` (PSA), `3` (error predeterminado), `4` (valor predeterminado), `6` (revender) o `8` (PSA resultante del error predeterminado), el identificador del miembro de compra; en caso 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	Sí	`"Real Time"`	Tipo de medios comprados por el miembro comprador. Valores posibles: `"Real Time"` o `"Direct"`.
`seller_type`	string	Sí	`"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.
`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	Sí	`"Mobile Split 2"`	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`.
`pixel_id`	Entero	Yes	`3849`	Identificador del píxel de conversión.
`media_type`	string	Sí	`"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	Sí	`"728x90"`	Tamaño de la colocación/creatividad servida.
`geo_country`	string	Sí	`"US"`	Código del país.
`geo_country_name`	string	No	`"United States"`	Nombre del país.
`payment_type`	string	Sí	`"com"`, `"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`	string	Sí	`"AppSite (123)"`	En desuso.
`publisher_code`	string	No	`"Publisher Code"`	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)"`	En desuso.
`pub_rule_code`	string	No	`"AppSitePR123"`	Código personalizado para la regla del publicador.
`bid_type`	string	Sí	`"Manual"`	La fase de optimización en la que se encontraba el nodo al pujar por la impresión. Tenga en cuenta que 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. Para obtener más información, consulte ¿Qué es un lugar? y Precio de entrega en la documentación de la interfaz de usuario. 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	Sí	`"Resold"`	Tipo de impresión. Para obtener los valores posibles, vea `imp_type_id`.
`venue`	string	Sí	`"Venue Name"`	Nombre del clúster de dominio, sitio, etiqueta y país de usuario que usa el sistema de optimización de Xandr para determinar las valoraciones de las pujas. Una campaña no puede dirigirse explícitamente a un lugar.

Métricas

Column	Tipo	Ejemplo	Fórmula	Description
`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.12359550561797%`	(clics/imps) x 100	Tasa de clics en impresiones como porcentaje.
`ctr`	double	`0.000221877080097626`	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.877080097625`	(total_convs/imps) x 1000 000	Número de conversiones por millón de impresiones.
`convs_rate`	double	`0.000221877080097626`	total_convs/imps	Tasa de conversiones a impresiones.
`cost`	Dinero	`16.833378`	Costo	Cantidad total de costo multimedia para el publicador directo y el inventario de terceros comprado.
`cpm`	Dinero	`1.66051685393258`	(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.
`rpm`	Dinero	`2.60548314606741`	(ingresos/imps) x 1000	Ingresos por 1000 impresiones.
`profit`	Dinero	`0.084102`	booked_revenue: total_cost	Ingresos reservados menos costo total.
`ppm`	Dinero	`0.944966292134831`	(beneficio /imps) x 1000	En desuso. El beneficio por 1000 impresiones.
`total_publisher_rpm`	Dinero	`1.66051685393258`	(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.
`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

Create 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 granularidad (, , ) y especificar en el "format" que se deben devolver los datos (csv, excelo html). daymonthyear 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 cómo funcionan 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 invertido, el dinero invertido por 1000 impresiones, el dinero que nos ha pagado el anunciante y el beneficio total (dinero ganado - dinero invertido).

$ 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 identificador 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` 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_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 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=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.

Compartir a través de

Análisis de operadores de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una solicitud de informe con formato JSON

`POST` la solicitud al servicio de informes

`GET` estado del informe del servicio de informes

`GET` los datos del informe del servicio de descarga de informes

Recursos adicionales

Compartir a través de

Análisis de operadores de red

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una solicitud de informe con formato JSON

POST la solicitud al servicio de informes

GET estado del informe del servicio de informes

GET los datos del informe del servicio de descarga de informes

Temas relacionados

Recursos adicionales

`POST` la solicitud al servicio de informes

`GET` estado del informe del servicio de informes

`GET` los datos del informe del servicio de descarga de informes