API De plateforme numérique - Rapport Seller CMP Analytics

Le rapport d’analyse CMP vendeur (Consent Management Platform) fournit des informations sur le nombre, la validité et le contenu des chaînes IAB Transparency & Consent Framework (IAB TCF) sur les demandes d’annonces des vendeurs adressées à nos points de terminaison. Ce rapport permet aux vendeurs de répondre à des questions telles que :

• Combien de demandes publicitaires contenaient des chaînes TCF encodées conformément aux spécifications TCF V1 et V2 ?
• Combien de demandes publicitaires contenaient des chaînes TCF qui n’étaient pas encodées correctement et donc non valides ou mal formées ?
• Ma plateforme de gestion des consentements (CMP) transmet-elle correctement les informations d’autorisation ?

Vue d’ensemble

Ce rapport ne prouve pas ou ne réfutera pas la conformité aux lois ou réglementations. Le langage « RGPD appliqué » pour ce rapport signifie une logique TCF appliquée. Nous prenons en charge le TCF IAB et ce rapport permet aux vendeurs qui utilisent le TCF de confirmer que les signaux TCF sont communiqués correctement.

Pour obtenir des instructions sur la récupération d’un rapport, consultez Service de rapports ou l’exemple ci-dessous.

Les vendeurs qui souhaitent que toutes leurs demandes publicitaires soient traitées conformément aux normes et stratégies TCF de l’IAB peuvent forcer l’application de la logique TCF en passant 'gdpr=1' en fonction de la spécification IAB OpenRTB. Si le paramètre RGPD est omis, mais que la demande inclut une chaîne TCF conformément à la spécification OpenRTB IAB, l’enchère applique également la logique TCF.

Un nombre élevé de chaînes présentes mais mal formées pour un éditeur donné signifie généralement que le CMP de l’éditeur ne crée pas ou n’encode pas les chaînes conformément aux spécifications TCF, et est donc illisible pour les fournisseurs. Les chaînes illisibles, car elles ne fournissent pas de signaux clairs aux fournisseurs, sont traitées comme n’importe quelle autorisation pour un fournisseur et doivent être évitées.

Pour plus d’informations sur le TCF IAB, reportez-vous aux ressources suivantes :

• Politiques TCF d’IAB Europe
• Gouvernance TCF d’IAB Europe
• IAB Techlab TCF v1 et v2 Technical Spec & Implementation Guides
• Spécification IAB Techlab TCF RTB

Période

Le report_interval champ dans la requête JSON peut être défini sur l’une des valeurs suivantes :

• Personnalisé
• last_7_days
• month_to_date
• last_30_days

Période de conservation des données

La période de conservation des données pour ce rapport est de 30 jours.

Dimensions

Mesures

Exemple

Create une demande de rapport JSON

Le fichier JSON doit inclure le report_type de "cmp_analytics", ainsi que les colonnes (dimensions et métriques) et report_interval que vous souhaitez récupérer. Vous pouvez également filtrer des dimensions spécifiques, définir la granularité (month, day) et spécifier le "format" dans lequel les données doivent être retournées (csv, excel, ou html). Pour obtenir une explication complète des champs qui peuvent être inclus dans le fichier JSON, consultez service de rapports.

$ 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 une requête adressée au service de rapports

POST demande JSON pour récupérer un ID de rapport.

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

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

GETle rapport status à partir du service de rapports

Effectuez un GET appel avec l’ID de rapport pour récupérer les status du rapport. Continuez à effectuer cet GET appel jusqu’à ce que soit execution_status"ready". Utilisez ensuite le service de téléchargement de rapports pour enregistrer les données du rapport dans un fichier, comme décrit à l’étape suivante.

$ 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 les données de rapport du service de téléchargement de rapports

Pour télécharger les données du rapport dans un fichier, effectuez un autre GET appel avec l’ID de rapport, mais cette fois au service de téléchargement de rapports . Vous trouverez l’ID de service et de rapport dans le url champ de la réponse à votre appel précédent GET . Lorsque vous identifiez le fichier dans lequel vous souhaitez enregistrer, veillez à utiliser l’extension de fichier du format de fichier que vous avez spécifié dans votre fichier initial POST.

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