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 komponenty reklamowe oraz kierowanie odpowiednie dla wyświetlania reklam w YouTube i sieci partnerów wideo Google. Zasoby i kierowanie w przypadku YouTube i sieci partnerów wideo Google można tworzyć lub aktualizować tylko w interfejsie.
Na tej stronie opisujemy, jak za pomocą interfejsu Display & Video 360 API identyfikować zasoby YouTube i sieci partnerów oraz pobierać odpowiednie kierowanie, a także jak zbiorczo tworzyć i aktualizować zasoby YouTube i sieci partnerów za pomocą plików uporządkowanych danych (SDF) w interfejsie.
Identyfikowanie zasobów YouTube i sieci partnerów wideo Google
Zasoby YouTube i sieci partnerów wideo Google obejmują określone typy elementów zamówienia, grup reklam i reklam.
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 tworzyć ani aktualizować:
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
Ustawienia dotyczące elementów zamówienia typu YouTube i sieć partnerów wideo Google można pobrać z pola youtubeAndPartnersSettings zasobu LineItem.
Grupy reklam i reklamy w YouTube
Grupy reklam i reklamy w YouTube są zasobami podrzędnymi w stosunku do elementów zamówienia typu YouTube i sieć partnerów, które umożliwiają dalsze określanie szczegółów.
Element zamówienia typu YouTube i sieć partnerów wideo Google może zawierać wiele zasobówAdGroup, z których każdy ma własne dodatkowe kryteria kierowania i strategię ustalania stawek. Każdy zasób AdGroup może zawierać 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 jest przypisywane na poziomie reklamodawcy, elementu zamówienia i grupy reklam.
Kierowanie na YouTube i sieć partnerów wideo Google dziedziczone z zasobów nadrzędnych nie jest odzwierciedlane w ustawieniach kierowania zasobów podrzędnych, co jest standardem w przypadku zasobów innych niż YouTube i sieć 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 reklamodawcy nadrzędnego za pomocą funkcji
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ą metody
advertisers.adGroups.bulkListAssignedTargetingOptions.
Próba modyfikacji kierowania w YouTube
Podobnie jak w przypadku zasobów reklamowych YouTube i sieci partnerów wideo Google nie możesz modyfikować kierowania na YouTube i sieć partnerów wideo Google za pomocą interfejsu Display & Video 360 API. Każda próba zmodyfikowania poniższego kierowania spowoduje wyświetlenie błędu:
- Kierowanie przypisane na dowolnym poziomie tych typów kierowania:
TARGETING_TYPE_SESSION_POSITION,TARGETING_TYPE_YOUTUBE_CHANNELiTARGETING_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ż nie możesz tworzyć ani aktualizować zasobów YouTube i sieci partnerów wideo Google za pomocą interfejsu Display & Video 360 API, możesz zbiorczo tworzyć i aktualizować elementy zamówienia, grupy reklam i reklamy w YouTube i sieci partnerów wideo Google, przesyłając plik uporządkowanych danych (SDF) w interfejsie Display & Video 360.
Te zasoby są reprezentowane w plikach SDF w formatach Element zamówienia, Grupa reklam w YouTube i Reklama w YouTube.
Pliki uporządkowanych danych możesz generować i pobierać za pomocą interfejsu Display & Video 360 API. Edytuj istniejące wiersze, aby wprowadzić zmiany w istniejących zasobach, lub dodaj nowe wiersze, aby utworzyć nowe zasoby, a potem prześlij zaktualizowane pliki w interfejsie Display & Video 360.