Wersje interfejsu Display & Video 360 API są regularnie publikowane, wycofywane i zastępowane nowszymi. Te kroki są zdefiniowane w ten sposób:
Wersja: wersja opuszcza stan alfa lub beta i jest uznawana za stabilną. W tej wersji mogą być nadal udostępniane nowe funkcje.
Wycofanie: wycofujemy wersję i ogłaszamy datę zakończenia jej obsługi. Użytkownicy muszą przejść na nowszą wersję przed datą wycofania. W tej wersji nie będą już udostępniane nowe funkcje.
Wycofanie: ta wersja nie jest już obsługiwana. Żądania wysłane do wersji zwracają błąd.
Tabela poniżej zawiera listę wszystkich dotychczasowych wersji podstawowego interfejsu Display & Video 360 API, ich dat wydania oraz dat ich wycofania i zakończenia obsługi (jeśli zostały ogłoszone).
Tabela poniżej zawiera listę wszystkich zapowiedzianych wycofań funkcji, z datą początkowej skuteczności, opisem wycofania oraz zalecanymi działaniami i linkami do odpowiedniej dokumentacji:
Funkcja
Data początkowego wejścia w życie
Opis
Rozszerzanie zasięgu kierowania
25 marca 2023 r.
Zastąpienie funkcji rozszerzania zasięgu kierowania funkcją kierowania zoptymalizowanego, która będzie wdrażana stopniowo od 25 marca 2023 r. do początku maja 2023 r. W poście na blogu ogłoszono istotne zmiany w zachowaniu interfejsu Display & Video 360 API i plików uporządkowanych danych oraz zalecane działania.
Aktywatory ręczne
17 maja 2023 r.
Oś czasu:
17 maja 2023 r.: elementy zamówienia korzystające z ręcznych uruchamiaczy przestaną się wyświetlać w Display & Video 360. Jeśli po tej dacie uaktywnisz regułę ręczną powiązaną z aktywnym elementem zamówienia, element zamówienia nie będzie wyświetlać reklam.
1 sierpnia 2023 r.: wycofanie usługi advertisers.manualTriggers w interfejsie DV360 API w wersji 1 i 2, wartości wyliczenia LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER w interfejsie DV360 API w wersji 1 oraz pola LineItemFlight.triggerId w interfejsie DV360 API w wersji 1. Po tym terminie żądania wysyłane do tych usług lub pól będą zwracać błąd.
Zalecane działania:
Natychmiast przestań używać reguł ręcznych do uruchamiania i zatrzymywania wyświetlania elementów zamówienia.
Zainstalowane aplikacje i nowe urządzenia mobilne GoogleAudience
20 maja 2023 r.
Oś czasu:
20 maja 2023 r.: nie będzie już można przypisywać do elementu zamówienia lub kierowania na zamówienie reklamowe zasobów GoogleAudience z GoogleAudienceTypeGOOGLE_AUDIENCE_TYPE_INSTALLED_APPS lub GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES. Prośby o przypisanie tych list odbiorców do kierowania na odbiorców elementu zamówienia zwrócą błąd. Obejmuje to żądania advertisers.lineItems.duplicate i advertisers.lineItems.generateDefault, jeśli utworzony element zamówienia będzie zawierać w kierowaniu na odbiorców listy odbiorców wycofane.
8 czerwca 2023 r.: listy odbiorców, na które ma to wpływ, zostaną usunięte ze wszystkich ustawień kierowania elementu zamówienia i zamówienia reklamowego oraz ze wszystkich połączonych list odbiorców. Jeśli po usunięciu tych list element zamówienia nie może wyświetlać reklam, zostaje wstrzymany. Tego dnia tych list odbiorców nie będzie też można pobrać za pomocą usługi googleAudiences.
Zalecane zadania:
Zalecamy, aby w przyszłości, gdy będziesz wprowadzać zmiany w kierowaniu elementu zamówienia, natychmiast przestać używać list odbiorców, których dotyczy problem.
Usuń wszystkie te listy odbiorców z dotychczasowego kierowania elementu zamówienia i zamówienia reklamowego. Więcej informacji o aktualizowaniu kierowania na odbiorców znajdziesz w przewodniku Grupy odbiorców.
20 maja 2023 r.: nie będzie już można przypisywać do elementu zamówienia lub kierowania na zamówienie reklamowe zasobów FirstAndThirdPartyAudience z AudienceTypeACTIVITY_BASED lub FREQUENCY_CAP. Prośby o przypisanie tych list odbiorców do kierowania na odbiorców elementu zamówienia zwrócą błąd. Obejmuje to żądania advertisers.lineItems.duplicate i advertisers.lineItems.generateDefault, jeśli utworzony element zamówienia będzie zawierać w kierowaniu na odbiorców listy odbiorców wycofane.
8 czerwca 2023 r.: listy odbiorców, na które ma to wpływ, zostaną usunięte ze wszystkich ustawień kierowania elementu zamówienia i zamówienia reklamowego oraz ze wszystkich połączonych list odbiorców. Jeśli po usunięciu tych list element zamówienia nie może wyświetlać reklam, zostaje wstrzymany. Tego dnia tych list odbiorców nie będzie też można pobrać za pomocą usługi firstAndThirdPartyAudiences.
Zalecane zadania:
Zalecamy, aby w przyszłości, gdy będziesz wprowadzać zmiany w kierowaniu elementu zamówienia, natychmiast przestać używać list odbiorców, których dotyczy problem.
Usuń wszystkie te listy odbiorców z dotychczasowego kierowania elementu zamówienia i zamówienia reklamowego. Więcej informacji o aktualizowaniu kierowania na odbiorców znajdziesz w przewodniku Grupy odbiorców.
Dotychczasowe limity przydziału interfejsu API
30 maja 2023 r.
30 maja 2023 r. dotychczasowe limity wykorzystania zostaną zastąpione hybrydową strukturą limitów, która:
Usuwa limit żądań dziennie na projekt.
Wprowadza limit żądań na minutę na reklamodawcę na projekt w przypadku kwalifikujących się metod.
Te nowe limity zapewnią większą elastyczność w korzystaniu z interfejsu API i umożliwią równoległe wysyłanie żądań przez różnych reklamodawców. Szczegółowe informacje o tej zmianie znajdziesz w naszej dokumentacji dotyczącej limitu kwoty.
Użycie operatora OR między ograniczeniami różnych pól w filtrach LIST
21 czerwca 2023 r.
21 czerwca 2023 r. parametry LIST żądania filter nie będą już zezwalać na używanie operatorów logicznych OR między ograniczeniami dotyczącymi różnych pól.
Na przykład zasoby zidentyfikowane za pomocą ciągu filtra lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" muszą być zamiast tego pobierane za pomocą 2 żądań LIST z tymi ciągami filtra:
Przed 21 czerwca 2023 r. sprawdź parametry zapytania filter we wszystkich dotychczasowych wywołaniach LIST i upewnij się, że używają one prawidłowo operatora logicznego LUB.
Aby uniknąć przerwy w działaniu usługi, przed 21 czerwca 2023 r. usuń całą logikę filtra, która korzysta z tych 4 pól.
Kupowanie na podstawie wyników
1 sierpnia 2023 r.
1 sierpnia 2023 r. zamówienia reklamowe korzystające z kupowania na podstawie wyników, z wartością pola billableOutcome równą BILLABLE_OUTCOME_PAY_PER_CLICK lub BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, oraz ich elementy zamówienia podrzędne zostaną zarchiwizowane.
Ta zmiana będzie miała wpływ na te prośby:
Próba użycia advertisers.insertionOrders.create do utworzenia zamówienia reklamowego z kupowaniem na podstawie wyników spowoduje błąd 400.
Opcje kierowania, które zostaną wycofane, zostaną automatycznie usunięte z dotychczasowego kierowania elementu zamówienia. Te wartości nadal będą dostępne do stosowania w kierowaniu na poziomie reklamodawcy.
Aby uniknąć przerw w świadczeniu usług, przed datą wycofania usuń to ustawienie kierowania z dotychczasowych elementów zamówienia typu YouTube i sieć partnerów wideo Google.
Własne listy odbiorców i listy odbiorców Oracle
30 września 2024 r.
30 września 2024 r. kończy się wsparcie dla źródeł danych FirstAndThirdPartyAudience firmy Oracle. Po wycofaniu te listy odbiorców zostaną usunięte z dotychczasowych ustawień kierowania na zasoby i z list odbiorców połączonych. Jeśli element zamówienia jest kierowany tylko na odbiorców objętych wycofaniem lub negatywnie na wszystkich odbiorców objętych wycofaniem, zostanie on automatycznie wstrzymany.
Aby uniknąć przerw w świadczeniu usług, przed datą wycofania z użycia zidentyfikuj i usuń z dotychczasowego kierowania na listę odbiorców w poszczególnych pozycjach reklamowych oraz z połączonych list odbiorców wszystkich odbiorców Oracle.
Kierowanie zoptymalizowane na element zamówienia w przypadku podzbioru strategii ustalania stawek
Aby uniknąć przerw w świadczeniu usług, zaktualizuj elementy zamówienia korzystające z tych strategii ustalania stawek i sprawdź, czy nie mają włączonego kierowania zoptymalizowanego.
Emisja, jak najszybciej Pacing w przypadku zamówień reklamowych
5 listopada 2024 r.
5 listopada 2024 r. podczas ustawiania pola zamówienia reklamowego pacingPACING_TYPE_ASAP nie będzie już zgodne z PACING_PERIOD_FLIGHT. Wartość pacingType we wszystkich istniejących zamówieniach reklamowych z tą konfiguracją zostanie zmieniona na PACING_TYPE_AHEAD.
Aby uniknąć przerw w świadczeniu usług, zaktualizuj pacing wszystkich istniejących zamówień reklamowych za pomocą PACING_TYPE_ASAP i PACING_PERIOD_FLIGHT.
Okres obowiązywania limitu wyświetleń na użytkownika przekracza 30 dni
Wpisy w plikach uporządkowanych danych Element zamówienia, Zamówienie reklamowe i Kampania, w których wartość w kolumnie „Okres częstotliwości” to „Dożywotnio” lub „Miesiące”, a wartość w kolumnie „Ilość wyświetleń” to „2”, nie zostaną utworzone ani zaktualizowane podczas przesyłania pliku.
Istniejące kampanie, zamówienia reklamowe i elementy zamówienia zostaną zaktualizowane, aby używały okresu ograniczenia liczby wyświetleń wynoszącego co najwyżej 30 dni.
Aby uniknąć przerw w działaniu usługi:
Zaktualizuj istniejące zasoby kampanii, zamówienia reklamowego i elementu zamówienia, które korzystają z okresu limitu wyświetleń na użytkownika dłuższego niż 30 dni, tak aby wynosił 30 dni lub krócej.
Sprawdź, czy podczas tworzenia lub aktualizowania zasobów kampanii, zamówienia reklamowego lub elementu zamówienia za pomocą interfejsu API Display & Video 360 lub plików uporządkowanych danych integracja nie ustawia okresu limitu wyświetleń na użytkownika dłuższego niż 30 dni.
Kierowanie zoptymalizowane w przypadku elementów zamówienia korzystających ze stałej stawki
Wpisy w plikach uporządkowanych danych Elementu zamówienia, w których wartość w kolumnie „Typ strategii ustalania stawek” to „Stałe”, a wartość w kolumnie „Skuteczne kierowanie” to „Prawda”, nie zostaną utworzone ani zaktualizowane podczas przesyłania pliku.
Istniejące elementy zamówienia korzystające ze stałego określania stawek zostaną zaktualizowane tak, aby wyłączyć kierowanie zoptymalizowane.
Aby uniknąć przerw w działaniu usługi:
Zaktualizuj istniejące zasoby elementów zamówienia, które korzystają zarówno ze stałego określania stawek, jak i z kierowania zoptymalizowanego.
Sprawdź, czy podczas tworzenia lub aktualizowania zasobów elementów zamówienia za pomocą interfejsu Display & Video 360 API lub plików uporządkowanych danych integracja nie ustawia stałej strategii ustalania stawek i optymalizowanego kierowania.
Zmień domyślny rozmiar strony na firstAndThirdPartyAudiences.list
Aby uniknąć przerw w działaniu usługi, zaktualizuj integrację, aby ustawić parametr zapytania pageSize żądań firstAndThirdPartyAudiences.list na preferowany rozmiar strony.
Nowy błąd niezgodności partnera/reklamodawcy sdfdownloadtasks.create
Wpisy w plikach uporządkowanych danych Elementu zamówienia, które próbują zaktualizować kolumnę „Conversion Floodlight Activity Ids” (Identyfikatory aktywności Floodlight powodującej konwersję), gdy kolumna „Algorithm Id” (Identyfikator algorytmu) jest ustawiona, nie zostaną zaktualizowane podczas przesyłania pliku.
Aby uniknąć przerw w świadczeniu usług, zaktualizuj integrację:
Sprawdź, czy odpowiednie aktywności Floodlight są przypisane do elementu zamówienia przed przypisaniem algorytmu ustalania stawek niestandardowych lub w tym samym czasie.
Przed próbą zaktualizowania algorytmów ustalania stawek niestandardowych są one odłączane od wszystkich elementów zamówienia.
Nieograniczony okres członkostwa w przypadku własnych list odbiorców
7 kwietnia 2025 r.
7 kwietnia 2025 r. zasoby FirstAndThirdPartyAudience nie będą już pozwalać na nieograniczony czas trwania członkostwa w grupie odbiorców. Żądania firstAndThirdPartyAudiences.create i firstAndThirdPartyAudiences.patch, które ustawiają wartość pola membershipDurationDays na 10 tys., zwracają błąd 400. Wartość pola membershipDurationDays w przypadku dotychczasowych list odbiorców o wartości 10 000 zostanie zaktualizowana do 540,a nowy czas trwania subskrypcji zostanie zastosowany z skutkiem wstecznym do dotychczasowych subskrypcji. Spowoduje to wygaśnięcie wszystkich członkostw starszych niż 540 dni.
Aby uniknąć przerw w działaniu usługi:
Sprawdź,czy integracja nie ustawia wartości pola membershipDurationDays nowych ani dotychczasowych list odbiorców na 10 tys.
Regularnie odświeżaj listy członków list odbiorców kierowania na listę klientów, aby nie dopuścić do niezamierzonego zmniejszenia rozmiaru listy odbiorców.
Kolumna „Współczynniki stawek” w plikach danych uporządkowanych dotyczących pozycji
1 maja 2025 r.
1 maja 2025 r. nie będzie można utworzyć ani zaktualizować zasobu podczas przesyłania pliku z pliku uporządkowanych danych Element zamówienia, który zawiera kolumnę „Współczynniki stawek”.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-02-28 UTC."],[[["This page provides a schedule of deprecation and sunset dates for Display & Video 360 API versions and features."],["Display & Video 360 API versions are regularly released, deprecated, and eventually sunset; users should migrate to newer versions before the sunset date to avoid service disruptions."],["The page includes tables outlining version and feature deprecations, with details on timelines, descriptions, and recommended actions for each."],["Users should regularly consult this page and the Google Ads developer blog for announcements and updates to stay informed about upcoming changes and ensure a smooth transition."]]],[]]