Zu Dateien mit strukturierten Daten der Version 8 migrieren

Zuletzt aktualisiert: 12.11.2024

In diesem Leitfaden wird beschrieben, wie Sie von der Verwendung von Dateien mit strukturierten Daten der Version 7.1 zur Version 8 migrieren. Außerdem werden die Änderungen zwischen den beiden Versionen erläutert, die sich auf Ihre Integration auswirken können.

Eine vollständige Liste der Unterschiede zwischen Version 7.1 und Version 8 finden Sie in den Versionshinweisen.

Version der strukturierten Datendateien migrieren

So migrieren Sie von einer früheren Version zu strukturierten Datendateien (SDFs) der Version 8:

  1. Aktualisieren Sie Ihre Ressourcen und Aktionen zur SDF-Generierung, um Version 8 zu verwenden.
  2. Die Logik für Anzeigenressourcen wurde aktualisiert, um beim Erstellen einen Typ anzugeben.
  3. Fügen Sie neue Logik zum Lesen, Erstellen und Aktualisieren von Demand Gen-Ressourcen hinzu.

Version der Dateien mit strukturierten Daten aktualisieren

Wenn Sie eine neue Version der strukturierten Datendateien verwenden möchten, aktualisieren Sie die zugewiesene Version in den übergeordneten Partner- und Werbetreibendenressourcen und verwenden Sie die neue Version beim Erstellen einzelner Downloadaufgaben in der Display & Video 360 API.

Einstellungen der übergeordneten Ressource aktualisieren

Auf Partner- und Werbetreibendenressourcenebene wird eine Standardversion der Dateien mit strukturierten Daten festgelegt. Diese Version wird standardmäßig verwendet, wenn strukturierte Datendateien über die Benutzeroberfläche oder API heruntergeladen werden.

In der Benutzeroberfläche festgelegt

Auf Partnerebene

  1. Rufen Sie den gewünschten Partner auf.
  2. Maximieren Sie das Menü Partnereinstellungen im linken Navigationsbereich und rufen Sie die Seite Allgemeine Angaben auf.
  3. Aktualisieren Sie die Konfiguration der SDF-Version im Abschnitt Strukturierte Datendateien auf v8.

Auf Werbetreibendenebene

  1. Rufen Sie den gewünschten Werbetreibenden auf.
  2. Maximieren Sie das Menü Einstellungen für Werbetreibenden im linken Navigationsbereich und rufen Sie die Seite Allgemeine Angaben auf.
  3. Aktualisieren Sie die Konfiguration der SDF-Version im Abschnitt Strukturierte Datendateien auf v8. Wenn die Standardversion auf Partnerebene festgelegt ist, kann diese Einstellung möglicherweise nicht bearbeitet werden.
In der API festgelegt
Auf Partnerebene
Die Standard-SDF-Version kann nicht in der API auf Partnerebene festgelegt werden.
Auf Werbetreibendenebene
Stellen Sie eine advertisers.patch-Anfrage, um dataAccessConfig.sdfConfig.sdfConfig.version auf SDF_VERSION_8 und gegebenenfalls dataAccessConfig.sdfConfig.overridePartnerSdfConfig auf True zu aktualisieren.

sdfdownloadtasks.create-Anfragen in der API aktualisieren

Wenn Sie eine sdfdownloadtasks.create-Anfrage mit der Display & Video 360 API senden, legen Sie im Anfragetext das Feld version auf SDF_VERSION_8 fest.

Typ in „Anzeigenressourcen“ angeben

In Version 8 wird Anzeigen-Dateien die Spalte Ad Type hinzugefügt, in der der Anzeigentyp der einzelnen Zeilen angezeigt wird. Diese neue Spalte ist erforderlich und wird für vorhandene Ressourcen beim Herunterladen von Anzeigendateien der Version 8 ausgefüllt.

Beim Aktualisieren vorhandener Anzeigen sollte der Wert dieser Spalte nicht geändert werden.

Wenn Sie neue Anzeigen erstellen, müssen Sie in dieser Spalte einen der in der Spaltenbeschreibung aufgeführten Werte eingeben.

Logik für Demand Gen-Ressourcen aktualisieren

Version 8 unterstützt das Erstellen, Abrufen und Aktualisieren von Demand Gen-Kampagnen mithilfe von Werbebuchungs-, Anzeigengruppen- und Anzeigendateien. Bei Demand Gen-Ressourcen wird eine andere Logik für die Überprüfung des Zeitstempels verwendet, es müssen zusätzliche Spalten ausgefüllt werden und sie sind durch neue Einschränkungen für die drei Dateitypen begrenzt.

Überprüfung des Zeitstempels

Bei allen Werbebuchungen, die nicht dem Typ „Demand Gen“ zugewiesen sind, wird beim Herunterladen in der Spalte Timestamp einer Werbebuchungsdatei das Datum der letzten Änderung der Werbebuchung eingetragen. Dieser Wert wird beim Aktualisieren einer Werbebuchung mithilfe einer SDF verwendet, um zu prüfen, ob die Werbebuchung seit dem Herunterladen der ursprünglichen Datei nicht aktualisiert wurde. Andernfalls schlägt das Update fehl.

Bei Demand Gen-Werbebuchungen funktionieren die Spalte Timestamp und die zugehörige Überprüfung anders. Bei Einträgen für Demand Gen-Werbebuchungen wird die Spalte beim Download mit der aktuellen Uhrzeit ausgefüllt. Beim Upload wird in Display & Video 360 geprüft, ob seit dem angegebenen Zeitstempel mehr als 24 Stunden vergangen sind. Wenn mehr als 24 Stunden vergangen sind, wird der ursprüngliche Dateieintrag als veraltet betrachtet und die Aktualisierung schlägt fehl. Laden Sie in diesem Fall die Datei noch einmal herunter und führen Sie die Aktualisierungen anhand der neueren Version durch. Mit dieser neuen Bestätigungsmethode können Sie Änderungen, die in den letzten 24 Stunden vorgenommen wurden, nicht überschreiben. Um versehentliche Überschreibungen zu vermeiden, sollten Sie in den hochgeladenen Dateien nur Demand Gen-Werbebuchungen angeben, die Sie aktualisieren möchten.

Erforderliche Spalten

Die folgenden Dateitypen enthalten neben den Spalten, die für alle Entitäten dieses Dateityps erforderlich sind, jetzt auch Spalten, die für bestimmte Demand Gen-Ressourcen erforderlich sind.

Werbebuchung
Erforderliche Spalten für die folgenden Werte der Spalte Werbebuchung Type
Demand Gen
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
Erforderliche Spalten für die folgenden Werte der Spalte Anzeigen Ad Type
Demand Gen-Karussell
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Demand Gen-Bildanzeige
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
Demand Gen-Produkt
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Demand Gen-Videoanzeige
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

Aktualisierte Einschränkungen

Zusätzlich zu den neuen erforderlichen Spalten für bestimmte Demand Gen-Werbebuchungen und ‑Anzeigen gelten für mehrere Spalten in den Dateitypen Werbebuchung, Anzeigengruppe und Anzeige neue Nutzungsbeschränkungen, die auf Demand Gen-Ressourcen angewendet werden.

Diese Einschränkungen sind zahlreich und spezifisch für die betreffenden Spalten. Daher enthält dieser Leitfaden keine vollständige Liste der Einschränkungen. Wir empfehlen Ihnen, sich die Referenzdokumentation für die Dateitypen Werbebuchung, Anzeigengruppe und Anzeige für Version 8 genau durchzulesen, bevor Sie Demand Gen-Ressourcen mithilfe des SDF-Uploads erstellen oder aktualisieren.