Dernière mise à jour: 12/11/2024
Ce guide vous explique comment passer de la version 7.1 des fichiers de données structurées à la version 8 et décrit les modifications entre les deux versions qui peuvent avoir un impact sur votre intégration.
Consultez les notes de version pour obtenir une liste exhaustive des différences entre la version 7.1 et la version 8.
Migrer votre version de fichiers de données structurées
Pour passer à la version 8 des fichiers de données structurées (SDF) à partir d'une version précédente:
- Mettez à jour vos ressources et vos actions de génération de SDF pour utiliser la version 8.
- Modification de la logique des ressources publicitaires pour identifier un type lors de la création.
- Ajout d'une nouvelle logique pour lire, créer et mettre à jour les ressources de génération de la demande.
Mettre à jour la version des fichiers de données structurées
Pour utiliser une nouvelle version de fichiers de données structurées, mettez à jour la version attribuée dans vos ressources Partenaire et Annonceur parent, 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
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é.
- Développez le menu Paramètres de partenaire dans le panneau de navigation de gauche, puis accédez à la page Informations de base.
- Mettez à jour la configuration de la version SDF dans la section Fichiers de données structurées sur v8.
Au niveau de l'annonceur
- Accédez à l'annonceur souhaité.
- Développez le menu Paramètres de l'annonceur dans le panneau de navigation de gauche, puis accédez à la page Informations de base.
- Mettez à jour la configuration de la version SDF dans la section Fichiers de données structurées sur v8. 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 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.patchpour mettre à jourdataAccessConfig.sdfConfig.sdfConfig.versionenSDF_VERSION_8et, 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_8.
Spécifier le type dans les ressources d'annonce
La version 8 ajoute une colonne Ad Type aux fichiers Ad, qui indique le type d'annonce représenté par chaque ligne. Cette nouvelle colonne est obligatoire et sera renseignée pour les ressources existantes lors du téléchargement des fichiers d'annonces v8.
Lorsque vous mettez à jour des annonces existantes, vous ne devez pas modifier la valeur de cette colonne.
Lorsque vous créez des annonces, vous devez renseigner cette colonne avec l'une des valeurs indiquées dans la description de la colonne.
Modifier la logique des ressources de génération de la demande
La version 8 permet de créer, de récupérer et de mettre à jour des campagnes axées sur la génération de la demande à l'aide de fichiers Élément de campagne, Groupe d'annonces et Annonce. Les ressources de génération de la demande utilisent une logique différente pour la validation des codes temporels, nécessitent la création de colonnes supplémentaires et sont limitées par de nouvelles restrictions pour les trois types de fichiers.
Validation de l'horodatage
Pour tous les éléments de campagne autres que de génération de la demande, la colonne Timestamp d'un fichier Élément de campagne est renseignée lors du téléchargement avec la date et l'heure de la dernière modification d'un élément de campagne. Cette valeur est utilisée lors de la mise à jour d'un élément de campagne à l'aide d'un fichier de données structurées pour vérifier qu'il n'a pas été modifié depuis le téléchargement du fichier d'origine. Dans ce cas, la mise à jour échoue.
Pour les éléments de campagne de génération de la demande, la colonne Timestamp et la validation associée fonctionnent différemment. Pour les entrées d'éléments de campagne de génération de la demande, la colonne est renseignée avec l'heure actuelle au moment du téléchargement. Lors de l'importation, Display & Video 360 vérifie si plus de 24 heures se sont écoulées depuis l'horodatage donné. Si cela fait plus de 24 heures, l'entrée de fichier d'origine est considérée comme obsolète et la mise à jour échoue. Dans ce cas, téléchargez à nouveau le fichier et effectuez vos mises à jour en fonction de la version la plus récente. Cette nouvelle méthode de validation ne vous empêche pas d'écraser les modifications apportées au cours des dernières 24 heures. Pour éviter les écrasements accidentels, n'incluez que les éléments de campagne de génération de la demande que vous souhaitez mettre à jour dans les fichiers que vous importez.
Colonnes obligatoires
Les types de fichiers suivants comportent des colonnes qui sont désormais obligatoires pour certaines ressources de génération de la demande, en plus des colonnes requises pour toutes les entités de ce type de fichier.
Élément de campagne
Colonnes obligatoires pour les valeurs de colonne Type suivantes pour les éléments de ligne
|
||||
| Génération de la demande |
|
|||
Annonce
Colonnes obligatoires pour les valeurs de colonne Ad Type suivantes dans
Annonce
|
|||||||||
| Carrousel de génération de la demande |
|
||||||||
| Image de génération de la demande |
|
||||||||
| Produit de génération de la demande |
|
||||||||
| Vidéo de génération de la demande |
|
||||||||
Mise à jour des restrictions
En plus des nouvelles colonnes obligatoires pour certains éléments de campagne et annonces de génération de la demande, de nouvelles restrictions d'utilisation s'appliquent aux ressources de génération de la demande pour plusieurs colonnes des types de fichiers Élément de campagne, Groupe d'annonces et Annonce.
Ces restrictions sont nombreuses et spécifiques aux colonnes en question. Par conséquent, ce guide ne fournit pas de liste exhaustive des restrictions. Nous vous recommandons de lire attentivement la documentation de référence de la version 8 pour les types de fichiers Élément de campagne, Groupe d'annonces et Annonce avant de créer ou de mettre à jour des ressources de génération de la demande à l'aide de l'importation de fichiers SDF.