Zu strukturierten Datendateien Version 7 migrieren

Letzte Aktualisierung: 18.10.2023

In dieser Anleitung wird beschrieben, wie Sie von einer früheren Version zu Structured Data Files (SDF) Version 7 migrieren. Außerdem werden die erforderlichen und empfohlenen Änderungen beschrieben, die Sie vornehmen können, um Ihre Integration zu optimieren.

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

Version der strukturierten Datendateien migrieren

Wenn Sie von einer früheren Version zu strukturierten Datendateien der Version 7 migrieren möchten, müssen Sie die neue Version angeben, die ID-Bereiche für einen Teil der vorhandenen Spalten aktualisieren und die Integration mit neuen Spalten hinzufügen.

Version der Dateien mit strukturierten Daten aktualisieren

Wenn Sie auf eine neue Version von strukturierten Datendateien umstellen möchten, müssen Sie die Version aktualisieren, die Sie den übergeordneten Partner- und Werbetreibendenressourcen und Ihren individuellen Downloadaufgaben in der Display & Video 360 API zuweisen.

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

Gehen Sie zum gewünschten Partner. Rufen Sie im Menü Partnereinstellungen links die Seite Allgemeine Angaben auf. Aktualisieren Sie die Konfiguration der SDF-Version im Abschnitt Strukturierte Datendateien auf v7.

Auf Werbetreibendenebene

Rufen Sie den gewünschten Werbetreibenden auf. Rufen Sie im Navigationsmenü auf der linken Seite die Seite Allgemeine Angaben im Menü Einstellungen für Werbetreibenden auf. Aktualisieren Sie die Konfiguration der SDF-Version im Abschnitt Structured Data Files (Strukturierte Datendateien) auf v7. Wenn die Standardversion auf Partnerebene festgelegt ist, kann diese Einstellung möglicherweise nicht bearbeitet werden.

In der API festgelegt

Auf Werbetreibendenebene

Stellen Sie eine advertisers.patch-Anfrage, um dataAccessConfig.sdfConfig.sdfConfig.version auf SDF_VERSION_7 und gegebenenfalls dataAccessConfig.sdfConfig.overridePartnerSdfConfig auf True zu aktualisieren.

sdfdownloadtasks.create-Anfragen in der API aktualisieren

Wenn Sie eine sdfdownloadtasks.create-Anfrage über die Display & Video 360 API senden, legen Sie im Anfragetext das Feld version auf SDF_VERSION_7 fest.

IDs in den erforderlichen Spalten aktualisieren

In Version 7 wurden die ID-Bereiche aktualisiert, die von einer Teilmenge der Spalten verwendet werden, um strukturierte Datendateien vom eingestellten Produkt „Lesedateien für Elemente“ zu entkoppeln und sie besser an unterstützte Tools wie die Display & Video 360 API anzupassen.

Warnung: Aktualisierte IDs sind möglicherweise nicht mit Skripts für die benutzerdefinierte Gebotseinstellung kompatibel. In der Referenzdokumentation zu Signalen in Scripts für die benutzerdefinierte Gebotseinstellung finden Sie aktuelle Informationen zu den IDs, die vor der Migration verwendet werden sollten.

In diesem Abschnitt werden alle Spalten aufgeführt, die andere IDs als Version 6 haben. Außerdem finden Sie hier eine Anleitung zum Abrufen von Referenzinformationen zu den neuen Werten.

Anzeigenauftrag

