Informe de análisis geográfico

Artículo
05/17/2024

El informe de Geo Analytics le permite desglosar la entrega y el rendimiento de la campaña por área geográfica. Entre los casos de uso de ejemplo de este informe se incluyen:

Compradores que desean optimizar sus campañas
Compradores que necesitan informar a sus anunciantes o agencias de cliente sobre la entrega de campañas

Este informe puede desglosar el rendimiento de la campaña a lo largo de los siguientes límites geográficos:

País: ubicación del país del usuario.
Región: ubicación regional del usuario.
DMA: área de mercado designada por el usuario.

Para obtener más información sobre los campos de datos disponibles y sus definiciones, consulte Dimensiones y métricas a continuación.

Para obtener instrucciones sobre cómo ejecutar este informe, consulte ejemplos.

Nota:

Sobre la precisión de determinar la geografía del usuario por dirección IP

Existe una limitación en cuanto a la precisión de los datos geográficos, especialmente en las impresiones compradas a los asociados de suministro externos. Dado que algunos asociados de suministro externos (como Google Ad Manager) truncan el último octeto de la dirección IP del usuario, tenemos una dirección IP menos precisa que usar al realizar una búsqueda geográfica de IP. Como resultado, es posible que nuestros datos geográficos no siempre sean completamente precisos en niveles granulares (por ejemplo, región y DMA) para las impresiones compradas a partir de estos orígenes de suministro.

Período de tiempo

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

hoy
yesterday
last_7_days

Período de retención de datos

El período de retención de datos para este informe es de 45 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 Report Service.

Dimensions

