Résoudre les problèmes liés à l'intégration de la version 2.0 du TCF

L'IAB Europe a finalisé la version 2.0 de son Transparency and Consent Framework (TCF, Cadre de transparence et de consentement), développé conjointement avec l'IAB Tech Lab et des entreprises membres. Google est désormais entièrement compatible avec la version 2.0 du TCF.

Afin de laisser aux éditeurs le temps de gérer les erreurs et les mauvaises configurations liées au lancement du Transparency & Consent Framework v2.0 de l'IAB Europe, Google leur fournira un rapport sur les erreurs détectées et leur accordera un délai de grâce de 150 jours pour résoudre les erreurs.


Voici le sommaire de cet article, qui explique comment résoudre les erreurs d'implémentation de TCF v2.0 :


Consignes mises à jour

Changements

Correction des erreurs courantes

Voici comment résoudre certaines des erreurs les plus courantes dans Ad Manager, AdSense et AdMob :

Redemandez le consentement des utilisateurs avec les chaînes TC non associées à la monétisation
(Erreurs 1.1, 3.1, 4.1, 5.1, 5.2 et 6.1)

Erreur(s) associée(s)

Erreur 1.1. Cette consigne peut également s'appliquer aux erreurs 3.1, 4.1, 5.1, 5.2 et 6.1.

Consigne mise à jour

Vous pouvez redemander le consentement des utilisateurs.

Explication

Les éditeurs peuvent redemander le consentement s'ils utilisaient précédemment des chaînes associées à un champ d'application externe ou global, des ID de PGC non valides (issus des tests), des ID de liste globale des fournisseurs (LGF) non valides (issus des tests), ou si les éditeurs ont omis Google comme fournisseur avec le consentement approprié au cours de l'intégration.

Erreurs 1.1, 1.2, 1.3 : Il est important de vérifier si ces erreurs concernent un volume de trafic élevé. Si c'est le cas, il s'agit peut-être d'un problème au niveau de la PGC. De plus, assurez-vous que le consentement est accordé à Google pour les motifs nécessaires, et que Google est déclaré comme fournisseur pour le consentement ET l'intérêt légitime (ID de fournisseur : 755).

Spécification de l'IAB

Conformément aux spécifications de l'IAB, les PGC peuvent mettre en cache les chaînes de consentement pendant 13 mois.

Certaines PGC ont conservé la date du premier consentement et l'ont prolongé, ce qui n'est pas accepté. La date de consentement doit toujours correspondre à la dernière date d'une chaîne de consentement donnée.
Suggestion : Demandez à votre PGC de renvoyer les appels de AddEventHandler dans un délai de 500 ms
(Erreurs 2.1a, 2.1b, 2.2a, 2.2b et 2.2c)

Erreur(s) associée(s)

Erreur 2.1a. Cette consigne peut également s'appliquer aux erreurs 2.1b, 2.2a, 2.2b et 2.2c.

Consigne mise à jour

Même si nous n'imposons plus de délai avant expiration, nous conseillons aux PGC d'examiner attentivement leurs intégrations pour s'assurer qu'elles renvoient immédiatement les appels à AddEventListener getTCData.

Si une PGC ne répond pas, la demande risque de ne pas être monétisée.

Explication

Google respecte la spécification de l'IAB stipulant qu'une PGC doit répondre immédiatement à la fonction AddEventListener. Si une PGC ne répond pas immédiatement, la demande risque de ne pas être monétisée.

En outre, les réponses de la PGC font partie de la chaîne d'événements qui ont une incidence sur le délai requis avant d'effectuer une demande d'annonce. Si le délai entre le chargement de la page et les demandes d'annonces diminue, l'éditeur perd moins d'impressions.

Spécification de l'IAB

Spécification de l'IAB applicable : spécification AddEventListener (sur GitHub)

Le rappel AddEventListener doit être appelé immédiatement après l'enregistrement avec les données TC actuelles, même si l'état de la PGC indique loading (chargement en cours) et si la PGC comporte des données TC incomplètes. Cela permet au script appelant d'accéder à son listenerId enregistré. De plus, le rappel doit être appelé lors de chaque modification d'une chaîne TC, sauf s'il est supprimé via RemoveEventListener.

Rapport d'erreurs

Nous informerons les éditeurs dans l'interface utilisateur du produit si nous détectons un problème au niveau de la chaîne de TC associée à un ou plusieurs de leurs sites ou applications. Sur la page "Consentement de l'utilisateur dans l'UE" de leur compte, les éditeurs ayant reçu des erreurs peuvent cliquer sur Télécharger le rapport d'erreurs du TCF afin de télécharger un rapport détaillé sur les erreurs détectées au cours des sept derniers jours.

Ce rapport n'est disponible que si des erreurs ont été détectées au cours des sept derniers jours.
Pour accéder à la page "Consentement de l'utilisateur dans l'UE" et au rapport d'erreurs du TCF :
  • Ad Manager : cliquez sur Admin puis Consentement de l'utilisateur dans l'UE.
  • AdMob et AdSense : cliquez sur Paramètres de blocage puis Consentement de l'utilisateur dans l'UE.

