Migrer vers la version 9 des fichiers de données structurées

Dernière mise à jour : 21-08-2025

Ce guide vous explique les processus suivants :

  • Mettez à jour la version des fichiers de données structurées sélectionnés vers la version 9 à l'aide de l'UI ou de l'API Display & Video 360.
  • Migrez votre intégration des versions obsolètes des fichiers de données structurées (v7, v7.1, v8 ou v8.1) vers la version 9. Il vous redirige vers des pages détaillant les modifications entre votre version actuelle et la version 9 qui peuvent avoir un impact sur votre intégration. Dans certains cas, vous devrez utiliser la version 9 pour importer des FDS à partir du 8 septembre 2025.

Consultez les pages de migration spécifiques à chaque version pour obtenir une liste exhaustive des différences entre votre version et la version 9.

Mettre à jour la version de vos fichiers de données structurées

Pour utiliser la version 9, vous devez mettre à jour vos ressources et vos actions de génération de fichiers de données structurées afin d'utiliser la version 9 lorsque vous téléchargez et importez des fichiers de données structurées.

Mettre à jour la version des fichiers de données structurées

Pour utiliser une nouvelle version des fichiers de données structurées, mettez à jour la version attribuée dans vos ressources parentes de partenaire et d'annonceur, puis utilisez la nouvelle version lorsque vous créez des tâches de téléchargement individuelles dans l'API Display & Video 360.

Mettre à jour les paramètres de la ressource parente

Vous définissez la version par défaut des fichiers de données structurées au niveau des ressources du partenaire et de l'annonceur. Cette version est utilisée par défaut lors du téléchargement de fichiers de données structurées via l'interface ou l'API.

Défini dans l'interface

Au niveau du partenaire :

  1. Accédez au partenaire concerné.
  2. Accédez à la page Informations de base du menu Paramètres de partenaire dans le panneau de navigation de gauche.
  3. Mettez à jour la configuration de la version SDF dans la section "Fichiers de données structurées" sur v9.

Au niveau de l'annonceur :

  1. Accédez à l'annonceur concerné.
  2. Accédez à la page Informations de base du menu Paramètres de l'annonceur dans le panneau de navigation de gauche.
  3. Mettez à jour la configuration de la version SDF dans la section Fichiers de données structurées sur v9. Si la version par défaut est définie au niveau du partenaire, il est possible que ce paramètre ne soit pas modifiable.

Définir dans l'API

Au niveau du partenaire : vous ne pouvez pas définir la version SDF par défaut au niveau du partenaire dans l'API.

Au niveau de l'annonceur : envoyez une requête advertisers.patch pour mettre à jour dataAccessConfig.sdfConfig.sdfConfig.version sur SDF_VERSION_9 et, si nécessaire, dataAccessConfig.sdfConfig.overridePartnerSdfConfig sur "True".

Mettre à jour les requêtes sdfdownloadtasks.create dans l'API

Lorsque vous effectuez une requête sdfdownloadtasks.create à l'aide de l'API Display & Video 360, définissez le champ version du corps de la requête sur SDF_VERSION_9.

Migrer depuis votre version actuelle du SGF

Les pages suivantes vous guident à travers les mises à jour nécessaires à votre intégration lorsque vous migrez de votre version actuelle vers la version 9. Elles fournissent également une liste complète de toutes les modifications entre les versions :