Compartir a través de

Informe de uso de datos para proveedores de datos

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

El time_granularity valor de los datos es hourly.

Advertencia

En el caso de las impresiones anteriores a 100 días, el día se devuelve en lugar de la hora. Para obtener instrucciones sobre cómo recuperar un informe, consulte el ejemplo siguiente.

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 Report Service.

Dimensions

Column Tipo ¿Grupo? ¿Filtro? Ejemplo Descripción
month date no sí "2010-02" Mes en el 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" Hora en la que se produjo la subasta asociada a la impresión.
buyer_member_id Entero sí sí 643 Identificador del miembro que usó los datos de terceros.
buyer_member_name string sí sí "Buyer A" Nombre del miembro que usó los datos de terceros.
advertiser_name string sí sí "Advertiser" Nombre del anunciante que usó los datos de terceros.
geo_country string sí sí "US" Código del país o región geográficos asociados a la impresión.
geo_country_name string no no "United States" Nombre del país o región geográficos asociados a la impresión.
geo_country_code string sí sí "CA" 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 códigos de país ISO 3166-1.
line_item_id Entero sí sí 12345 Identificador del elemento de línea asociado a las impresiones que usan el destino de datos de terceros.
line_item_name string no no line item name Nombre del elemento de línea asociado a las impresiones que usan el destino de datos de terceros.
data_provider_id Entero sí sí 517 Identificador del tercero que proporcionó los datos de destino.
targeted_segment_ids string no no "935035, 935146" Lista separada por comas de identificadores para cada uno de los segmentos utilizados al seleccionar como destino.
data_provider_name string no no "Peer 39 (Data Provider)" Nombre e identificador del tercero que proporcionó los datos de destino.
cpm_usd Entero sí no "0.75" Valor de CPM del segmento de datos usado

Métricas

Column Tipo Ejemplo Fórmula Descripción
Duendes Entero 34534 Duendes Número total de impresiones que usaron datos de terceros para publicar el anuncio.
data_costs dinero 3.50 imps * CPM/1000 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 Valor monetario del revshare obtenido 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 ( columns dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (mes, día, hora) y especificar el formato en el 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, consulte Report Service.

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 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.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 de informe, pero esta vez al servicio de descarga de informes . Puede encontrar el identificador de servicio e informe en el url campo de la respuesta a la llamada anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo del formato de archivo que especificó en la inicial POST.

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