Column	Tipo	¿Filtro?	Description
`month`	date	Yes	El año y el mes en que se realizó la subasta.
`day`	date	Yes	Año, mes y día en que se realizó la subasta.
`hourly`	date	Yes	Hora a la que se realizó la subasta.
`member_id`	Entero	Yes	Identificador del miembro.
`advertiser_currency`	string	Sí	Tipo de moneda utilizada por el anunciante.
`insertion_order_id`	Entero	Yes	Identificador del pedido de inserción.
`campaign_id`	Entero	Yes	Identificador de campaña.
`campaign_name`	string	No	Nombre de la campaña asociada a la subasta.
`campaign`	string	No	En desuso.
`advertiser_id`	Entero	Yes	El identificador del anunciante. Si el valor es `0`, un comprador externo compró la impresión o se mostró un valor predeterminado o PSA.
`line_item_id`	Entero	Yes	Identificador de elemento de línea.
`advertiser_name`	string	No	Nombre del anunciante.
`advertiser`	string	No	En desuso.
`split_id`	Entero	Yes	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í	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`.
`campaign_code`	string	No	Código asignado por el usuario que se usa para identificar la campaña.
`advertiser_code`	string	No	Código asignado por el usuario asociado al anunciante.
`geo_country_code`	string	Sí	El código de país de la ubicación del usuario tal como lo define el Servicio de país.
`geo_country_id`	Entero	Yes	El identificador de país de la ubicación del usuario tal como lo define el Servicio de país. `250` se muestra en casos en los que no conocemos el país o si el país no se asigna correctamente a una ubicación de nuestra base de datos.
`geo_region_code`	string	No	El código de región de la ubicación del usuario tal como lo define el servicio region.
`geo_region_id`	Entero	Yes	El identificador de región de la ubicación del usuario tal como lo define el servicio de región. `4291` se muestra en los casos en los que no conocemos la región o si la región no se asigna correctamente a una ubicación de nuestra base de datos.
`geo_dma_id`	Entero	Yes	El identificador de la ubicación del área de mercado designada por el usuario según lo definido por el servicio de área de mercado designado. Nota: ¿Por qué veo un id. de DMA de `1`? Nuestro informe deriva DMA de la ciudad registrada para la subasta. Sin embargo, nuestro proveedor geográfico a veces no puede determinar una ciudad a partir de la dirección IP asociada a la impresión, incluso cuando se determina DMA. Por lo tanto, hay casos en los que una campaña dirigida a un DMA específico tiene impresiones en los informes que muestran un DMA de `1`.
`geo_dma_name`	string	No	Nombre de la ubicación del área de mercado designada por el usuario según lo definido por el Servicio de Área de Mercado Designada.
`geo_postal_code`	string	Sí	Código postal de la ubicación del usuario. Para obtener códigos postales, consulte Servicio de códigos postales.
`geo_city_id`	Entero	Yes	Identificador de la ubicación de la ciudad del usuario. Para los identificadores de ciudad, consulte City Service.
`geo_city_name`	string	Sí	Nombre de la ubicación de la ciudad del usuario. Para obtener nombres de ciudad, consulte City Service.
`insertion_order_name`	string	No	Nombre del orden de inserción.
`insertion_order_code`	string	No	Código definido por el usuario asociado al orden de inserción.
`line_item_name`	string	No	Nombre del elemento de línea.
`line_item_code`	string	No	Código definido por el usuario asociado al elemento de línea.
`geo_country_name`	string	No	Nombre del país del usuario, tal como lo define el Servicio de país.
`geo_region_name`	string	No	Nombre de la región de la ubicación del usuario tal y como se define en el Servicio de región.
`insertion_order`	string	No	En desuso.
`line_item`	string	No	En desuso.
`geo_country`	string	No	En desuso.
`geo_region`	string	No	En desuso.
`geo_dma`	string	No	En desuso.
`pixel_id`	Entero	Yes	Número de identificación único del píxel de conversión. Nota: Esta dimensión devolverá un máximo de 10 píxeles de conversión. Además, puede filtrar por no más de 10 píxeles de conversión. Aunque `pixel_id` es agrupable, no se recomienda agrupar por esta dimensión, ya que si lo hace, los eventos de conversión se mostrarán en filas independientes de los eventos de impresión y clic. Por lo general, se supone que desea ver todos estos eventos en una sola fila para poder recuperar valores precisos y agregados para los cálculos de tasa de conversión y costo por conversión. Como resultado, se recomienda filtrar por `pixel_id` para poder recuperar recuentos de conversiones y métricas relacionadas para los identificadores de píxeles más relevantes.
`buying_currency`	string	Sí	Moneda de transacción utilizada por el comprador para comprar esta impresión.
`uk_constituent_country`	string	No	País constituyente del usuario. Esto es aplicable al Reino Unido. Los valores posibles son: - `England` - `Scotland` - `Wales` - `Northern Ireland`
`congressional_district_id`	Entero	Yes	El identificador del distrito congresional
`congressional_district_name`	string	No	El nombre del distrito congresional
`state_house_district_id`	Entero	Yes	El identificador del distrito de la casa de estado
`state_senate_district_id`	Entero	Yes	El identificador del distrito estatal del Senado
`state_house_district_name`	string	No	Nombre del distrito de la casa estatal
`state_senate_district_name`	string	No	El identificador del distrito estatal del Senado

Métricas

Column	Tipo	Ejemplo	Fórmula	Description
`imps`	Entero		Duendes	El número total de impresiones (servidas y revendidas).
`clicks`	Entero		Clics	Número total de clics en todas las impresiones.
`cost`	Dinero		Costo	Costo total del inventario comprado.
`booked_revenue`	Dinero		booked_revenue	Los ingresos totales reservados a través de anunciantes directos (artículo de línea).
`cpm`	Dinero		Cpm	El costo por mil impresiones.
`total_convs`	Entero		total_convs	Número total de conversiones posteriores y posteriores al clic.
`convs_rate`	double		total_convs/imps	Relación entre las conversiones y las impresiones.
`post_view_convs`	Entero		post_view_convs	Número total de conversiones posteriores a la vista registradas.
`post_click_convs`	Entero		post_click_convs	Número total de conversiones registradas después de hacer clic.
`profit`	Dinero		booked_revenue: total_cost	Ingresos reservados menos costo total.
`click_thru_pct`	double		(clics/imps) x 100	Tasa de clics en impresiones, expresada como porcentaje.
`external_imps`	Entero		external_imps	Número de impresiones externas (que no son de red).
`external_clicks`	Entero		external_clicks	Número de clics externos (que no son de red).
`booked_revenue_adv_curr`	Dinero		booked_revenue_adv_curr	Los ingresos totales reservados a través de un anunciante directo, expresados en la moneda de ese anunciante.
`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.
`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.
`booked_revenue_buying_currency`	Dinero			Los ingresos reservados por el comprador para comprar esta impresión.
`cost_buying_currency`	Dinero			La cantidad de costo de medios para el editor directo y el inventario comprado en tiempo real en la moneda que el comprador usó para comprar el inventario. Nota: Las tasas de cambio aún no están disponibles en los informes.
`cpm_buying_currency`	Dinero			El costo por cada 1000 impresiones en la moneda que el comprador usó para comprar el inventario. Nota: Las tasas de cambio aún no están disponibles en los informes.
`cost_ecpa_buying_currency`	Dinero			Costo por adquisición o conversión en la moneda que el comprador usó para comprar el inventario.
`cost_ecpc_buying_currency`	Dinero			Costo por clic en la moneda que el comprador usó para comprar el inventario.
`revenue_ecpm_buying_currency`	Dinero			Los ingresos por 1000 impresiones en la moneda de compra.
`revenue_ecpc_buying_currency`	Dinero			Ingresos por clic en la moneda de compra.
`revenue_ecpa_buying_currency`	Dinero			Ingresos por conversión en la moneda de compra.
`total_cost_buying_currency`	Dinero			La suma total de los costos de medios, los costos de datos y las tarifas de los asociados en la moneda de compra (anunciante)

Ejemplos

Create una solicitud de informe con formato JSON

El archivo debe contener el report_type de "geo_analytics" , así como las columnas y report_interval que desea recuperar. Para obtener una explicación completa de los campos que se pueden incluir en el archivo, consulte el servicio de informes.

Tenga en cuenta que cuantos más dimensiones agrupe, mayor será el conjunto de datos que se devuelve. Los conjuntos de datos más grandes pueden tardar mucho más en procesarse, por lo que asegúrese de agrupar solo las dimensiones que necesite.

$ cat geo_analytics

{
    "report":{
        "report_type":"geo_analytics",
        "timezone":"EST5EDT",
        "report_interval":"last_7_days",
        "groups":[
            "advertiser_id"
        ],
        "columns":[
            "advertiser_id",
            "imps",
            "clicks",
            "click_thru_pct",
            "total_convs",
            "convs_rate",
            "booked_revenue",
            "cost",
            "profit",
            "cpm"
        ],
        "orders":[
            "advertiser_id",
            "imps",
            "clicks",
            "click_thru_pct",
            "total_convs",
            "convs_rate",
            "booked_revenue",
            "cost",
            "profit",
            "cpm"
        ]
    }
}

`POST` la solicitud al servicio de informes

$ curl -b cookies -X POST -d @geo_analytics 'https://api.appnexus.com/report'
{
  "response": {
    "status": "OK",
    "report_id": "58e7a1db8d0ccf222e21ffc7c3cd01fb"
  }
}

`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 periódicamente 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 muestra en el paso siguiente.

