API de plataforma digital: informe de análisis de CMP de vendedores

Artículo
05/17/2024

El Informe de análisis de CMP de vendedores (Plataforma de administración de consentimiento) proporciona información sobre el número, la validez y el contenido de las cadenas de IAB Transparency & Consent Framework (IAB TCF) en las solicitudes de anuncios de vendedor a nuestros puntos de conexión. Este informe permite a los vendedores responder preguntas como:

¿Cuántas solicitudes de anuncios contienen cadenas TCF codificadas según las especificaciones de TCF V1 y V2?
¿Cuántas solicitudes de anuncios contenían cadenas TCF que no se codificaron correctamente y, por tanto, no son válidas o tienen un formato incorrecto?
¿Mi CMP (Plataforma de administración de consentimiento) pasa correctamente la información de permisos?

Información general

Este informe no demuestra ni desaprovee el cumplimiento de ninguna ley o normativa. El lenguaje "RGPD aplicado" para este informe significa lógica TCF aplicada. Apoyamos el TCF de IAB y este informe permite a los vendedores que usan el TCF confirmar que las señales TCF se comunican correctamente.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Report Service o el ejemplo siguiente.

Los vendedores que deseen que todas sus solicitudes de anuncios se traten de acuerdo con los estándares y las directivas de TCF de IAB pueden forzar la aplicación de la lógica de TCF pasando 'gdpr=1' según las especificaciones de OpenRTB de IAB. Si se omite el parámetro RGPD, pero la solicitud incluye una cadena TCF según la especificación de OpenRTB de IAB, la subasta también aplicará la lógica TCF.

Un gran número de cadenas presentes pero con formato incorrecto para un publicador determinado suele significar que el CMP del publicador no está creando ni codificando las cadenas según las especificaciones de TCF y, por lo tanto, son ilegibles para los proveedores. Las cadenas ilegibles, ya que no proporcionan señales claras a los proveedores, se tratan como ningún permiso para ningún proveedor y se deben evitar.

Para obtener más información sobre el TCF de IAB, consulte los siguientes recursos:

Período de tiempo

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

Personalizado
last_7_days
month_to_date
last_30_days

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.

Período de retención de datos

El período de retención de datos para este informe es de 30 días.

Dimensions

Column	Tipo	¿Filtro?	Ejemplo	Descripción
`month`	date	Yes	`"2010-02"`	Mes en el que se produjo la impresión.
`day`	date	Yes	`"2010-02-01"`	El día en que se produjo la impresión.
`seller_member_id`	Entero	Yes	`456`	Identificador del miembro vendedor.
`publisher_id`	Entero	Yes	`555`	Identificador del publicador asociado a la impresión.
`publisher_name`	string	No	`"PublisherA"`	Nombre del publicador asociado a la impresión.
`publisher`	string	No	`"PublisherA (555)"`	Nombre e identificador del publicador asociado a la impresión.
`call_type`	string	Sí	`"/openrtb2"`	Tipo de la solicitud de llamada de anuncio.
`url`	string	Sí	`"itunes.apple.com/us/app/weather-crave/id324565014"`	Dirección URL de la impresión entrante.

Métricas

Ejemplo

Create una solicitud de informe JSON

