Za pomocą interfejsu Display & Video 360 API możesz pobierać elementy zamówienia typu YouTube i sieć partnerów wideo Google, ich grupy reklam i zasoby reklamowe oraz ustawienia kierowania na potrzeby wyświetlania reklam typu YouTube i sieć partnerów wideo Google. Zasoby i ustawienia kierowania typu YouTube i sieć partnerów wideo Google można tworzyć lub aktualizować za pomocą interfejsu użytkownika.
Na tej stronie opisaliśmy, jak używać interfejsu Display & Video 360 API do identyfikowania zasobów typu YouTube i sieć partnerów wideo Google oraz pobierania odpowiednich ustawień kierowania, a także jak tworzyć i aktualizować zasoby typu YouTube i sieć partnerów wideo Google zbiorczo za pomocą plików uporządkowanych danych (SDF) w interfejsie.
Znajdowanie zasobów YouTube i partnerów
Zasoby dotyczące YouTube i sieci partnerów wideo Google obejmują określone typy elementów zamówienia, grupy reklam i reklamy.
Elementy zamówienia
Elementy zamówienia o tych wartościach LineItemType
to elementy zamówienia typu YouTube i sieć partnerów wideo Google, których nie można utworzyć ani zaktualizować:
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
Ustawienia specyficzne dla elementów zamówienia typu YouTube i sieć partnerów wideo Google można pobrać z pola youtubeAndPartnersSettings
w zasobie LineItem
.
Grupy reklam i reklamy w YouTube
Grupy reklam w YouTube i reklamy to zasoby podrzędne w elementach zamówienia typu YouTube i sieć partnerów wideo Google, które umożliwiają dalsze określanie specyfikacji.
Element zamówienia typu YouTube i sieć partnerów wideo Google może zawierać wiele zasobów AdGroup
, z których każdy ma własne dodatkowe ustawienia kierowania i strategię ustalania stawek. Pod każdym zasobem AdGroup
może się znajdować wiele zasobów AdGroupAd
tego samego formatu reklamy, z których każdy ma własne informacje o kreacji i listę dodatkowych adresów URL śledzenia.
Pobieranie kierowania
Kierowanie używane do wyświetlania reklam w YouTube i sieci partnerów wideo Google jest przypisywane na poziomie reklamodawcy, elementu zamówienia i grupy reklam.
Kierowanie na YouTube i sieci partnerów wideo Google odziedziczone z zasobów nadrzędnych nie jest uwzględniane w ustawieniach kierowania zasobów podrzędnych, co jest standardem w przypadku zasobów innych niż YouTube i sieci partnerów wideo Google.
Aby pobrać wszystkie ustawienia kierowania istotne dla wyświetlania reklamy w YouTube i sieci partnerów wideo Google, musisz:
- pobiera kierowanie przypisane do nadrzędnego reklamodawcy za pomocą
advertisers.listAssignedTargetingOptions
, - pobiera kierowanie przypisane do nadrzędnego elementu zamówienia za pomocą
advertisers.lineItems.bulkListAssignedTargetingOptions
, - i pobiera kierowanie przypisane do nadrzędnej grupy reklam za pomocą
advertisers.adGroups.bulkListAssignedTargetingOptions
.
Próba zmiany kierowania w YouTube
Podobnie jak w przypadku zasobów YouTube i sieci partnerów wideo Google, nie możesz modyfikować kierowania na YouTube i sieci partnerów wideo Google za pomocą interfejsu Display & Video 360 API. Każda próba zmiany tych ustawień kierowania spowoduje błąd:
- kierowanie przypisane na dowolnym poziomie w ramach tych typów kierowania:
TARGETING_TYPE_SESSION_POSITION
,TARGETING_TYPE_YOUTUBE_CHANNEL
iTARGETING_TYPE_YOUTUBE_VIDEO
; - kierowanie przypisane do zasobów elementów zamówienia typu YouTube i sieć partnerów wideo Google;
- kierowanie przypisane do zasobów
AdGroup
;
Tworzenie i aktualizowanie za pomocą przesyłania interfejsu SDF
Chociaż za pomocą interfejsu Display & Video 360 API nie możesz tworzyć ani aktualizować zasobów YouTube i partnerów, możesz zbiorczo tworzyć i aktualizować elementy zamówienia, grupy reklam i reklamy YouTube i partnerów za pomocą pliku uporządkowanych danych (SDF) przesłanego przez interfejs Display & Video 360.
Te zasoby są reprezentowane w pliku SDF za pomocą formatów pliku Element zamówienia, grupy reklam w YouTube i reklamy w YouTube.
Pliki uporządkowanych danych możesz generować i pobierać za pomocą interfejsu Display & Video 360 API. Zmień istniejące wiersze, aby wprowadzić zmiany w dotychczasowych zasobach, lub dodaj nowe wiersze, aby utworzyć nowe zasoby, a potem prześlij zaktualizowane pliki za pomocą interfejsu Display & Video 360.