Dateien mit strukturierten Daten (Structured Data Files, SDFs) sind speziell formatierte CSV-Dateien. Sie ermöglichen das Abrufen, Erstellen und Bearbeiten von Ressourcen im Bulk in Display & Video 360. Sie können Ressourcen im Bulk aktualisieren, indem Sie SDFs herunterladen, bearbeiten und dann wieder hochladen.
Die Display & Video 360-Benutzeroberfläche unterstützt das Herunter- und Hochladen von SDFs. Die Display & Video 360 API unterstützt SDF-Downloads.
Formate
Für ein SDF wird eines von zwei Basisformaten verwendet: Standard und QA.
- Sie können Dateien im Standardformat herunterladen und hochladen. Die Daten in diesen Dateien verwenden möglicherweise numerische IDs, um die Genauigkeit beim Hochladen zu gewährleisten. Möglicherweise sind Referenzinformationen erforderlich, um die Daten zu interpretieren.
- Sie können Dateien im QA-Format herunterladen. Diese Dateien enthalten dieselben Daten wie Dateien im Standardformat, verwenden aber besser lesbare Werte. In einigen Spalten werden beispielsweise Anzeigenamen anstelle von IDs verwendet. Spalten, die für dieses Format spezifisch sind, haben das Suffix „Qa“.
Dateitypen
Das SDF unterstützt sieben Ressourcentypen. Jeder Ressourcentyp hat einen eigenen Dateityp mit einer eigenen Spaltenstruktur. Folgende Ressourcentypen werden unterstützt:
- Kampagne
- Anzeigenauftrag
- Werbebuchung
- Anzeigengruppe
- Anzeige
- Inventarquelle
- Mediaprodukt
Nur die Dateitypen Werbebuchung und Anzeigengruppe unterstützen das QA-Format.
Neue SDF-Versionen werden regelmäßig veröffentlicht und frühere Versionen werden eingestellt. Bei neuen Versionen wird die Spaltenstruktur des Dateityps aktualisiert. Falls erforderlich, enthält eine neue SDF-Version bei der Einführung einen Migrationsleitfaden.
Fehler herunterladen
Beim Herunterladen von SDF-Dateien können zwei Arten von Fehlern auftreten: Fehler bei der Dateigenerierung und Übersprungene Ressourcen.
Fehler beim Generieren von Dateien
Die Generierung von SDF-Dateien kann mit einem Fehler beendet werden. Wenn die Generierung bei Verwendung der Display & Video 360 API fehlschlägt, wird für die abgeschlossene Aufgabe das Feld error mit dem Objekt Status festgelegt. Das Status-Objekt enthält eine Meldung, in der die Ursache des Fehlers beschrieben wird.
Weitere Informationen zu diesen Fehlern
Übersprungene Fehler
SDFs unterstützen nicht alle Ressourcenuntertypen. Wenn eine Ressource nicht in ein SDF aufgenommen werden kann, wird eine Datei vom Typ „Skipped“ (z. B. SDF-LineItems-Skipped.csv) in den Download aufgenommen. Diese Datei hat eine zweispaltige Struktur. In der ersten Spalte wird die übersprungene Ressource angegeben. In der zweiten Spalte wird die jeweilige Ausschlussursache erläutert.
Datei hochladen
SDFs über die Display & Video 360-Benutzeroberfläche hochladen, um neue Ressourcen zu erstellen oder vorhandene zu aktualisieren
So minimieren Sie Fehler beim Aktualisieren oder Erstellen von Ressourcen mit SDFs:
- Sie können SDFs über die Display & Video 360 API oder die Benutzeroberfläche herunterladen.
- Ändern Sie vorhandene Dateieinträge, um vorhandene Ressourcen zu aktualisieren.
- Fügen Sie Dateieinträge hinzu, um neue Ressourcen zu erstellen.
- Entfernen Sie alle Einträge, die nicht neu oder aktualisiert sind. Dadurch wird die Dateigröße reduziert und das Risiko unbeabsichtigter Updates wird verringert.
- Laden Sie die Datei in der Display & Video 360-Benutzeroberfläche hoch.
Nachdem eine SDF-Datei hochgeladen und verarbeitet wurde, steht eine SDF-ResultFile.zip-Datei zum Download zur Verfügung. Diese ZIP-Datei kann zwei mögliche Dateien enthalten:
SDF-{ResourceType}-Updated-ResultFile.csv, in der die erfolgreich aktualisierten oder erstellten Ressourcen aufgeführt sind.SDF-{ResourceType}-Failed-ResultFile.csvmit einer Liste der fehlgeschlagenen Vorgänge und entsprechenden Fehlermeldungen.
Die Datei ZIP kann eine oder beide Dateien enthalten.