Anleitung zur Migration von Spalten zu Version 7
App-Targeting – Ausschließen App-Targeting – Einschließen	In diesen Spalten werden jetzt App-IDs im Format „App Platform:App ID“ verwendet. Beispiele: „APP:com.google.android.gm“, „APP:422689480“ und „ANDROID_TV_APP:com.google.android.youtube.tvunplugged“. App-Plattformen werden durch einen Stringwert identifiziert. App-IDs sind die IDs, die von der jeweiligen Plattform bereitgestellt werden, z. B. eine Bundle-ID aus dem Google Play Store für Android oder eine App-ID aus dem App Store von Apple.
Browser-Targeting – Ausschließen Browser-Targeting – einschließen	Diese Spalte wurde aktualisiert und verwendet jetzt die Werte targetingOptionId der Display & Video 360 API-Ressourcen TargetingOption unter Zielgruppentyp TARGETING_TYPE_BROWSER. Mit dem Dienst targetingTypes.targetingOptions können Sie TargetingOption-Ressourcen einzeln oder in paginierten Listen abrufen.
Ausrichtung nach Mobilfunkanbieter – Ausschließen Ausrichtung nach Mobilfunkanbieter – einschließen	Diese Spalte wurde aktualisiert und verwendet jetzt die Werte targetingOptionId der Display & Video 360 API-Ressourcen TargetingOption unter Zielgruppentyp TARGETING_TYPE_CARRIER_AND_ISP. Mit dem Dienst targetingTypes.targetingOptions können Sie TargetingOption-Ressourcen einzeln oder in paginierten Listen abrufen.
Kanal-Targeting – Ausschließen Kanal-Targeting – Einschließen	In dieser Spalte wird jetzt der Wert channelId der Display & Video 360 API-Ressource Channel verwendet. Mit den Diensten advertisers.channels und partners.channels können Sie Channel-Ressourcen einzeln oder in paginierten Listen abrufen.
Geräte-Targeting – Ausschließen Geräte-Targeting – Einschließen	Diese Spalte wurde aktualisiert, um die Werte targetingOptionId der Display & Video 360 API-Ressourcen TargetingOption für die folgenden Targeting-Typen zu verwenden: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Mit dem Dienst targetingTypes.targetingOptions können Sie TargetingOption-Ressourcen einzeln oder in paginierten Listen abrufen.
DAR-Kanal messen	In dieser Spalte wird jetzt der Wert channelId der Display & Video 360 API-Ressource Channel verwendet. Mit den Diensten advertisers.channels und partners.channels können Sie Channel-Ressourcen einzeln oder in paginierten Listen abrufen.
Website-Targeting – Ausschließen Website-Targeting – einschließen	Diese Spalte wurde aktualisiert, um Websites über URL-Strings zu identifizieren.

Werbebuchung

Anleitung zur Migration von Spalten zu Version 7
App-Targeting – Ausschließen App-Targeting – Einschließen	In diesen Spalten werden jetzt App-IDs im Format „App Platform:App ID“ verwendet. Beispiele: „APP:com.google.android.gm“, „APP:422689480“ und „ANDROID_TV_APP:com.google.android.youtube.tvunplugged“. App-Plattformen werden durch einen Stringwert identifiziert. App-IDs sind die IDs, die von der jeweiligen Plattform bereitgestellt werden, z. B. eine Bundle-ID aus dem Google Play Store für Android oder eine App-ID aus dem App Store von Apple.
Gebotsfaktoren	In dieser Spalte werden jetzt neue Kriterien-IDs für die Zeilentypen App und Website verwendet. Der Zeilentyp app wurde aktualisiert. Für die Kriterien-IDs werden jetzt zusammengesetzte Stringwerte der App-Plattform und der App-Plattform-ID verwendet, die durch einen Doppelpunkt getrennt sind. App-Plattformen werden durch einen Stringwert identifiziert. App-IDs sind die IDs, die von der jeweiligen Plattform bereitgestellt werden, z. B. eine Bundle-ID aus dem Play Store von Android oder eine App-ID aus dem App Store von Apple. Der Zeilentyp Website wurde aktualisiert, sodass jetzt URL-Strings als Kriterien-IDs verwendet werden.
Browser-Targeting – Ausschließen Browser-Targeting – einschließen	Diese Spalte wurde aktualisiert und verwendet jetzt die Werte targetingOptionId der Display & Video 360 API-Ressourcen TargetingOption unter Zielgruppentyp TARGETING_TYPE_BROWSER. Mit dem Dienst targetingTypes.targetingOptions können Sie TargetingOption-Ressourcen einzeln oder in paginierten Listen abrufen.
Ausrichtung nach Mobilfunkanbieter – Ausschließen Ausrichtung nach Mobilfunkanbieter – einschließen	Diese Spalte wurde aktualisiert und verwendet jetzt die Werte targetingOptionId der Display & Video 360 API-Ressourcen TargetingOption unter Zielgruppentyp TARGETING_TYPE_CARRIER_AND_ISP. Mit dem Dienst targetingTypes.targetingOptions können Sie TargetingOption-Ressourcen einzeln oder in paginierten Listen abrufen.
Kanal-Targeting – Ausschließen Kanal-Targeting – Einschließen	In dieser Spalte wird jetzt der Wert channelId der Display & Video 360 API-Ressource Channel verwendet. Mit den Diensten advertisers.channels und partners.channels können Sie Channel-Ressourcen einzeln oder in paginierten Listen abrufen.
Geräte-Targeting – Ausschließen Geräte-Targeting – Einschließen	Diese Spalte wurde aktualisiert, um die Werte targetingOptionId der Display & Video 360 API-Ressourcen TargetingOption für die folgenden Targeting-Typen zu verwenden: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Mit dem Dienst targetingTypes.targetingOptions können Sie TargetingOption-Ressourcen einzeln oder in paginierten Listen abrufen.
Website-Targeting – Ausschließen Website-Targeting – einschließen	Diese Spalte wurde aktualisiert, um Websites über URL-Strings zu identifizieren.

