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

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

• ¿Cuántas solicitudes de anuncios contenían cadenas TCF codificadas según las especificaciones TCF V1 y V2?
• ¿Cuántas solicitudes de anuncios contenían cadenas TCF que no se codificaron correctamente y, por lo tanto, no eran válidas o tenían un formato incorrecto?
• ¿Mi CMP (Plataforma de Gestión de Consentimiento) está pasando correctamente la información de permisos?

Información general

Este informe no prueba ni refuta el cumplimiento de ninguna ley o reglamento. El lenguaje "RGPD aplicado" para este informe significa la lógica TCF aplicada. Admitimos el TCF de IAB y este informe permite a los vendedores que usan el TCF confirmar que las señales del TCF se comunican correctamente.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Servicio de informes o el ejemplo siguiente.

Los vendedores que deseen que todas sus solicitudes de anuncios se traten de acuerdo con los estándares y políticas del TCF de la IAB pueden forzar la aplicación de la lógica del TCF aprobando 'gdpr=1' de acuerdo con la especificación OpenRTB de la IAB. Si se omite el parámetro GDPR pero la solicitud incluye una cadena TCF de acuerdo con la especificación IAB OpenRTB, la subasta también aplicará la lógica TCF.

Un número elevado de cadenas presentes pero con formato incorrecto para una editorial determinada suele significar que el CMP de la editorial no está creando o codificando las cadenas según las especificaciones del TCF y, por tanto, son ilegibles para los proveedores. Las cadenas ilegibles, debido a que no proporcionan señales claras a los proveedores, se tratan como si no tuvieran permiso para ningún proveedor y deben evitarse.

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

• Políticas de TCF de IAB Europe
• Gobernanza del TCF de IAB Europe
• Especificaciones técnicas de IAB Techlab TCF v1 y v2 & guías de implementación
• Especificación TCF RTB de IAB Techlab

Período de tiempo

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

• personalizada
• last_7_days
• month_to_date
• last_30_days

Período de retención de datos

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

Dimensions

Métricas

Ejemplo

Crear 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 la forma en que "format" se deben devolver los datos (csv, excel, o html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, vea el servicio de informes.

$ 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 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 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 '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 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 .

$ curl -b cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/cmp_analytics.csv