Le rapport contiendra les informations suivantes pour chaque erreur détectée : 

  • Domaine/MobileAppID : site ou application mobile dont la configuration est incorrecte.
  • Chemin d'accès du bloc d'annonces : bloc d'annonces associé à l'erreur.
  • Code d'erreur : code attribué à l'erreur.
  • Nombre d'erreurs : nombre de requêtes contenant l'erreur détectées la semaine précédente.
  • Date de la dernière détection : date à laquelle l'erreur a été détectée pour la dernière fois. 

Les codes d'erreur répertoriés dans le rapport permettent aux éditeurs de rechercher les actions suggérées dans les tableaux de dépannage suivants et de corriger les erreurs.

Dépannage

Afin d'aider les éditeurs à résoudre les problèmes liés à une mauvaise configuration des intégrations de la version 2.0 du TCF de l'IAB, nous avons créé les tableaux suivants comprenant les erreurs de chaîne TC les plus courantes, ainsi que les recommandations de dépannage correspondantes.

Utilisez ces tableaux pour comprendre les problèmes qui se produisent au niveau des demandes d'annonces ainsi que le comportement système correspondant.

Scénarios de consentement limité

Les scénarios 1.1 et 1.3 se traduisent toujours par des demandes d'annonces refusées et non satisfaites, contrairement au scénario 1.2. Ces trois scénarios prévalent toujours sur les erreurs de configuration, même si une demande donnée en comporte plusieurs.

Scénario Description Action suggérée
1.1 Google, en tant que fournisseur, n'obtient pas d'autorisation par rapport au consentement ou à l'intérêt légitime. Les demandes d'annonces sont refusées et non satisfaites. Vérifiez si l'utilisateur a refusé intentionnellement Google en tant que fournisseur, si des erreurs d'implémentation de la PGC se sont produites ou s'il existe des restrictions applicables aux éditeurs.
1.2 Aucun consentement pour la première finalité pour les pays de l'EEE et le Royaume-Uni.

Vérifiez si l'utilisateur a refusé la première finalité intentionnellement ou si le problème est dû à des erreurs d'intégration de la PGC.

Les éditeurs allemands doivent s'assurer de définir correctement les champs PublisherCC et PurposeOneTreatment s'ils ne demandent pas le consentement des utilisateurs.
1.3 Consentement obtenu pour la première finalité, mais absence de bases juridiques pour les annonces standards. Les demandes d'annonces sont refusées et non satisfaites.

Vérifiez si l'utilisateur a refusé intentionnellement les intérêts légitimes pour les autres finalités ou si le problème est dû à des erreurs d'implémentation de la PGC.

Erreur de configuration

Les demandes d'annonces ne sont pas satisfaites tant qu'il existe des erreurs de configuration.

Erreur Description Action suggérée
2.1a Le tag ou le SDK ne reçoit pas de chaîne de TC, car l'état de la PGC correspond à stub, loading ou error.

Si vous appelez manuellement la fonction pour demander des annonces, assurez-vous que la réponse est la suivante : getTCData TCData.eventStatus = 'tcloaded' OR 'cmpuishown' + 'useractioncomplete'. Ces valeurs indiquent que le fournisseur de gestion du consentement est prêt à proposer à l'utilisateur plusieurs options de consentement.

Si vous n'appelez pas manuellement la fonction pour demander des annonces, assurez-vous que votre PGC configure l'utilisation de la commande getTCData et renvoie les valeurs TCData.eventStatus = 'tcloaded' OR 'cmpuishown' + 'useractioncomplete' pour indiquer que le consentement de l'utilisateur est prêt à être utilisé via l'API.

2.1b

Les deux conditions suivantes sont remplies :

  • L'option &gdpr=1 est définie pour les PGC.
  • La demande contient &gdpr_consent=, mais la chaîne de TC est vide.
Demandez à votre PGC de s'assurer que ses API sont correctement intégrées selon les spécifications techniques du TCF de l'IAB.
2.2a

Impossible d'analyser la chaîne de TC, car elle n'est pas encodée au format base64.

Exemple : “2”

Les PGC (ou les éditeurs) ne doivent envoyer que des données encodées au format base64 dans les paramètres gdpr_consent=.
2.2b

Impossible d'analyser la chaîne de TC en raison d'une erreur de décodage.

Exemple : la chaîne inclut un nombre incorrect d'octets

La PGC doit résoudre les erreurs d'implémentation de la chaîne TC.
2.2c

Impossible d'analyser la chaîne de TC en raison d'une erreur liée aux données.

Exemple : horodatage incorrect, l'ID du fournisseur est trop long
 

La PGC doit résoudre les erreurs d'implémentation de la chaîne TC.

Problèmes liées à la chaîne TC

La chaîne TC associée à une demande d'annonce pose problème. Les demandes d'annonces sont refusées et non satisfaites.

Erreur Description Action suggérée
3.1 L'ID de la PGC n'est pas valide.

Vérifiez qu'une PGC validée par l'IAB est utilisée et que son ID est correctement défini dans les chaînes de TC.

