TL;DR
- DV360 API v5 est en bêta publique : des changements incompatibles restent possibles avant la version stable.
- Customer Match n’est plus administré via certaines méthodes DV360 v5 : préparez Data Manager API.
- Les IDs de deals et packages d’enchères changent ; un cache v4 ne doit pas piloter le ciblage v5.
- Testez lecture, écriture et réexport sur un périmètre isolé avant de déplacer les flux de production.
Pourquoi une simple mise à jour d’URL ne suffit pas
La dépêche de Search Engine Land annonce la bêta publique de Display & Video 360 API v5. Elle mentionne des contrôles YouTube plus complets, le Digital Out of Home et une refonte des audiences et de l’inventaire. Pour une équipe qui automatise ses campagnes, la vraie nouveauté est opérationnelle : l’ancien contrat de données ne se transporte pas tel quel dans la nouvelle version.
La documentation de migration Google précise qu’il faut remplacer les endpoints v4 par v5 et adapter le code aux modifications incompatibles. Ne confondez pas cette API avec les Structured Data Files : la migration des fichiers SDF v11, déjà traitée sur ce blog, constitue un autre chantier. Ici, les ressources, méthodes, types et identifiants API sont en cause.
Avant toute modification, cartographiez les applications qui lisent ou écrivent dans DV360 : synchronisation d’audiences, exclusions de chaînes YouTube, récupération de deals, création de groupes d’annonces et rapprochement BI. Pour chaque appel, notez la version, le responsable, les secrets, les droits et la conséquence d’une réponse vide ou mal interprétée. Un script qui renvoie HTTP 200 peut quand même produire un ciblage différent.
À retenir
La version v5 est en bêta. Testez-la comme un changement de schéma, pas comme un renommage d’URL. Conservez une voie v4 tant que les appels critiques ne sont pas validés de bout en bout.
Customer Match et inventaire : les deux ruptures
La v5 retire les méthodes firstPartyAndPartnerAudiences.create, editCustomerMatchMembers et patch pour la gestion Customer Match. Google oriente ces flux vers la Data Manager API. Inventoriez les pipelines d’import, leurs identifiants de liste, leurs consentements et leur fréquence ; migrez séparément leur ingestion avant de couper l’ancien chemin. Une audience vide ou figée peut modifier la diffusion sans alerter immédiatement le responsable média.
Autre point : les deals d’inventaire et les packages d’enchères sont désormais séparés. Les premiers utilisent TARGETING_TYPE_INVENTORY_SOURCE_DEAL, les seconds TARGETING_TYPE_AUCTION_PACKAGE. Google précise que les identifiants précédemment mis en cache ne doivent plus être réutilisés après migration. Refaites la récupération depuis les services v5, reconstruisez les correspondances, puis vérifiez sur un inventaire témoin que les mêmes contraintes commerciales sont encore appliquées.
Les groupes Demand Gen et YouTube ne s’appuient plus sur le seul TARGETING_TYPE_AUDIENCE_GROUP pour les mêmes audiences : des options assignées distinctes existent selon liste propriétaire, audience Google, audience combinée, liste personnalisée ou lookalike. Les line items conservent leur propre logique. Un mapping universel des types risque donc d’effacer silencieusement des segments ou d’élargir la portée d’un groupe.
Erreurs à éviter
- Réinjecter les anciens IDs de deals dans les nouveaux types de ciblage.
- Traiter Customer Match comme une simple réécriture de méthode dans la même API.
- Confondre une lecture de campagne réussie avec la preuve que ses audiences ont persisté à l’identique.
Tester les ciblages, exclusions et nouveaux formats
La v5 permet de gérer entièrement les exclusions de vidéos et de chaînes YouTube au niveau annonceur ; en v4, ce contrôle était en lecture seule dans l’API. C’est utile pour standardiser la brand suitability, mais une exclusion ajoutée trop largement peut supprimer un volume significatif. Exportez d’abord la liste active, appliquez un petit lot, relisez les options réellement enregistrées, puis mesurez les effets sur la couverture.
Le support des insertion orders Digital Out of Home mérite le même soin. La liste des ordres peut désormais inclure des ressources OUT_OF_HOME : un parseur qui n’attend que les anciens types pourrait les ignorer ou les attribuer au mauvais reporting. Vérifiez les filtres et la facturation avant de brancher ces écrans dans un tableau de bord multi-canal.
Pour éviter les régressions invisibles, construisez un jeu de tests avec un annonceur isolé : exclusions YouTube, groupe avec audiences multiples, deal, package et ordre DOOH si utilisé. Comparez l’état v4, l’écriture v5 et un réexport v5 champ par champ. Documentez aussi les erreurs attendues lorsque la configuration est volontairement invalide : un bon contrôle refuse de diffuser plus large que prévu.
Plan d’action 48 h
- Listez les appels v4 actifs et classez-les par risque business.
- Repérez les trois méthodes Customer Match retirées et désignez un propriétaire Data Manager.
- Recréez les IDs d’inventaire en v5 sur un lot témoin, sans recycler le cache v4.
- Testez écriture puis relecture des audiences et exclusions ; prévoyez un retour v4.
Migrer en lots avec retour arrière
La documentation officielle annonce une bêta et des changements possibles avant la version stable. Déployez donc d’abord dans un environnement non critique, figez les mapping et comparez les objets au niveau annonceur, ad group et line item. Un feu vert doit venir d’un contrôle des champs persistés, pas d’un script terminé sans exception.
À chaque lot, conservez la version de code, la liste des ressources touchées et une procédure de retour ; surveillez les volumes d’audience et la pression de diffusion après bascule. En cas d’écart inexpliqué, stoppez les écritures et revenez au chemin validé plutôt que de multiplier les corrections manuelles. Escale Ads peut auditer vos flux DV360 et prioriser les tests qui protègent le budget.
Sources : Search Engine Land, 23 octobre 2026 ; guide officiel Google, 22 octobre 2026.