$ curl -b cookies "https://api.appnexus.com/report?id=58e7a1db8d0ccf222e21ffc7c3cd01fb"

{
    "response": {
        
        "execution_status": "ready",
        "report": {
            "url": "https://hb.nym1.sand-08.adnxs.net/report-download?id=58e7a1db8d0ccf222e21ffc7c3cd01fb",
            "query_time": "0",
            "finished_on": "2013-02-19 18:28:51",
            "started_on": "2013-02-19 18:28:48",
            "entity_id": "0",
            "user_id": "2027",
            "report_size": "93",
            "row_count": "0",
            "header_info": "Report ID:,58e7a1db8d0ccf222e21ffc7c3cd01fb
Run at:,2013-02-19 18:28:46
Start date:,2013-02-12 05:00:00
End date:,2013-02-19 05:00:00
Timezone:,EST5EDT
User:,Ursula Nimbus (2027)
",
            "json_request": "{"report":{"report_type":"geo_analytics","timezone":"EST5EDT","report_interval":"last_7_days","groups":["advertiser_id"],"columns":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"],"pivot_report":false,"fixed_columns":[],"orders":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"],"name":" Report - 02\/19\/2013","ui_columns":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"]}}",
            "fact_cache_error": "did not find any cache table for 30,31,36,66,32,34",
            "fact_cache_hit": false,
            "cache_hit": false,
            "created_on": "2013-02-19 18:28:46",
            "name": " Report - 02/19/2013"
        },
        "status": "OK"
    }
}

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

Use el servicio de descarga de informes para descargar los datos en un archivo. El nombre del servicio y el identificador de informe se pueden extraer del url campo en la respuesta.

$ curl -b cookies "https://api.appnexus.com/report-download?id=58e7a1ddb80ccf222e21ffc7c3cd01fb" > /tmp/geo_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

Informe de análisis geográfico

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplos

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

Informe de análisis geográfico

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplos

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

`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