Depuis le 3 octobre 2025, le Google Ads API permet enfin d’utiliser simultanément les identifiants gclid et gbraid, ce qui élimine l’erreur FieldError.VALUE_MUST_BE_UNSET et améliore la précision du suivi des conversions, notamment sur iOS, où les contraintes de traçage sont fortes.
3 principaux points à retenir.
- La compatibilité simultanée gclid et gbraid élimine les erreurs précédentes.
- Cette nouveauté répond aux défis d’attribution liés aux mises à jour iOS 14+.
- Elle renforce la qualité des données pour l’optimisation des campagnes et le Smart Bidding.
Pourquoi Google Ads API autorise-t-il désormais gclid et gbraid simultanément
Google a franchi une étape importante en levant la restriction sur l’utilisation simultanée des identifiants gclid et gbraid dans l’API Google Ads. Cette évolution répond à un constat flagrant : les changements introduits par iOS 14.5, en particulier avec l’App Tracking Transparency, ont mis à mal la façon dont les conversions étaient attribuées. Avant ce changement, les annonceurs étaient confrontés à une véritable épine dans le pied avec l’erreur « FieldError.VALUE_MUST_BE_UNSET ». Cette erreur se produisait lorsque l’on essayait d’inclure les deux identifiants dans le même upload de conversion, une situation frustrante tant pour les développeurs que pour les annonceurs.
Pour comprendre le besoin de cette modification, il s’agit de dissocier le rôle de chacun des identifiants : gclid (Google Click Identifier) est utilisé pour le tracking des conversions sur le web, permettant de relier les clics aux comportements des utilisateurs sur les sites. En revanche, gbraid (Google Braid Identifier) est spécifiquement conçu pour le suivi des applications iOS, prenant en compte les nouvelles restrictions sur le suivi des utilisateurs sur cette plateforme.
L’annonce officielle de Google, faite le 22 juillet 2025, et qui sera appliquée dès le 3 octobre 2025, a pour but de fluidifier ce processus d’upload de conversions. Finies les convolutions inutiles à gérer des appels API multiples ou le recours à des détournements techniques. Cette simplification va apporter un confort indéniable aux équipes techniques chargées de gérer ces conversions. En accueillant gclid et gbraid simultanément, Google crée une synergie bienvenue qui permet une attribution plus robuste et précise des conversions, ce qui est particulièrement crucial dans le contexte post-iOS 14.5.
Les bénéfices sont multiples : non seulement la précision des conversions est améliorée, mais les développeurs et annonceurs gagnent également en agilité. La possibilité d’intégrer ces deux identifiants dans un même appel API réduit la complexité des intégrations techniques, stabilisant ainsi les processus qui ont longtemps été sursollicités par les changements fréquents. En somme, cette modification est un pas dans la bonne direction pour les professionnels du marketing digital qui doivent naviguer dans un paysage technologique en constante évolution.
Comment intégrer gclid et gbraid dans Google Ads API pour le suivi des conversions
Dans Google Ads API, le message ClickConversion est la pierre angulaire pour le suivi des conversions. Comprendre sa structure est crucial, surtout quand il s’agit de gérer les champs gclid et gbraid.
Les champs principaux du message ClickConversion incluent :
- conversion_action: L’action à laquelle est associée la conversion.
- conversion_date_time: La date et l’heure de la conversion.
- conversion_value: La valeur associée à la conversion.
- currency_code: La devise utilisée pour la valeur de conversion.
- gclid: L’identifiant de clic Google sur le web, utilisé pour le suivi des conversions des clics web.
- gbraid: L’identifiant de clic pour les applications, essentiel pour le suivi des conversions au sein des applications iOS.
Il est fondamental de noter que gclid et gbraid ne doivent pas être utilisés simultanément dans les anciennes pratiques. Cependant, avec la mise à jour actuelle, il est désormais possible de les inclure tous les deux. Cela garantit une meilleure précision dans le suivi des conversions, notamment lorsque les utilisateurs naviguent entre le web et les applications.
Voici comment vous pourriez construire un objet ClickConversion en JavaScript :
const clickConversion = {
conversion_action: 'INSERT_CONVERSION_ACTION_ID',
conversion_date_time: new Date().toISOString(),
conversion_value: 100.00,
currency_code: 'USD',
gclid: 'INSERT_GCLID',
gbraid: 'INSERT_GBRAID'
};
// Méthode pour uploader les conversions
const uploadClickConversions = async (clickConversion) => {
try {
const response = await googleAdsClient.clickConversion.uploadClickConversions({
customerId: 'INSERT_CUSTOMER_ID',
conversions: [clickConversion],
partial_failure: true,
});
console.log(response);
} catch (error) {
console.error('Erreur lors de l\'upload des conversions :', error);
}
};
uploadClickConversions(clickConversion);
La gestion des erreurs est cruciale. Grâce au paramètre partial_failure, vous pouvez traiter les conversions valides tout en récupérant des rapports d’erreurs précis via GoogleAdsFailure. Cela signifie qu’en cas d’erreurs, seulement les conversions invalides sont rejetées, vous gardez donc une flexibilité dans vos données.
Voici un tableau comparatif pour mieux illustrer la situation :
| Aspect | Ancienne logique | Nouvelle logique |
|---|---|---|
| Champs utilisés | GCLID ou GBRAID exclusif | GCLID et GBRAID simultanément |
| Gestion des erreurs | Échec total des conversions | Réception de rapports d’erreurs précis et traitement partiel |
| Robustesse | Limitée | Améliorée |
En résumé, cette évolution dans Google Ads API permet un suivi des conversions nettement plus robuste et flexible, alliant précision et efficacité dans la gestion des données.
Quels bénéfices concrets pour les annonceurs et développeurs avec cette nouveauté
La double identification gclid et gbraid dans Google Ads API représente une réponse nécessaire aux bouleversements qu’a entraînés la mise en place de l’App Tracking Transparency (ATT) sur iOS 14. Cette nouvelle politique d’Apple a déstabilisé le paradigme précédent, où le gclid seul suffisait pour tracer et attribuer les conversions. Sous l’ATT, les utilisateurs sont moins enclins à partager leurs données personnelles, rendant l’attribution plus complexe pour les annonceurs. Les identifiants gbraid et wbraid émergent ici comme des solutions pour mesurer efficacement les conversions, tant sur apps que sur le web, particulièrement sur iOS.
Alors, quels sont les bénéfices concrets de cette double compatibilité ? D’abord, on parle de meilleure précision des conversions. L’association stratégique des deux identifiants permet de récupérer des données que la première version ne pouvait pas capter, grâce à la capacité de suivre l’utilisateur à travers divers points de contact. Résultat : un suivi de conversion plus robuste.
- Meilleure donnée pour Smart Bidding : Avec des informations plus complètes, les algorithmes peuvent mieux optimiser les offres, augmentant ainsi les chances d’atteindre les bonnes audiences au bon moment.
- Simplification du tracking cross-platform : Plus besoin de jongler entre différents systèmes, gbraid et wbraid unifient le processus.
- Diminution des erreurs techniques : Moins de perte de conversions équivaut à une meilleure gestion des budgets, car chaque conversion comptée est potentiellement une opportunité de vente.
Pour étayer tout cela, des études montrent que l’attribution Google Ads a considérablement compliqué la mesure des performances sur iOS. Par exemple, un rapport de Google a noté qu’environ 80 % des annonceurs ont constaté une baisse de l’attribution des conversions depuis l’implémentation de l’ATT. Il est crucial pour les annonceurs de s’adapter à ces changements pour éviter de laisser de l’argent sur la table.
Concernant les aspects pratiques, il est impératif de procéder à des tests approfondis. L’intégration de ces nouveaux identifiants exige une mise à jour des workflows d’erreur et un monitoring post-migration rigoureux pour garantir que toutes les conversions sont correctement enregistrées. Enfin, même avec ces nouveaux outils, le respect du RGPD doit rester une priorité, surtout à l’heure où la protection des données est plus que jamais sur le devant de la scène.
Cette nouvelle flexibilité dans Google Ads API va-t-elle enfin simplifier le suivi des conversions iOS ?
En autorisant l’utilisation simultanée de gclid et gbraid dans les conversions uploadées, Google délivre un vrai soulagement technique face aux contraintes iOS 14+. Cela signifie moins d’erreurs, un suivi plus précis et donc une optimisation plus fine des campagnes. Pour les développeurs, c’est une simplification majeure du code et du traitement des erreurs. Pour les annonceurs, c’est une meilleure visibilité sur le parcours utilisateur cross-platform. Ce changement s’inscrit dans une logique d’adaptation indispensable à un environnement publicitaire de plus en plus fragmenté et réglementé, et mérite toute votre attention opérationnelle avant déploiement.
FAQ
Qu’est-ce que le gclid et pourquoi est-il important ?
Pourquoi Google a-t-il créé le gbraid pour iOS ?
Qu’est-ce que le FieldError.VALUE_MUST_BE_UNSET ?
Quels avantages offre la double saisie gclid et gbraid ?
Que doivent faire les développeurs avant le 3 octobre 2025 ?
A propos de l’auteur
Franck Scandolera est consultant expert et formateur en Web Analytics, Data Engineering et automatisation, avec plus de 10 ans d’expérience et une maîtrise approfondie du tracking client-side et server-side en environnement Google. En tant que responsable de l’agence webAnalyste et formateur de plusieurs centaines de professionnels, il accompagne les équipes marketing et techniques dans la mise en œuvre de solutions de mesure précises, conformes au RGPD et intégrant les dernières évolutions comme celles de Google Ads API.
⭐ Expert et formateur en Tracking avancé, Analytics Engineering et Automatisation IA (n8n, Make) ⭐
Ref clients : Logis Hôtel, Yelloh Village, BazarChic, Fédération Football Français, Texdecor…
Mon terrain de jeu :
Data & Analytics engineering : tracking propre RGPD, entrepôt de données (GTM server, BigQuery…), modèles (dbt/Dataform), dashboards décisionnels (Looker, SQL, Python).
Automatisation IA des taches Data, Marketing, RH, compta etc : conception de workflows intelligents robustes (n8n, Make, App Script, scraping) connectés aux API de vos outils et LLM (OpenAI, Mistral, Claude…).
Engineering IA pour créer des applications et agent IA sur mesure : intégration de LLM (OpenAI, Mistral…), RAG, assistants métier, génération de documents complexes, APIs, backends Node.js/Python.