Informe de uso de datos para proveedores de datos

Este informe proporciona detalles relacionados con el uso que hace de los datos proporcionados por terceros (por ejemplo, proveedores de segmentos de usuarios), los costes de ese uso de datos y las campañas en las que se usaron esos datos para dirigirse a los usuarios.

El time_granularity de los datos es hourly.

Advertencia

Para las impresiones de más de 100 días, se devuelve el día en lugar de la hora. Para obtener instrucciones sobre cómo recuperar un informe, consulta el siguiente ejemplo .

Período de tiempo

El report_interval campo de la solicitud JSON debe establecerse en uno de los siguientes:

today
yesterday
last_7_days
last_30_days
month_to_date
quarter_to_date
last_month
lifetime

Sugerencia

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	grupo?	¿Filtro?	Ejemplo	Descripción
month	date	no	sí	`"2010-02"`	El mes en que se produjo la subasta asociada a la impresión
día	date	sí	sí	`"2010-02-01"`	El día en que se produjo la subasta asociada a la impresión
hora	date	sí	sí	`"2010-02-01 05:00:00"`	La hora en la que se produjo la subasta asociada a la impresión.
buyer_member_id	Entero	sí	sí	`643`	El identificador del miembro que usó los datos de terceros.
buyer_member_name	string	sí	sí	`"Buyer A"`	El nombre del miembro que usó los datos de terceros.
advertiser_name	string	sí	sí	`"Advertiser"`	El nombre del anunciante que usó los datos de terceros.
geo_country	string	sí	sí	`"US"`	El código del país o región geográficos asociado a la impresión.
geo_country_name	string	no	no	`"United States"`	El nombre del país o región geográficos asociado a la impresión.
geo_country_code	string	sí	sí	`"CA"`	Una cadena de dos caracteres que indica el país o región asociado a la impresión. Para obtener una lista completa de los valores permitidos, consulte los códigos de país ISO 3166-1.
line_item_id	Entero	sí	sí	`12345`	El identificador de la línea de pedido asociada a las impresiones que usan la segmentación por datos de terceros.
line_item_name	string	no	no	`line item name`	El nombre de la línea de pedido asociada a las impresiones que usan la segmentación por datos de terceros.
data_provider_id	Entero	sí	sí	`517`	El identificador del tercero que proporcionó los datos de segmentación.
targeted_segment_ids	string	no	no	`"935035, 935146"`	La lista de identificadores separados por comas para cada uno de los segmentos que se usan al segmentar.
data_provider_name	string	no	no	`"Peer 39 (Data Provider)"`	El nombre y la identificación del tercero que proporcionó los datos de segmentación.
cpm_usd	Entero	sí	no	`"0.75"`	El valor de CPM del segmento de datos usado

Métricas

Column	Tipo	Ejemplo	Fórmula	Descripción
Diablillos	Entero	`34534`	Diablillos	El número total de impresiones que usaron datos de terceros para publicar el anuncio.
data_costs	dinero	`3.50`	diablillos * CPM/1000	El valor monetario de los segmentos de datos que se compraron a proveedores de datos de terceros.
data_clearing_fee_usd	dinero	`0.50`	data_costs * Xandr revshare	El valor monetario de la revshare ganada por Xandr.
data_provider_payout_usd	dinero	`3.00`	data_costs - data_clearing_fee_usd	El valor monetario de los ingresos que se pagaron o se pagarán al proveedor de datos.

Ejemplo

Paso 1: Cree la solicitud de informe JSON.

El archivo JSON debe incluir el report_type de "data_usage_analytics_for_data_providers", así como el columns (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir la granularidad (mes, día, hora) y especificar el formato en que se deben devolver los datos (CSV, Excel o HTML).

$ cat data_usage_analytics
        {"report":
                {
                        "format": "csv",
                        "report_interval": "yesterday",
                        "row_per": ["geo_country"],
                        "columns": ["imps","campaign_id","geo_country"],
                        "report_type": "data_usage_analytics_for_data_providers"
                }
         }

Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, vea el servicio de informes.

Paso 2: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 @data_usage_analytics "https://api.adnxs.com/report?member_id=MEMBER_ID"
         {
            "response":{
               "status":"OK",
               "report_id":"c445bca183a3d338dc1c5b85a3d484f5"
            }
         }

Paso 3:GET el estado del informe del 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.adnxs.com/report?id=c445bca183a3d338dc1c5b85a3d484f5'
         {
            "response": {
                "status": "OK",
                "report": {
                    "name": null,
                    "created_on": "2014-11-19 22:33:31",
                    "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"geo_country\"],\"columns\":[\"imps\",\"campaign_id\",\"geo_country\"],\"report_type\":\"buyer_data_usage_analytics\",\"filters\":[{\"buyer_member_id\":\"958\"}]}}",
                    "url": "report-download?id=c445bca183a3d338dc1c5b85a3d484f5"
                },
                "execution_status": "ready"
            }
         }

Paso 4: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 del informe, pero esta vez al servicio de descarga de informes . Puede encontrar el servicio y el ID del informe en el url campo de la respuesta a su llamada anterior GET . Al identificar el archivo en el que desea guardarlo, asegúrese de usar la extensión de archivo del formato de archivo que especificó en POSTel archivo .

Sugerencia

Si se produce un error durante la descarga, el encabezado de respuesta incluye 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.adnxs.com/report-download?id=c445bca183a3d338dc1c5b85a3d484f5' > /tmp/data_usage_analytics.csv

Last updated on 2026-08-18

Informe de uso de datos para proveedores de datos

Período de tiempo

Dimensions

Métricas

Ejemplo

Recursos adicionales