Dernière mise à jour: 18/10/2023
Ce guide vous explique comment effectuer la migration d'une version précédente vers des fichiers de données structurées (SDF) v7, ainsi que les modifications, requises et suggérées, que vous pouvez apporter pour mieux optimiser votre intégration.
Consultez les notes de version pour obtenir la liste exhaustive des différences entre les versions v6 et v7.
Migrer la version de vos fichiers de données structurées
Pour migrer vers la version 7 des fichiers de données structurées, vous devez spécifier la nouvelle version, mettre à jour les espaces d'ID d'un sous-ensemble de colonnes existantes et ajouter une intégration à de nouvelles colonnes.
Mettre à jour la version des fichiers de données structurées
Pour passer à une nouvelle version des fichiers de données structurées, vous devez modifier la version que vous attribuez à vos ressources parentes pour les partenaires et les annonceurs, ainsi que vos tâches de téléchargement individuelles dans l'API Display & Video 360.
Mettre à jour les paramètres de la ressource parente
Une version par défaut des fichiers de données structurées est définie 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
- Accédez au partenaire souhaité. Accédez à la page Informations de base dans le menu Paramètres de partenaire dans le menu de navigation de gauche. Mettez à jour la configuration de la version SDF dans la section Fichiers de données structurées vers la v7.
- Au niveau de l'annonceur
- Accédez à l'annonceur souhaité. Accédez à la page Informations de base dans le menu Paramètres de l'annonceur dans le menu de navigation de gauche. Mettez à jour la configuration de la version SDF dans la section Fichiers de données structurées vers la v7. 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éfini dans l'API
- Au niveau de l'annonceur
- Envoyez une requête
advertisers.patchpour mettre à jourdataAccessConfig.sdfConfig.sdfConfig.versionversSDF_VERSION_7et, si nécessaire,dataAccessConfig.sdfConfig.overridePartnerSdfConfigversTrue.
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_7.
Mettre à jour les ID dans les colonnes requises
Dans la version 7, les espaces d'ID utilisés par un sous-ensemble de colonnes ont été mis à jour pour dissocier les fichiers de données structurées du produit obsolète de fichiers de lecture des entités et s'aligner davantage sur les outils compatibles, tels que l'API Display & Video 360.
Cette section répertorie chaque colonne avec des ID différents de ceux de la version 6, ainsi que des instructions pour récupérer des informations de référence sur les nouvelles valeurs.
Ordre d'insertion
| Instructions pour la migration des colonnes dans la version 7 | |
|---|---|
|
Ciblage des applications – Exclure Ciblage des applications - Inclure |
Ces colonnes ont été mises à jour pour utiliser les identifiants d'application au format " Les plates-formes d'applications sont identifiées par une valeur de chaîne. Les ID d'application sont les ID fournis par la plate-forme concernée, par exemple un ID de bundle du Play Store d'Android ou un ID d'application de l'App Store d'Apple. |
|
Ciblage par navigateur - Exclure Ciblage par navigateur - Inclure |
Cette colonne a été mise à jour afin d'utiliser les valeurs
Récupérez les ressources |
|
Ciblage par opérateur - Exclure Ciblage par opérateur - Inclure |
Cette colonne a été mise à jour afin d'utiliser les valeurs
Récupérez les ressources |
|
Ciblage de catégories - Exclure Ciblage de la chaîne - Inclure |
Cette colonne a été mise à jour pour utiliser la valeur
Récupérez les ressources |
|
Ciblage par types d'appareil - Exclure Ciblage par types d'appareil – Inclure |
Cette colonne a été mise à jour afin d'utiliser les valeurs
Récupérez les ressources |
| Mesurer le canal DAR |
Cette colonne a été mise à jour pour utiliser la valeur
Récupérez les ressources |
Ciblage par sites – Exclure Ciblage par sites - Inclure |
Cette colonne a été mise à jour pour identifier les sites via les chaînes d'URL. |
Élément de campagne
| Instructions pour la migration des colonnes dans la version 7 | |
|---|---|
|
Ciblage des applications – Exclure Ciblage des applications - Inclure |
Ces colonnes ont été mises à jour pour utiliser les identifiants d'application au format " Les plates-formes d'applications sont identifiées par une valeur de chaîne. Les ID d'application sont les ID fournis par la plate-forme concernée, par exemple un ID de bundle du Play Store d'Android ou un ID d'application de l'App Store d'Apple. |
| Multiplicateurs d'enchères |
Cette colonne a été mise à jour afin d'utiliser de nouveaux ID de critère pour les types de lignes app et site. Le type de ligne app a été mis à jour afin d'utiliser des valeurs de chaîne concaténées correspondant à l'ID de la plate-forme d'applications et à son ID, séparées par le signe deux-points. Les plates-formes d'applications sont identifiées par une valeur de chaîne. Les ID d'application sont les ID fournis par la plate-forme concernée, par exemple un ID de bundle du Play Store d'Android ou un ID d'application de l'App Store d'Apple. Le type de ligne site a été mis à jour afin d'utiliser des chaînes d'URL comme ID de critère. |
|
Ciblage par navigateur - Exclure Ciblage par navigateur - Inclure |
Cette colonne a été mise à jour afin d'utiliser les valeurs
Récupérez les ressources |
|
Ciblage par opérateur - Exclure Ciblage par opérateur - Inclure |
Cette colonne a été mise à jour afin d'utiliser les valeurs
Récupérez les ressources |
|
Ciblage de catégories - Exclure Ciblage de la chaîne - Inclure |
Cette colonne a été mise à jour pour utiliser la valeur
Récupérez les ressources |
|
Ciblage par types d'appareil - Exclure Ciblage par types d'appareil – Inclure |
Cette colonne a été mise à jour afin d'utiliser les valeurs
Récupérez les ressources |
Ciblage par sites – Exclure Ciblage par sites - Inclure |
Cette colonne a été mise à jour pour identifier les sites via les chaînes d'URL. |
Produit multimédia
| Instructions pour la migration des colonnes dans la version 7 | |
|---|---|
|
Ciblage de catégories - Exclure Ciblage de la chaîne - Inclure |
Cette colonne a été mise à jour pour utiliser la valeur
Récupérez les ressources |
| Ciblage par types d'appareil – Inclure |
Cette colonne a été mise à jour afin d'utiliser les valeurs
Récupérez les ressources |
Ajouter l'intégration avec les colonnes ajoutées depuis la version 6
Si vous passez de la version 6 à la version 7, vous devez ajouter les colonnes suivantes aux fichiers correspondants:
| File type | Colonne |
|---|---|
| Élément de campagne | Nombre de fréquences cibles TrueView |
| Élément de campagne | Période avec fréquence cible TrueView |
| Groupe d'annonces YouTube | Ciblage optimisé |
Si vous effectuez la migration à partir d'une version précédente de fichiers de données structurées, consultez les notes de version des fichiers de données structurées pour en savoir plus sur les colonnes supplémentaires ajoutées entre votre version actuelle et la version 6 de SDF.
Changements supplémentaires
Dans la version 7, nous avons également apporté des modifications superficielles qui devraient vous aider à simplifier votre intégration et à abandonner l'utilisation de fichiers de lecture des entités obsolètes pour référence.
Nouvel ordre des listes pour un sous-ensemble de colonnes
SDF v7 garantit un ordre stable de certaines colonnes de liste lors de la génération du fichier. Cela permet d'obtenir un comportement plus cohérent et un examen plus facile. Cet ordre n'est pas appliqué lors de l'importation du fichier, mais il est appliqué par la suite lors de la génération du fichier mis à jour.
Consultez les notes de version de la version 7 pour obtenir la liste complète des colonnes désormais générées par ordre numérique ou alphabétique croissant.
Recommandations de nouvelles références d'ID
Nous avons mis à jour les définitions de plusieurs colonnes pour supprimer la référence aux fichiers de lecture des entités obsolètes et recommander d'autres moyens de recherche d'ID.
Les valeurs renvoyées par les colonnes suivantes ne diffèrent pas de celles de la version 6 des fichiers SDF. Toutefois, nous vous recommandons de mettre à jour votre intégration pour récupérer les ID à l'aide de la nouvelle méthode recommandée, disponible dans les descriptions des colonnes de la version 7.
| Types de fichiers et leurs colonnes | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| Ordre d'insertion |
|
|||||||||||||||||||||
| Élément de campagne |
|
|||||||||||||||||||||
| Produit multimédia |
|
|||||||||||||||||||||
| Groupe d'annonces YouTube |
|
|||||||||||||||||||||