Les fichiers de données structurées (SDF) sont des fichiers CSV spécialement mis en forme. Elles permettent de récupérer, de créer et de modifier des ressources de façon groupée dans Display & Video 360. Mettez à jour des ressources de manière groupée en téléchargeant, modifiant et réimportant des fichiers SDF.
L'UI Display & Video 360 permet d'importer et d'exporter des fichiers SDF. L'API Display & Video 360 est compatible avec le téléchargement de fichiers SDF.
Formats
Un fichier SDF utilise l'un des deux formats de base, Standard et QA :
- Vous pouvez télécharger et importer des fichiers au format Standard. Les données de ces fichiers peuvent utiliser des ID numériques pour garantir leur exactitude lors de l'importation. Des informations de référence peuvent être nécessaires pour interpréter les données.
- Vous pouvez télécharger des fichiers au format QA. Ces fichiers fournissent les mêmes données que les fichiers au format standard, mais utilisent des valeurs plus lisibles par l'humain. Par exemple, certaines colonnes peuvent utiliser des noms à afficher à la place des ID. Les colonnes spécifiques à ce format utilisent le suffixe "Qa".
Types de fichiers
Le fichier SDF est compatible avec sept types de ressources. Chaque type de ressource possède son propre type de fichier avec sa propre structure de colonnes. Voici les types de ressources acceptés :
- Campagne
- Ordre d'insertion
- Élément de campagne
- Groupe d'annonces
- Annonce
- Source d'inventaire
- Produit multimédia
Seuls les types de fichiers Élément de campagne et Groupe d'annonces sont compatibles avec le format QA.
De nouvelles versions du fichier SDF sont régulièrement publiées et les versions antérieures sont abandonnées. Les nouvelles versions mettent à jour la structure de la colonne "Type de fichier". Si nécessaire, une nouvelle version du fichier SDF inclura un guide de migration au lancement.
Télécharger les erreurs
Les téléchargements SDF peuvent entraîner deux types d'erreurs : les erreurs de génération de fichiers et les ressources ignorées.
Erreurs de génération de fichiers
La génération de fichiers SDF peut se terminer par une erreur. Si la génération échoue lors de l'utilisation de l'API Display & Video 360, la tâche terminée définira son champ error avec l'objet Status. L'objet Status contiendra un message expliquant la cause de l'erreur.
Pour en savoir plus sur ces erreurs, consultez la page Guide des erreurs et avertissements.
Erreurs ignorées
Les fichiers SDF ne sont pas compatibles avec tous les sous-types de ressources. Si une ressource ne peut pas être incluse dans un fichier SDF, un fichier "Ignoré" (par exemple, SDF-LineItems-Skipped.csv) sera inclus dans le téléchargement. Ce fichier comporte une structure à deux colonnes. La première colonne identifie la ressource ignorée. La deuxième colonne explique pourquoi ils ont été exclus.
Importer des fichiers
Importez des fichiers SDF à l'aide de l'UI Display & Video 360 pour créer ou mettre à jour des ressources existantes.
Pour minimiser les erreurs lorsque vous mettez à jour ou créez des ressources avec des fichiers SDF, procédez comme suit :
- Téléchargez des fichiers SDF à l'aide de l'API Display & Video 360 ou de l'UI.
- Modifiez les entrées de fichier existantes pour mettre à jour les ressources existantes.
- Ajoutez des entrées de fichier pour créer des ressources.
- Supprimez les entrées qui ne sont pas nouvelles ni mises à jour. Cela réduit la taille du fichier et élimine le risque de mises à jour involontaires.
- Importez le fichier dans l'UI Display & Video 360.
Une fois un fichier SDF importé et traité, un fichier SDF-ResultFile.zip est disponible au téléchargement. Ce fichier ZIP peut contenir deux fichiers :
SDF-{ResourceType}-Updated-ResultFile.csv, qui liste les ressources créées ou mises à jour.SDF-{ResourceType}-Failed-ResultFile.csv, qui liste les opérations ayant échoué et les messages d'erreur correspondants.
Le fichier ZIP peut contenir un ou les deux fichiers.