Mediaprodukt

Anleitung zur Migration von Spalten zu Version 7
Kanal-Targeting – Ausschließen Kanal-Targeting – Einschließen	In dieser Spalte wird jetzt der Wert channelId der Display & Video 360 API-Ressource Channel verwendet. Mit den Diensten advertisers.channels und partners.channels können Sie Channel-Ressourcen einzeln oder in paginierten Listen abrufen.
Geräte-Targeting – Einschließen	Diese Spalte wurde aktualisiert, um die Werte targetingOptionId der Display & Video 360 API-Ressourcen TargetingOption für die folgenden Targeting-Typen zu verwenden: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Mit dem Dienst targetingTypes.targetingOptions können Sie TargetingOption-Ressourcen einzeln oder in paginierten Listen abrufen.

Integration mit Spalten hinzufügen, die seit Version 6 hinzugefügt wurden

Wenn Sie von Version 6 zu Version 7 migrieren, müssen Sie den entsprechenden Dateien die folgenden Spalten hinzufügen:

Dateityp	Spalte
Werbebuchung	Anzahl der TrueView-Impressionen mit angestrebter Häufigkeit
Werbebuchung	Zeitfenster für die angestrebte Häufigkeit bei TrueView-Kampagnen
YouTube-Anzeigengruppe	Optimierte Ausrichtung

Wenn Sie von einer früheren Version von strukturierten Datendateien migrieren, finden Sie in den Versionshinweisen für strukturierte Datendateien Informationen zu zusätzlichen Spalten, die zwischen Ihrer aktuellen Version und SDF 6 hinzugefügt wurden.

Weitere Änderungen

In Version 7 haben wir auch einige oberflächliche Änderungen vorgenommen, die Ihnen helfen sollen, Ihre Integration zu vereinfachen und die Verwendung veralteter Entitätslesedateien als Referenz einzustellen.

Neue Listenreihenfolge für eine Teilmenge von Spalten

SDF v7 garantiert eine stabile Sortierung bestimmter Listenspalten bei der Dateigenerierung. Das führt zu einem einheitlicheren Verhalten und einer einfacheren Überprüfung. Diese Reihenfolge wird beim Hochladen der Datei nicht erzwungen, sondern beim Generieren der aktualisierten Datei angewendet.

In den Versionshinweisen für Version 7 finden Sie eine vollständige Liste der Spalten, die jetzt in aufsteigender numerischer oder alphabetischer Reihenfolge generiert werden.