Si une PGC était valide au moment de la génération d'une chaîne de TC, mais a par la suite été supprimée par l'IAB, vous devez de nouveau obtenir le consentement des utilisateurs à l'aide d'une PGC valide.

3.2 Ce scénario n'est plus utilisé. Signification précédente : la chaîne TC a été créée il y a plus de 13 mois. La PGC doit supprimer l'ancienne chaîne TC et obtenir de nouveau le consentement de l'utilisateur.
3.3 La chaîne TC a été mise à jour il y a plus de 13 mois. La PGC doit supprimer l'ancienne chaîne TC et obtenir de nouveau le consentement de l'utilisateur.

Vous devez de nouveau obtenir le consentement

Vous devez obtenir le consentement de l'utilisateur. Si vous l'avez déjà obtenu il y a plus de 13 mois ou avant que Google ne rejoigne la LGF, vous devez l'obtenir de nouveau. Sinon, les demandes d'annonces seront refusées et non satisfaites.

Erreur Description Action suggérée
4.1 La chaîne de TC a été générée à l'aide d'une version de la LGF dans laquelle Google ne figurait pas encore. Obtenez de nouveau le consentement en utilisant la version mise à jour de la LGF, qui inclut désormais Google.

Champ d'application global et externe

Il s'agit des problèmes liés au champ d'application global et externe (Ad Manager, AdMob, AdSense). Les annonces ne seront pas diffusées si la chaîne TC indique "Externe" ou "Champ d'application global".

Erreur Description Action suggérée
5.1 La chaîne de TC autorise le consentement externe. Demandez à votre PGC de supprimer les signaux externes des chaînes de TC.
5.2 La chaîne de TC est associée à un champ d'application global. Demandez à votre PGC de mettre à jour les chaînes TC de sorte qu'elles soient spécifiques aux services.

Les annonces continuent d'être diffusées

Les annonces personnalisées et non personnalisées continueront d'être diffusées selon les paramètres existants, sans conséquence sur la monétisation.

Erreur Description Action suggérée
6.1 La version de la chaîne de TC correspond à la version 1 ou 1.1 (chaîne de la version 1.0). La PGC doit envoyer des chaînes correspondant à la version 2.0 du TCF.

Google traitera les problèmes

Lorsque de tels problèmes se produisent, Google applique lui-même un correctif si nécessaire et continue de gérer le TCF normalement.

Erreur Description Action suggérée
7.1 L'option gdprApplies n'est pas définie, ou est définie sur une valeur non valide ou indéchiffrable, mais une chaîne de TC valide est présente. N/A
7.2 La chaîne de TC a été générée avec une version de la LGF plus récente que celle actuellement utilisée par la technologie de diffusion d'annonces de Google. N/A
7.3 Certaines finalités, certaines fonctionnalités et/ou certains fournisseurs sont hors de portée (inconnus). N/A
7.4 La version tcf_policy_version associée à la chaîne de TC est plus ancienne que celle associée à la LGF. La PGC doit supprimer la chaîne de TC plus ancienne et de nouveau obtenir le consentement des utilisateurs à l'aide de la dernière version de la LGF.
7.5

Une demande comporte l'option &gdpr=1, mais pas le paramètre &gdpr_consent dans l'URL de demande.

N/A
7.6 Le code pays de l'éditeur n'est pas valide, mais le consentement pour la première finalité a été obtenu.  La PGC doit résoudre les erreurs d'implémentation de la chaîne TC.
7.7 Le code de langue n'est pas valide. Seules les annonces limitées seront diffusées. La PGC doit résoudre les erreurs d'implémentation de la chaîne TC.
7.8 Le champ correspondant à la version de la chaîne TC n'est défini ni sur 1, ni sur 2. Seules les annonces limitées seront diffusées. La PGC doit résoudre les erreurs d'implémentation de la chaîne TC.
7.9 La version de la chaîne AC ne correspond pas à la version 1. La PGC doit définir la version de la chaîne AC sur 1.

Problèmes liés à la chaîne AC

Lorsque ces types de problèmes se produisent, Google traite la chaîne de consentement supplémentaire (AC) comme non valide, et aucun fournisseur supplémentaire n'est considéré au-delà de la chaîne TC.

Erreur Description Action suggérée
8.1 La chaîne AC n'utilise pas le séparateur de version (~). La PGC doit utiliser le signe "~" comme deuxième caractère de la chaîne AC pour séparer le numéro de version de la liste des fournisseurs autorisés.
8.2 La chaîne AC contient une liste de fournisseurs qui ne respecte pas le format attendu (liste composée de valeurs de type int64 séparées par "."). La PGC doit résoudre les erreurs liées à la chaîne AC.

 

Ces informations vous-ont elles été utiles ?
Comment pouvons-nous l'améliorer ?

Vous avez encore besoin d'aide ?

Connectez-vous pour accéder à des options d'assistance supplémentaires afin de résoudre rapidement votre problème.

Recherche
Effacer la recherche
Fermer le champ de recherche
Applications Google
Menu principal
Rechercher dans le centre d'aide
true
148
false