El archivo JSON debe incluir el report_type de "cmp_analytics", así como las columnas (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir la granularidad (month, day) y especificar el objeto en el "format" que se deben devolver los datos (csv, excelo html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.

$ cat cmp_analytics

{"report":
    {
        "report_type":"cmp_analytics",
        "columns":[
            "day",
            "seller_member_id",
            "call_type",
            "url",
            "ad_requests_gdpr_country",
            "ad_requests_gdpr_applied_valid_consent_string",
            "ad_requests_gdpr_applied_blank_consent_string",
            "ad_requests_gdpr_applied_valid_consent_string_tcf_version_2",
            "pct_ad_requests_gdpr_country_gdpr_applied",
            "pct_ad_requests_gdpr_applied_valid_consent_string",
            "pct_ad_requests_gdpr_applied_blank_consent_string",
            "pct_ad_requests_gdpr_applied_valid_consent_string_tcf_version_2",
        ],
        "report_interval":"last_7_days",
        "format":"csv"
    }
}

`POST` una solicitud al servicio de informes

POST la solicitud JSON para recuperar un identificador de informe.

$ curl -b cookies -X post -d @cmp_analytics "https://api.appnexus.com/report?seller_member_id=123"

{
   "response":{
      "status":"OK",
      "report_id":"09b6979a6a4c3805bdac8921378d3622"
   }
}

`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 'https://api.appnexus.com/report?id=09b6979a6a4c3805bdac8921378d3622'

{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2016-12-11 19:15:48",
         "json_request": "{\"report\":{\"report_type\":\"cmp_analytics\",
             \"columns\":[\"day\",\"seller_member_id\",
             \"call_type\",\"url\",\"ad_requests_gdpr_country\",\"ad_requests_gdpr_applied_valid_consent_string\",\"ad_requests_gdpr_applied_blank_consent_string\",
             \"ad_requests_gdpr_applied_valid_consent_string_tcf_version_2\",\"pct_ad_requests_gdpr_country_gdpr_applied\",
             \"pct_ad_requests_gdpr_applied_valid_consent_string\",\"pct_ad_requests_gdpr_applied_blank_consent_string\",
             \"pct_ad_requests_gdpr_applied_valid_consent_string_tcf_version_2\"],
             \"report_interval\":\"last_7_days\",\"format\":\"csv\",\"filters\":[{\"seller_member_id\":\"123\"}]}}",
             "url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "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 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 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 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/cmp_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

API de plataforma digital: informe de análisis de CMP de vendedores

Información general

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una solicitud de informe JSON

`POST` una 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

Column	Tipo	Ejemplo	Fórmula	Description
`ad_requests_gdpr_country`	Entero	`10000`	ad_requests_gdpr_country	El número de solicitudes de anuncios entrantes para las que la impresión se originó en un país que implementa el RGPD o la impresión contenía una cadena de consentimiento.
`ad_requests_gdpr_applied`	Entero	`970`	ad_requests_gdpr_applied	Número de solicitudes de anuncios entrantes a las que se aplicó la lógica de TCF. Aplicamos lógica TCF si la marca `gdpr` IAB OpenRTB Specified está establecida `1` en o si se omite la `gdpr` marca, pero la solicitud incluye un `gdpr_consent` campo. Si sus propiedades digitales pretenden usar TCF para todo el inventario cubierto por RGPD, este número debe estar cerca de `num_ad_requests_gdpr_country`.
`ad_requests_gdpr_applied_malformed_consent_string`	Entero	`876`	ad_requests_gdpr_applied_malformed_consent_string	El número de solicitudes de anuncios entrantes a las que se aplica el RGPD y la cadena de consentimiento no está en blanco, pero tiene un formato incorrecto.
`ad_requests_gdpr_applied_blank_consent_string`	Entero	`988`	ad_requests_gdpr_applied_blank_consent_string	El número de solicitudes de anuncios entrantes a las que se aplica el RGPD y la cadena de consentimiento está en blanco.
`ad_requests_gdpr_applied_invalid_consent_string_seller_revenue`	Entero	`666`	ad_requests_gdpr_applied_invalid_consent_string_seller_revenue	El número de solicitudes de anuncios a las que se atribuyen los ingresos del vendedor para las impresiones entrantes, se aplica el RGPD y la cadena de consentimiento está en blanco o malformada.
`ad_requests_gdpr_applied_valid_consent_string`	Entero	`863`	ad_requests_gdpr_applied_valid_consent_string	El número de solicitudes de anuncios entrantes a las que se aplica el RGPD y la cadena de consentimiento no es nula y válida.
`ad_requests_GDPR_applied_valid_consent_string_valid_cmp`	Entero	`564`	ad_requests_GDPR_applied_valid_consent_string_valid_cmp	El número de solicitudes de anuncios entrantes a las que se aplica el RGPD, la cadena de consentimiento es válida y el CMP usado para generar la impresión se registra en el IAB, como se muestra aquí.
`ad_requests_gdpr_applied_valid_consent_string_invalid_cmp`	Entero	`787`	ad_requests_gdpr_applied_valid_consent_string_invalid_cmp	El número de solicitudes de anuncios entrantes a las que se aplica el RGPD, la cadena de consentimiento es válida y el CMP usado para generar la impresión no está registrado en el IAB, como se muestra aquí.
`ad_requests_gdpr_applied_valid_consent_string_tcf_version_1`	Entero	`986`	ad_requests_gdpr_applied_valid_consent_string_tcf_version_1	El número de solicitudes de anuncios entrantes a las que se aplica el RGPD, la cadena de consentimiento es válida y codificada según TCF v1.
`ad_requests_gdpr_applied_valid_consent_string_tcf_version_2`	Entero	`600`	ad_requests_gdpr_applied_valid_consent_string_tcf_version_2	El número de solicitudes de anuncios entrantes a las que se aplica el RGPD, la cadena de consentimiento es válida y codificada según TCF v2.
`ad_requests_gdpr_applied_valid_consent_string_xandr_consented`	Entero	`998`	ad_requests_gdpr_applied_valid_consent_string_xandr_consented	El número de solicitudes de anuncios entrantes a las que se aplica el RGPD y el bit de proveedor de Xandr (32) es un 1 en la cadena para cadenas codificadas en TCF v1
`pct_ad_requests_gdpr_country_gdpr_applied`	double	`0.87`	pct_ad_requests_gdpr_country_gdpr_applied	Porcentaje de solicitudes de anuncios entrantes de países que implementan RGPD para los que se aplica el RGPD.
`pct_ad_requests_gdpr_applied_malformed_consent_string`	double	`0.77`	pct_ad_requests_gdpr_applied_malformed_consent_string	El porcentaje de solicitudes de anuncios entrantes a las que se aplica el RGPD y la cadena de consentimiento no está en blanco, pero tiene un formato incorrecto.
`pct_ad_requests_gdpr_applied_blank_consent_string`	double	`0.83`	pct_ad_requests_gdpr_applied_blank_consent_string	Porcentaje de solicitudes de anuncios entrantes a las que se aplica el RGPD y la cadena de consentimiento está en blanco.
`pct_ad_requests_gdpr_applied_valid_consent_string`	double	`0.91`	pct_ad_requests_gdpr_applied_valid_consent_string	Porcentaje de solicitudes de anuncios entrantes a las que se aplica el RGPD y la cadena de consentimiento no es nula y válida.
`pct_ad_requests_gdpr_applied_valid_consent_string_valid_cmp`	double	`0.77`	pct_ad_requests_gdpr_applied_valid_consent_string_valid_cmp	El porcentaje de solicitudes de anuncios entrantes a las que se aplica el RGPD, la cadena de consentimiento es válida y el CMP usado para generar la impresión se registra en el IAB, como se muestra aquí.
`pct_ad_requests_gdpr_applied_valid_consent_string_invalid_cmp`	double	`0.76`	pct_ad_requests_gdpr_applied_valid_consent_string_invalid_cmp	El porcentaje de solicitudes de anuncios entrantes para las que se aplica el RGPD, la cadena de consentimiento es válida y el CMP usado para generar la impresión NO está registrado en el IAB, como se ve [aquí][https://iabeurope.eu/cmp-list/].
`pct_ad_requests_gdpr_applied_valid_consent_string_tcf_version_1`	double	`0.65`	pct_ad_requests_gdpr_applied_valid_consent_string_tcf_version_1	El porcentaje de solicitudes de anuncios entrantes a las que se aplica el RGPD, la cadena de consentimiento es válida y codificada según TCF v1.
`pct_ad_requests_gdpr_applied_valid_consent_string_tcf_version_2`	double	`0.55`	pct_ad_requests_gdpr_applied_valid_consent_string_tcf_version_2	Porcentaje de solicitudes de anuncios entrantes a las que se aplica el RGPD, la cadena de consentimiento es válida y codificada según TCF v2
`pct_ad_requests_gdpr_applied_valid_consent_string_xandr_consented`	double	`0.73`	pct_ad_requests_gdpr_applied_valid_consent_string_xandr_consented	El porcentaje de solicitudes de anuncios entrantes a las que se aplica rgpd y el bit de proveedor de Xandr (32) es un 1 en la cadena para cadenas codificadas en TCF v1.

Compartir a través de

API de plataforma digital: informe de análisis de CMP de vendedores

Información general

Período de tiempo

Período de retención de datos

Dimensions

Métricas

Ejemplo

Create una solicitud de informe JSON

POST una 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` una solicitud al servicio de informes

`GET` estado del informe del servicio de informes

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