Neue Empfehlungen für ID-Referenzen

Wir haben die Definitionen einiger Spalten aktualisiert, um Verweise auf verworfene Entitätslesedateien zu entfernen. Stattdessen empfehlen wir andere Möglichkeiten zur ID-Suche.

Die Werte, die von den folgenden Spalten zurückgegeben werden, unterscheiden sich nicht von denen in SDF-Version 6. Wir empfehlen jedoch, Ihre Integration so zu aktualisieren, dass die IDs mit der neuen empfohlenen Methode abgerufen werden. Eine entsprechende Beschreibung finden Sie in den Spaltenbeschreibungen der Version 7.

Dateitypen und ihre Spalten
Kampagne	Geografisches Targeting – Ausschließen Geografisches Targeting – Einschließen Inventarquellen-Targeting – Ausschließen Inventarquellen-Targeting – Einschließen Targeting auf Sprachen – Ausschließen Ausrichtung auf Sprachen – Einschließen
Anzeigenauftrag	Targeting auf Zielgruppen mit gemeinsamen Interessen und Kaufbereitschaft – Ausschließen Targeting auf Zielgruppen mit gemeinsamen Interessen und kaufbereite Zielgruppen – einschließen App-Sammlungs-Targeting – Ausschließen App-Sammlungs-Targeting – Einschließen Zielgruppen-Targeting – Ausschließen Zielgruppen-Targeting – Einschließen Targeting auf Kategorien – Ausschließen Kategorie-Targeting – einschließen Targeting nach Inhaltsgenre – Ausschließen Targeting auf Inhaltsgenre – einschließen Targeting auf benutzerdefinierte Listen Geografisches Targeting – Ausschließen Geografisches Targeting – Einschließen Inventarquellen-Targeting – Ausschließen Inventarquellen-Targeting – Einschließen Keyword-Listen-Targeting – Ausschließen Targeting auf Sprachen – Ausschließen Ausrichtung auf Sprachen – Einschließen
Werbebuchung	Targeting auf Zielgruppen mit gemeinsamen Interessen und Kaufbereitschaft – Ausschließen Targeting auf Zielgruppen mit gemeinsamen Interessen und kaufbereite Zielgruppen – einschließen App-Sammlungs-Targeting – Ausschließen App-Sammlungs-Targeting – Einschließen Zielgruppen-Targeting – Ausschließen Zielgruppen-Targeting – Einschließen Targeting auf Kategorien – Ausschließen Kategorie-Targeting – einschließen Targeting auf kombinierte Zielgruppen Targeting nach Inhaltsgenre – Ausschließen Targeting auf Inhaltsgenre – einschließen IDs der Floodlight-Aktivitäten für Conversions Creative-Zuweisungen Targeting auf benutzerdefinierte Listen Geografisches Targeting – Ausschließen Geografisches Targeting – Einschließen Inventarquellen-Targeting – Ausschließen Inventarquellen-Targeting – Einschließen Keyword-Listen-Targeting – Ausschließen Targeting auf Sprachen – Ausschließen Ausrichtung auf Sprachen – Einschließen
Medienprodukt	Zielgruppen-Targeting – Ausschließen Zielgruppen-Targeting – Einschließen Targeting auf Kategorien – Ausschließen Kategorie-Targeting – einschließen Geografisches Targeting – Einschließen Targeting auf Sprachen – Ausschließen Ausrichtung auf Sprachen – Einschließen
YouTube-Anzeigengruppe	Targeting auf Zielgruppen mit gemeinsamen Interessen und Kaufbereitschaft – Ausschließen Targeting auf Zielgruppen mit gemeinsamen Interessen und kaufbereite Zielgruppen – einschließen Zielgruppen-Targeting – Ausschließen Zielgruppen-Targeting – Einschließen Targeting auf Kategorien – Ausschließen Kategorie-Targeting – einschließen Targeting auf benutzerdefinierte Listen