Werbebuchungen für YouTube und Partner abrufen

Mit der Display & Video 360 API können Sie „YouTube und Partner“-Werbebuchungen, ihre Anzeigengruppen und Anzeigenressourcen sowie das für die Anzeigenbereitstellung von YouTube und Partner relevante Targeting abrufen. „YouTube und Partner“-Ressourcen und das Targeting können nur über die UI erstellt oder aktualisiert werden.

Auf dieser Seite wird beschrieben, wie Sie mit der Display & Video 360 API Ressourcen für „YouTube und Partner“ identifizieren und relevantes Targeting abrufen. Außerdem erfahren Sie, wie Sie mit strukturierten Datendateien in der Benutzeroberfläche „YouTube und Partner“-Ressourcen im Bulk erstellen und aktualisieren.

YouTube und Partner-Ressourcen identifizieren

„YouTube und Partner“-Ressourcen umfassen bestimmte Arten von Werbebuchungen, Anzeigengruppen und Anzeigen.

Positionen

Werbebuchungen mit den folgenden LineItemType-Werten sind „YouTube und Partner“-Werbebuchungen und können nicht erstellt oder aktualisiert werden:

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Spezifische Einstellungen für „YouTube und Partner“-Werbebuchungen können aus dem Feld youtubeAndPartnersSettings der Ressource LineItem abgerufen werden.

YouTube-Anzeigengruppen und -Anzeigen

YouTube-Anzeigengruppen und -Anzeigen sind untergeordnete Ressourcen von „YouTube und Partner“-Werbebuchungen, die eine weitere Spezifikation ermöglichen.

Eine „YouTube und Partner“-Werbebuchung kann mehrere AdGroup-Ressourcen mit jeweils einem eigenen zusätzlichen Targeting und einer eigenen Gebotsstrategie umfassen. Unter jeder AdGroup-Ressource können sich mehrere AdGroupAd-Ressourcen desselben Anzeigenformats mit jeweils eigenen Creative-Informationen und einer Liste zusätzlicher Tracking-URLs befinden.

Targeting abrufen

Das für die Auslieferung von YouTube und Partner-Anzeigen verwendete Targeting wird auf Werbetreibenden-, Werbebuchungs- und Anzeigengruppenebene zugewiesen.

Das von übergeordneten Ressourcen übernommene Targeting für YouTube und Partner wird in den Targeting-Einstellungen der untergeordneten Ressourcen nicht berücksichtigt, wie es bei Nicht-YouTube- und Partnerressourcen üblich ist.

Um das gesamte Targeting abzurufen, das für die Auslieferung einer YouTube und Partner-Anzeige relevant ist, müssen Sie Folgendes tun:

• Targeting, das dem übergeordneten Werbetreibenden zugewiesen wurde, mit advertisers.listAssignedTargetingOptions abrufen
• das Targeting, das der übergeordneten Werbebuchung zugewiesen ist, mit advertisers.lineItems.bulkListAssignedTargetingOptions abrufen
• und mithilfe von advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions das Targeting abrufen, das der übergeordneten Anzeigengruppe zugewiesen ist.

Versuch, das YouTube-Targeting zu ändern

Wie bei den „YouTube und Partner“-Ressourcen können Sie das Targeting auf „YouTube und Partner“ nicht mit der Display & Video 360 API ändern. Beim Versuch, das folgende Targeting zu ändern, wird ein Fehler zurückgegeben:

• Targeting, das auf einer beliebigen Ebene der folgenden Targeting-Typen zugewiesen ist: TARGETING_TYPE_SESSION_POSITION, TARGETING_TYPE_YOUTUBE_CHANNEL und TARGETING_TYPE_YOUTUBE_VIDEO.
• Das Targeting ist den „YouTube und Partner“-Werbebuchungsressourcen zugewiesen.
• Targeting wurde AdGroup Ressourcen zugewiesen.

Per SDF-UI-Upload erstellen und aktualisieren

Über die Display & Video 360 API können Sie keine „YouTube und Partner“-Ressourcen erstellen oder aktualisieren. Sie haben aber die Möglichkeit, Werbebuchungen, Anzeigengruppen und Anzeigen für YouTube und Partner im Bulk zu erstellen oder zu aktualisieren. Dazu verwenden Sie den Upload einer strukturierten Datendatei (SDF) über die Display & Video 360-Benutzeroberfläche.

Diese Ressourcen werden in SDFs in den Dateiformaten Werbebuchung, YouTube-Anzeigengruppe und YouTube-Anzeige dargestellt.

Sie können Dateien mit strukturierten Daten über die Display & Video 360 API generieren und herunterladen. Bearbeiten Sie vorhandene Zeilen, um vorhandene Ressourcen zu ändern, oder fügen Sie neue Zeilen hinzu, um neue Ressourcen zu erstellen, und laden Sie die aktualisierten Dateien über die Benutzeroberfläche von Display & Video 360 hoch.