Mit der Display & Video 360 API können Sie „YouTube und Partner“-Werbebuchungen, die zugehörigen Anzeigengruppen und Anzeigenressourcen sowie das Targeting abrufen, das für die Anzeigenauslieferung bei „YouTube und Partner“ relevant ist. Ressourcen und Targeting für YouTube und Partner können nur über die Benutzeroberfläche erstellt oder aktualisiert werden.
Auf dieser Seite wird beschrieben, wie Sie mit der Display & Video 360 API YouTube & Partner-Ressourcen identifizieren und relevantes Targeting abrufen und wie Sie YouTube & Partner-Ressourcen in der Benutzeroberfläche mithilfe von strukturierten Datendateien (Structured Data Files, SDF) im Bulk erstellen und aktualisieren.
„YouTube und Partner“-Ressourcen identifizieren
„YouTube und Partner“-Ressourcen bestehen aus bestimmten Arten von Werbebuchungen, Anzeigengruppen und Anzeigen.
Werbebuchungen
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_ACTIONLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIOLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACHLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCYLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
Einstellungen, die speziell für „YouTube und Partner“-Werbebuchungen gelten, können über das Feld youtubeAndPartnersSettings der Ressource LineItem abgerufen werden.
YouTube-Anzeigengruppen und ‑Anzeigen
YouTube-Anzeigengruppen und ‑Anzeigen sind untergeordnete Ressourcen von „YouTube und Partner“-Werbebuchungen, mit denen sich die Ausrichtung weiter eingrenzen lässt.
Eine „YouTube und Partner“-Werbebuchung kann mehrere AdGroup-Ressourcen mit jeweils eigenem zusätzlichen Targeting und eigener Gebotsstrategie enthalten. Unter jeder AdGroup-Ressource können sich mehrere AdGroupAd-Ressourcen desselben Anzeigenformats befinden, die jeweils eigene Creative-Informationen und eine Liste mit zusätzlichen Tracking-URLs haben.
Targeting abrufen
Das Targeting für die Auslieferung von YouTube- und Partneranzeigen wird auf Werbetreibenden-, Werbebuchungs- und Anzeigengruppenebene zugewiesen.
Targeting-Einstellungen für YouTube und Partner, die von übergeordneten Ressourcen übernommen wurden, werden nicht in den Targeting-Einstellungen untergeordneter Ressourcen angezeigt. Das ist standardmäßig bei Ressourcen, die nicht für YouTube und Partner gelten.
Wenn Sie das gesamte Targeting abrufen möchten, das für die Auslieferung einer Anzeige auf YouTube und Partnern relevant ist, müssen Sie Folgendes tun:
- die Ausrichtung des übergeordneten Werbetreibenden mit
advertisers.listAssignedTargetingOptionsabrufen, - Targeting abrufen, das der übergeordneten Werbebuchung zugewiesen ist, indem Sie
advertisers.lineItems.bulkListAssignedTargetingOptionsverwenden. - und die Ausrichtung abrufen, die der übergeordneten Anzeigengruppe zugewiesen ist, indem Sie
advertisers.adGroups.bulkListAssignedTargetingOptionsverwenden.
YouTube-Targeting ändern
Wie bei Ressourcen für „YouTube und Partner“ können Sie die Ausrichtung für „YouTube und Partner“ nicht über die Display & Video 360 API ändern. Bei jedem Versuch, die folgenden Ausrichtungen zu ändern, wird ein Fehler zurückgegeben:
- Targeting, das auf einer beliebigen Ebene der folgenden Targeting-Typen zugewiesen wird:
TARGETING_TYPE_SESSION_POSITION,TARGETING_TYPE_YOUTUBE_CHANNELundTARGETING_TYPE_YOUTUBE_VIDEO. - Targeting, das Ressourcen für „YouTube und Partner“-Werbebuchungen zugewiesen ist.
- Targeting, das
AdGroup-Ressourcen zugewiesen ist.
Über die SDF-Benutzeroberfläche hochladen und erstellen und aktualisieren
Obwohl Sie mit der Display & Video 360 API keine YouTube- und Partnerressourcen erstellen oder aktualisieren können, lassen sich YouTube- und Partnerwerbebuchungen, ‑Anzeigengruppen und ‑Anzeigen mithilfe des SDF-Uploads (Structured Data File) über die Display & Video 360-Benutzeroberfläche in großen Mengen erstellen oder aktualisieren.
Diese Ressourcen werden in SDF durch die Dateiformate Werbebuchung, YouTube-Anzeigengruppe und YouTube-Anzeige dargestellt.
Sie können strukturierte Datendateien mit der Display & Video 360 API generieren und herunterladen. Bearbeiten Sie vorhandene Zeilen, um Änderungen an vorhandenen Ressourcen vorzunehmen, oder fügen Sie neue Zeilen hinzu, um neue Ressourcen zu erstellen. Laden Sie die aktualisierten Dateien über die Display & Video 360-Benutzeroberfläche hoch.