Informe de análisis geográfico

El informe Geo Analytics permite desglosar la entrega y el rendimiento de las campañas por área geográfica. Algunos ejemplos de uso de este informe son:

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

Este informe puede desglosar el rendimiento de las campañas en los siguientes límites geográficos:

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, vea los ejemplos.

Nota:

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

Existe una limitación en la precisión de los datos geográficos, especialmente en las impresiones compradas a proveedores externos. Dado que algunos socios de suministro externos (como Google Ad Manager) truncan el último octeto de la IP del usuario, tenemos una IP menos precisa para usar cuando realizamos una búsqueda geográfica de IP. Como resultado, es posible que nuestros datos geográficos no siempre sean completamente precisos a niveles granulares (como la región y la DMA) para las impresiones compradas en estas fuentes 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 de este informe es de 180 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 Servicio de informes.

Dimensions

Column Tipo ¿Filtro? Description
month date Sí El año y mes en que se llevó a cabo la subasta.
day date Sí El año, mes y día en que tuvo lugar la subasta.
hourly date Sí La hora a la que tuvo lugar la subasta.
member_id Entero Sí El identificador del miembro.
advertiser_currency string Sí El tipo de moneda que usa el anunciante.
insertion_order_id Entero Sí El id. de la orden de inserción.
campaign_id Entero Sí El identificador de campaña.
campaign_name string No El nombre de la campaña asociada a la subasta.
campaign string No En desuso.
advertiser_id Entero Sí El id. del anunciante. Si el valor es 0, o bien la impresión la compró un comprador externo, o bien se mostró un valor predeterminado o PSA.
line_item_id Entero Sí El id. de la línea de pedido.
advertiser_name string No El nombre del anunciante.
advertiser string No En desuso.
split_id Entero Sí 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í 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.
campaign_code string No El código asignado por el usuario que se usa para identificar la campaña.
advertiser_code string No El código asignado por el usuario asociado con el anunciante.
geo_country_code string Sí El código de país o región de la ubicación del usuario, tal y como se define en el Servicio de país.
geo_country_id Entero Sí El identificador de país o región de la ubicación del usuario, tal y como se define en el servicio de país. 250 se muestra en los 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 y como se define en el servicio de región.
geo_region_id Entero Sí El identificador de región de la ubicación del usuario según lo definido por el servicio de región. 4291 se muestra en los casos en los que no se conoce 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 Sí El identificador de la ubicación del área de mercado designada del usuario, tal y como se define en el Servicio de área de mercado designado.

Nota: ¿Por qué veo un ID de DMA de 1?
Nuestros informes derivan DMA de la ciudad registrada para la subasta. Sin embargo, nuestro proveedor de geolocalización a veces no puede determinar una ciudad a partir de la dirección IP asociada a la impresión, incluso cuando se determina el 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 El nombre de la ubicación del área de mercado designada del usuario, según lo definido por el Servicio de área de mercado designado.
geo_postal_code string Sí El código postal de la ubicación del usuario. Para los códigos postales, consulte Servicio de códigos postales.
geo_city_id Entero Sí El identificador de la ubicación de la ciudad del usuario. Para las identificaciones de la ciudad, consulte Servicio de la ciudad.
geo_city_name string Sí El nombre de la ubicación de la ciudad del usuario. Para los nombres de las ciudades, consulte Servicio de la ciudad.
insertion_order_name string No El nombre de la orden de inserción.
insertion_order_code string No El código definido por el usuario asociado a la orden de inserción.
line_item_name string No El nombre de la línea de pedido.
line_item_code string No El código definido por el usuario asociado a la línea de pedido.
geo_country_name string No El nombre del país o región del usuario, tal y como se define en el Servicio de país.
geo_region_name string No El nombre de la región de la ubicación del usuario según lo definido por 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 Sí El 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, no puede filtrar por 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, damos por hecho que quieres ver todos estos eventos en una sola fila para poder recuperar valores precisos y agregados para la tasa de conversión y los cálculos del coste por conversión. Por ello, te recomendamos que filtres por pixel_id para poder recuperar los recuentos de conversiones y las métricas relacionadas de tus ID de píxeles más relevantes.
buying_currency string Sí La moneda de transacción que usa el comprador para comprar esta impresión.
uk_constituent_country string No El país o región del usuario. Esto es aplicable para Reino Unido. Los valores posibles son:
- England
- Scotland
- Wales
- Northern Ireland
congressional_district_id Entero Sí Identificador del distrito congresional
congressional_district_name string No El nombre del distrito congresional
state_house_district_id Entero Sí El identificador del distrito de la cámara de representantes del estado.
state_senate_district_id Entero Sí La identificación del distrito del senado estatal
state_house_district_name string No El nombre del distrito de la casa del estado
state_senate_district_name string No La identificación del distrito del senado estatal

Métricas

Column Tipo Ejemplo Fórmula Description
imps Entero Diablillos El número total de impresiones (servidas y revendidas).
clicks Entero clics El número total de clics en todas las impresiones.
cost dinero costo El costo total del inventario comprado.
booked_revenue dinero booked_revenue Los ingresos totales reservados a través de anunciantes directos (línea de pedido).
cpm dinero CPM El coste por cada mil impresiones.
total_convs Entero total_convs El número total de conversiones posteriores a la vista y a los clics.
convs_rate double total_convs / diablillos La proporción entre conversiones e 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 posteriores al clic.
profit dinero booked_revenue - total_cost Ingresos reservados menos coste total.
click_thru_pct double (clics / diablillos) x 100 La tasa de clics a impresiones, expresada como porcentaje.
external_imps Entero external_imps El número de impresiones externas (no de red).
external_clicks Entero external_clicks El número de clics externos (no 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 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.
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.
booked_revenue_buying_currency dinero Los ingresos registrados por el comprador para comprar esta impresión.
cost_buying_currency dinero El importe del coste multimedia para el editor directo y el inventario en tiempo real comprado en la moneda que usó el comprador para comprar el inventario.

Nota: Los tipos de cambio aún no están disponibles en los informes.
cpm_buying_currency dinero El coste por 1000 impresiones en la moneda que usó el comprador para comprar el inventario.

Nota: Los tipos de cambio aún no están disponibles en los informes.
cost_ecpa_buying_currency dinero El coste por adquisición o conversión en la moneda que usó el comprador para comprar el inventario.
cost_ecpc_buying_currency dinero El coste por clic en la moneda que usó el comprador para comprar el inventario.
revenue_ecpm_buying_currency dinero Los ingresos por 1000 impresiones en la moneda de compra.
revenue_ecpc_buying_currency dinero Los ingresos por clic en la moneda de compra.
revenue_ecpa_buying_currency dinero Los ingresos por conversión en la moneda de compra.
total_cost_buying_currency dinero La suma total de los costes de los medios, los costes de datos y las tarifas de los socios en la moneda de compra (del anunciante)

Ejemplos

Crear una solicitud de informe con formato JSON

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

Tenga en cuenta que cuantas más dimensiones por las 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 por 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 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 periódicamente hasta que la execution_status ."ready" Después, use el servicio de descarga de informes para guardar los datos del informe en un archivo, tal 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 id. 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.

  • Last updated on