Migracja z wersji 2 do 3

Ostatnia aktualizacja: 31.10.2023

Migracja aplikacji

Migracja z wersji 2 do 3 wymaga zaktualizowania adresów URL punktów końcowych, aby wywoływały wersje v3 na zaktualizowanie aplikacji tak, aby uwzględnić zmiany powodujące niezgodność.

Zaktualizuj wywołania interfejsu API z wersji 2 do 3

Aby używać wersji 3 zamiast 2, musisz zaktualizować żądania tak, aby używały nowej wersji 3 i punktów końcowych.

Aby na przykład wywołać metodę advertisers.get z wersją 2, musisz wykonać użyj tego adresu URL:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

W przypadku wersji v3 zaktualizuj adres URL do postaci:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

Jeśli używasz biblioteki klienta do wysyłania żądań do interfejsu API, użyj najczęściej należy zaktualizować bibliotekę klienta i zaktualizować konfigurację, aby korzystała z wersji v3.

Wprowadzanie wymaganych zmian

W wersji 3 wprowadzamy szereg zmian powodujących niezgodność. Zapoznaj się z tymi informacjami: instrukcji i wprowadź wymagane zmiany odpowiednio do istniejącego sposobu korzystania Reklamy displayowe i Interfejs Video 360 API.

Aktualizacja połączeń pobierających zasoby YouTube i powiązanych z nimi ustawień kierowania

• Zasoby YoutubeAdGroup i YoutubeAdGroupAd zostały zastąpione przez AdGroup i AdGroupAd – materiały. Te nowe materiały zapewniają informacje prawie takie same jak w zasobach w wersji 2, ale mogą wykorzystywać zaktualizowane pole nazw ani typów wyliczeniowych. W swojej integracji zastąp używane przez Ciebie funkcje YoutubeAdGroup lub YoutubeAdGroupAd zasoby z AdGroup i AdGroupAd i zaktualizuj wywołania poniższych usług w wersji 2 do odpowiednią usługę w wersji 3:
  • Od advertisers.youtubeAdGroupAds do advertisers.adGroupAds
  • Od advertisers.youtubeAdGroups do advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions do advertisers.adGroups.targetingTypes.assignedTargetingOptions.
• Odniesienia do obiektów YoutubeAndPartnersBiddingStrategy zostały przeniesione do nowego pola youtubeAndPartnersBid w ogólnym obiekcie BiddingStrategy. Pole biddingStrategy zostało usunięte z YoutubeAndPartnersSettings. Zaktualizuj integrację do możesz pobrać strategię ustalania stawek dla elementów zamówienia lub grup reklam YouTube ze strony BiddingStrategy w polu bidStrategy w tabeli LineItem lub AdGroup zasób.
• Nazwa pola thirdPartyMeasurementSettings została zmieniona na thirdPartyMeasurementConfigs w YoutubeAndPartnersSettings oraz Nazwa obiektu YoutubeAndPartnersThirdPartyMeasurementSettings została zmieniona na ThirdPartyMeasurementConfigs Zaktualizuj integrację do pobierz za pomocą nowego pola informacje o konfiguracji zewnętrznych usług pomiaru i obiektywu.

Uwzględnij wymagane konfiguracje płatności podczas tworzenia reklamodawców

billingConfig jest teraz wymaganym polem w Advertiser zasób. Zaktualizuj urządzenie advertisers.create prosi o sprawdzenie, czy to pole jest ustawione. Domyślne informacje rozliczeniowe są pobierane dla partnera nadrzędnego za pomocą nowej funkcji Partner polu zasobu billingConfig.

Użyj nowego pola do sterowania kierowaniem zoptymalizowanym

Nowe pole wartości logicznej enableOptimizedTargeting zastąpiło pole Pole targetingExpansionLevel w TargetingExpansionConfig obiektu.

Zaktualizuj integrację zamówień reklamowych, aby używać nowego pola KPI

Nowe pole kpi zastąpiło pole performanceGoal w w zasobie InsertionOrder. To nowe pole używa Kpi zamiast obiektu PerformanceGoal i wykorzystuje nowe pola oraz wyliczenia.

Usuń odwołania do wycofanych usług i pól

W wersji 3 usunięto różne elementy, aby dostosować je do poprzedniej funkcji wycofane funkcje:

• Usługa advertisers.manualTriggers została usunięta jako aktywatory ręczne zostały wycofane.
• Pole billableOutcome zostało usunięte z InsertionOrder, ponieważ kupowanie na podstawie wyników wycofane.

Dodatkowe zmiany

Oprócz wymienionych powyżej zmian powodujących niezgodność w wersji 3 wprowadziliśmy też funkcje zabezpieczeń.

Funkcje dodane do wersji 3 po jej wprowadzeniu można znaleźć w wersji uwagi.

Zarządzanie listą lokalizacji przybliżonych

W wersji 3 możesz w pełni zarządzać listami lokalizacji przybliżonych, co pozwala na: użyj usługi advertisers.locationLists.assignedLocations, aby: utwórz i usuń lokalizacje przypisane do użytkownika TARGETING_LOCATION_TYPE_PROXIMITY LocationList materiały. Lokalizacje są rozpoznawane na podstawie identyfikatora: TARGETING_TYPE_POI TargetingOption zasobów. Mogą to być pobrane za pomocą: targetingTypes.targetingOptions.search.

Możliwość tworzenia algorytmów ustalania stawek niestandardowych na podstawie reguł

W wersji 3 możesz tworzyć i pobierać oparte na regułach algorytmy ustalania stawek niestandardowych za pomocą customBiddingAlgorithms, media, Usługi customBiddingAlgorithms.rules.

Ta funkcja jest w wersji beta i jest dostępna tylko dla partnerów z białej listy. Jeśli partnera nie ma na liście dozwolonych, żądanie zwróci błąd.