Dernière mise à jour: 18/10/2023
Ce guide vous explique comment migrer vers la version 7 des fichiers de données structurées (SDF) à partir d'une version précédente, ainsi que les modifications requises et suggérées que vous pouvez apporter pour optimiser votre intégration.
Consultez les notes de version pour obtenir une liste exhaustive des différences entre les versions 6 et 7.
Migrer votre version de fichiers de données structurées
Pour migrer vers la version 7 des fichiers de données structurées à partir d'une version précédente, vous devez spécifier la nouvelle version, mettre à jour les espaces d'ID pour un sous-ensemble de colonnes existantes et ajouter une intégration avec 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 mettre à jour la version que vous attribuez à vos ressources de partenaire et d'annonceur parents, 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 du panneau de navigation de gauche. Mettez à jour la configuration de la version du fichier de données structurées dans la section Fichiers de données structurées sur 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 du panneau de navigation de gauche. Mettez à jour la configuration de la version du fichier SDF dans la section Fichiers de données structurées sur v7. Si la version par défaut est définie au niveau du partenaire, ce paramètre peut ne pas être modifiable.
Défini dans l'API
- Au niveau de l'annonceur
- Envoyez une requête
advertisers.patchpour mettre à jourdataAccessConfig.sdfConfig.sdfConfig.versionenSDF_VERSION_7et, si nécessaire,dataAccessConfig.sdfConfig.overridePartnerSdfConfigenTrue.
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 de fichiers de lecture des entités obsolète et les aligner davantage sur les outils compatibles, tels que l'API Display & Video 360.
Cette section liste toutes les colonnes utilisant des ID différents 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 de migration vers la version 7 pour les colonnes | |
|---|---|
|
Ciblage en fonction de l'application - Exclure Ciblage en fonction de l'application : inclure |
Ces colonnes ont été mises à jour pour utiliser des 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, comme un ID de groupe 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 pour utiliser les valeurs
Récupérez les ressources |
|
Ciblage par opérateur - Exclure Ciblage par opérateur : inclure |
Cette colonne a été mise à jour pour utiliser les valeurs
Récupérez les ressources |
|
Ciblage par chaîne - Exclure Ciblage par 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'appareils – Inclure |
Cette colonne a été mise à jour pour 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 site - Exclure Ciblage par site : inclure |
Cette colonne a été mise à jour pour identifier les sites à l'aide de chaînes d'URL. |
Élément de campagne
| Instructions de migration vers la version 7 pour les colonnes | |
|---|---|
|
Ciblage en fonction de l'application - Exclure Ciblage en fonction de l'application : inclure |
Ces colonnes ont été mises à jour pour utiliser des 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, comme un ID de groupe 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 pour utiliser de nouveaux ID de critères pour les types de lignes application et site. Le type de ligne application a été mis à jour pour utiliser des valeurs de chaîne concatenantes de la plate-forme de l'application et de l'ID de la plate-forme de l'application, séparées par un deux-points, pour les ID de critères. 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, comme un ID de groupe 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 pour utiliser des chaînes d'URL comme ID de critères. |
|
Ciblage par navigateur - Exclure Ciblage par navigateur : inclure |
Cette colonne a été mise à jour pour utiliser les valeurs
Récupérez les ressources |
|
Ciblage par opérateur - Exclure Ciblage par opérateur : inclure |
Cette colonne a été mise à jour pour utiliser les valeurs
Récupérez les ressources |
|
Ciblage par chaîne - Exclure Ciblage par 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'appareils – Inclure |
Cette colonne a été mise à jour pour utiliser les valeurs
Récupérez les ressources |
Ciblage par site - Exclure Ciblage par site : inclure |
Cette colonne a été mise à jour pour identifier les sites à l'aide de chaînes d'URL. |
Produit multimédia
| Instructions de migration vers la version 7 pour les colonnes | |
|---|---|
|
Ciblage par chaîne - Exclure Ciblage par chaîne : inclure |
Cette colonne a été mise à jour pour utiliser la valeur
Récupérez les ressources |
| Ciblage par types d'appareils – Inclure |
Cette colonne a été mise à jour pour utiliser les valeurs
Récupérez les ressources |
Ajout de l'intégration aux 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 concernés:
| Type de fichier | Colonne |
|---|---|
| Élément de campagne | Nombre de diffusions avec une fréquence cible TrueView |
| Élément de campagne | Période de la fréquence cible TrueView |
| Groupe d'annonces YouTube | Ciblage optimisé |
Si vous effectuez la migration à partir d'une version antérieure des 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 des fichiers de données structurées.
Changements supplémentaires
Dans la version 7, nous avons également apporté quelques modifications superficielles qui devraient vous aider à simplifier votre intégration et à abandonner l'utilisation des fichiers de lecture d'entités obsolètes à des fins de référence.
Nouvel ordre de la liste pour un sous-ensemble de colonnes
La version 7 de SDF garantit un ordre stable de certaines colonnes de liste lors de la génération de fichiers. Cela permet d'obtenir un comportement plus cohérent et une révision plus facile. Cet ordre n'est pas appliqué lors de l'importation du fichier, mais est appliqué ultérieurement lors de la génération du fichier mis à jour.
Consultez les notes de version 7 pour obtenir la liste complète des colonnes qui sont désormais générées dans l'ordre numérique ou alphabétique croissant.
Nouvelles recommandations de référence pour les pièces d'identité
Nous avons mis à jour les définitions d'un certain nombre de colonnes pour supprimer les références aux fichiers de lecture d'entités obsolètes et recommander d'autres moyens de recherche d'ID.
Les valeurs renvoyées par les colonnes suivantes ne sont pas différentes de celles de la version 6 de SDF, mais nous vous suggérons de mettre à jour votre intégration pour récupérer les ID à l'aide de la nouvelle méthode recommandée, que vous trouverez dans les descriptions des colonnes de la version 7.
| Types de fichiers et colonnes | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campagne |
|
|||||||||||||||||||||
| Ordre d'insertion |
|
|||||||||||||||||||||
| Élément de campagne |
|
|||||||||||||||||||||
| Produit multimédia |
|
|||||||||||||||||||||
| Groupe d'annonces YouTube |
|
|||||||||||||||||||||