Od 8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej stronie dotyczącej wycofania.
Wersje interfejsu Display & Video 360 API są regularnie publikowane, wycofywane i zamykane. Te kroki są zdefiniowane w ten sposób:
Wersja: wersja przestaje być wersją alfa lub beta i jest uznawana za stabilną. Mogą być jeszcze udostępniane dodatkowe funkcje dla tej wersji.
Wycofanie: wersja jest wycofywana i ogłaszana jest data zakończenia obsługi. Użytkownicy muszą przejść na nowszą wersję przed datą wycofania. W przypadku tej wersji nie będą już udostępniane nowe funkcje.
Wycofana: wersja nie jest już obsługiwana. Żądania wysyłane do wersji
zwracają błąd.
W tej tabeli znajdziesz wszystkie obecne wersje interfejsu Display & Video 360 API, daty ich wprowadzenia oraz daty wycofania i zakończenia ich obsługi (jeśli zostały ogłoszone).
W tabeli poniżej znajdziesz listę wszystkich ogłoszonych wycofań funkcji wraz z początkową datą wejścia w życie i opisem wycofania, zalecanymi działaniami oraz linkami do odpowiedniej dokumentacji:
Funkcja
Początkowa data wejścia w życie
Opis
Rozszerzanie zasięgu kierowania
25 marca 2023 r.
Zastąpienie funkcji rozszerzania zasięgu kierowania funkcją kierowania zoptymalizowanego, które było wdrażane stopniowo od 25 marca do początku maja 2023 r. Odpowiednie zmiany w działaniu interfejsu Display & Video 360 API i plików uporządkowanych danych oraz zalecane działania zostały ogłoszone w poście na blogu.
Aktywatory ręczne
17 maja 2023 r.
Oś czasu:
17 maja 2023 r.: elementy zamówienia korzystające z ręcznych wyzwalaczy przestaną się wyświetlać w Display & Video 360. Jeśli po tej dacie aktywujesz ręczną regułę połączoną z aktywnym elementem zamówienia, element zamówienia nie będzie wyświetlać reklam.
1 sierpnia 2023 r.: wycofamy usługę advertisers.manualTriggers w interfejsach DV360 API w wersjach 1 i 2, wartość wyliczeniową LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER w interfejsie DV360 API w wersji 1 oraz pole LineItemFlight.triggerId w interfejsie DV360 API w wersji 1. Po tej dacie żądania wysyłane do tych usług lub tych pól będą zwracać błąd.
Zalecane działania:
Natychmiast przestań używać reguł ręcznych do rozpoczynania i zatrzymywania wyświetlania elementów zamówienia.
Zainstalowana aplikacja i nowe urządzenia mobilne GoogleAudience typy
20 maja 2023 r.
Oś czasu:
20 maja 2023 r.: nie będzie już można przypisywać zasobów GoogleAudience z GoogleAudienceType o wartości GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS lub GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES do kierowania na odbiorców w elementach zamówienia lub zamówieniach reklamowych. Żądania przypisania tych odbiorców do kierowania na odbiorców w elemencie zamówienia będą zwracać błąd. Dotyczy to żądań advertisers.lineItems.duplicate i advertisers.lineItems.generateDefault, jeśli utworzony element zamówienia zawierałby w kierowaniu na odbiorców wycofane listy odbiorców.
8 czerwca 2023 r.: odbiorcy, których dotyczy ta zmiana, zostaną usunięci z kierowania wszystkich elementów zamówienia i zleceń emisji oraz ze wszystkich połączonych list odbiorców. Jeśli po usunięciu tych odbiorców element zamówienia nie będzie mógł wyświetlać reklam, zostanie wstrzymany. Tego dnia te listy odbiorców nie będą już dostępne w usłudze googleAudiences.
Zalecane zadania:
Zalecamy, aby przy wprowadzaniu przyszłych aktualizacji kierowania elementu zamówienia natychmiast przestać używać list odbiorców, których dotyczy problem.
Usuń wszystkie grupy odbiorców, których dotyczy problem, z kierowania w dotychczasowych elementach zamówienia i zamówieniach reklamowych. Więcej informacji o aktualizowaniu kierowania na odbiorców znajdziesz w naszym przewodniku po grupach odbiorców.
Typy list odbiorców na podstawie aktywności i limitu wyświetleń na użytkownika FirstAndThirdPartyAudience
20 maja 2023 r.
Oś czasu:
20 maja 2023 r.: nie będzie już można przypisywać zasobów FirstAndThirdPartyAudience z AudienceType o wartości ACTIVITY_BASED lub FREQUENCY_CAP do kierowania na odbiorców w elementach zamówienia lub zamówieniach reklamowych. Żądania przypisania tych odbiorców do kierowania na odbiorców w elemencie zamówienia będą zwracać błąd. Dotyczy to żądań advertisers.lineItems.duplicate i advertisers.lineItems.generateDefault, jeśli utworzony element zamówienia zawierałby w kierowaniu na odbiorców wycofane listy odbiorców.
8 czerwca 2023 r.: odbiorcy, których dotyczy ta zmiana, zostaną usunięci z kierowania wszystkich elementów zamówienia i zleceń emisji oraz ze wszystkich połączonych list odbiorców. Jeśli po usunięciu tych odbiorców element zamówienia nie będzie mógł wyświetlać reklam, zostanie wstrzymany. Tego dnia te listy odbiorców nie będą już dostępne w usłudze firstAndThirdPartyAudiences.
Zalecane zadania:
Zalecamy, aby przy wprowadzaniu przyszłych aktualizacji kierowania elementu zamówienia natychmiast przestać używać list odbiorców, których dotyczy problem.
Usuń wszystkie grupy odbiorców, których dotyczy problem, z kierowania w dotychczasowych elementach zamówienia i zamówieniach reklamowych. Więcej informacji o aktualizowaniu kierowania na odbiorców znajdziesz w naszym przewodniku po grupach odbiorców.
Obecne 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:
Eliminuje limit zapytań dziennie na projekt.
Ustanawia limit żądań na minutę na reklamodawcę na projekt w przypadku kwalifikujących się metod.
Nowe limity zapewnią większą elastyczność w korzystaniu z interfejsu API i umożliwią równoległe wysyłanie żądań przez reklamodawców. Szczegóły tej zmiany znajdziesz w naszej dokumentacji dotyczącej limitów.
użycie operatora OR między ograniczeniami różnych pól w filtrach LIST.
21 czerwca 2023 r.
Od 21 czerwca 2023 r. parametry LIST request filter nie będą już umożliwiać używania OR operatorów logicznych między ograniczeniami różnych pól.
Na przykład zasoby zidentyfikowane za pomocą ciągu filtra lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" należy pobrać za pomocą 2 żądań LIST z tymi ciągami filtra:
Przed 21 czerwca 2023 r. sprawdź filterparametry zapytańLIST wszystkich dotychczasowych wywołań i upewnij się, że prawidłowo używają operatora logicznego LUB, aby uniknąć przerw w działaniu usługi.
Aby uniknąć przerw w świadczeniu usług, przed 21 czerwca 2023 r. usuń całą logikę filtrowania korzystającą 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, zdefiniowane przez wartość pola billableOutcome równą BILLABLE_OUTCOME_PAY_PER_CLICK lub BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, oraz ich podrzędne elementy zamówienia zostaną zarchiwizowane.
Kierowanie na treści w przypadku elementów zamówienia typu YouTube i sieć partnerów wideo Google
30 września 2024 r.
30 września 2024 r. w przypadku elementów zamówienia typu YouTube i sieć partnerów wideo Google wycofane zostaną te wartości w przypadku określonych typów kierowania:
Wycofane opcje kierowania zostaną automatycznie usunięte z kierowania w dotychczasowych elementach zamówienia. Te wartości nadal będą dostępne do kierowania na poziomie reklamodawcy.
Aby uniknąć przerw w świadczeniu usług, przed datą wycofania usuń to kierowanie ze wszystkich dotychczasowych elementów zamówienia typu YouTube i sieć partnerów wideo Google.
Własne listy odbiorców Oracle i listy odbiorców dostarczone przez firmę zewnętrzną
30 września 2024 r.
30 września 2024 r. wycofamy źródła zasobów FirstAndThirdPartyAudience z Oracle. Po wycofaniu te listy odbiorców zostaną usunięte z kierowania na istniejące zasoby i z list połączonych. Jeśli element zamówienia jest kierowany tylko na wycofywane listy odbiorców lub jest kierowany negatywnie na takie listy, zostanie on automatycznie wstrzymany.
Aby uniknąć przerw w świadczeniu usług, przed datą wycofania zidentyfikuj i usuń wszystkie grupy odbiorców Oracle z kierowania na odbiorców w istniejących elementach zamówienia i połączonych grupach odbiorców.
Kierowanie zoptymalizowane w elemencie 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. wartość PACING_TYPE_ASAP nie będzie już zgodna z wartością PACING_PERIOD_FLIGHT podczas ustawiania pola pacing zamówienia reklamowego. W przypadku wszystkich istniejących zamówień reklamowych z tą konfiguracją wartość pacingType zostanie zaktualizowana do PACING_TYPE_AHEAD.
Aby uniknąć przerw w świadczeniu usług, zaktualizuj pacing wszystkich dotychczasowych zamówień reklamowych za pomocą PACING_TYPE_ASAP i PACING_PERIOD_FLIGHT.
Okres obowiązywania limitu wyświetleń na użytkownika dłuższy niż 30 dni
Wpisy w plikach uporządkowanych danych Line Item, Insertion Order i Campaign, w których kolumna „Frequency Period” ma wartość „Lifetime” lub „Months”, a kolumna „Frequency Amount” ma wartość „2”, nie zostaną utworzone ani zaktualizowane po przesłaniu pliku.
Obecne kampanie, zamówienia reklamowe i elementy zamówienia zostaną zaktualizowane, aby korzystać z okresu limitu wyświetleń na użytkownika wynoszącego maksymalnie 30 dni.
Aby uniknąć przerw w działaniu usługi:
Zaktualizuj dotychczasowe zasoby kampanii, zamówień reklamowych i elementów zamówienia, które korzystają z okresu limitu wyświetleń na użytkownika dłuższego niż 30 dni, tak aby wynosił on 30 dni lub mniej.
Sprawdź, czy podczas tworzenia lub aktualizowania zasobów kampanii, zamówień reklamowych lub elementów zamówienia za pomocą interfejsu Display & Video 360 API 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łych stawek
Wpisy w plikach uporządkowanych danych Element zamówienia, w których kolumna „Typ strategii ustalania stawek” ma wartość „Stałe”, a kolumna „Optymalizowane kierowanie” ma wartość „Prawda”, nie zostaną utworzone ani zaktualizowane podczas przesyłania pliku.
W obecnych elementach zamówienia korzystających ze stałego określania stawek zostanie wyłączone kierowanie zoptymalizowane.
Aby uniknąć przerw w działaniu usługi:
Aktualizować zasoby istniejących 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 kierowania zoptymalizowanego.
Zmiana domyślnego rozmiaru strony firstAndThirdPartyAudiences.list
Aby uniknąć przerw w działaniu usługi, zaktualizuj integrację, aby ustawić parametr zapytania pageSize w żądaniach firstAndThirdPartyAudiences.list na preferowany rozmiar strony.
Nowy błąd sdfdownloadtasks.create niezgodności partnera lub reklamodawcy
Ograniczenia dotyczące elementów zamówienia YouTube typu „Zasięg” w pliku SDF
24 marca 2025 r.
Od 24 marca 2025 r. pliki uporządkowanych danych będą wymagać używania bardziej rozbudowanych formatów reklam podczas tworzenia lub aktualizowania elementów zamówienia. W praktyce wygląda to tak:
Wersje v6 i v7 pliku SDF nie obsługują już tworzenia nowych wpisów w pliku elementu zamówienia z wartością Subtype „Zasięg”.
Nowe wpisy w plikach SDF Element zamówienia z wartością Subtype „Zasięg” muszą mieć wartość „Responsywne” w kolumnie TrueView Video Ad Formats. Istniejące wpisy z wartością Subtype „Zasięg” nie mogą aktualizować wartości w kolumnie TrueView Video Ad Formats.
Nowe wpisy w plikach SDF Element zamówienia z wartością Subtype „Zasięg” wymagają wypełnienia kolumny TrueView Video Ad Inventory Control.
Niezgodność algorytmu ustalania stawek niestandardowych i aktywności Floodlight
Wpisy w plikach uporządkowanych danych Element zamówienia, które próbują zaktualizować kolumnę „Identyfikatory aktywności Floodlight powodujących konwersję”, gdy kolumna „Identyfikator algorytmu” jest ustawiona, nie zostaną zaktualizowane podczas przesyłania pliku.
Aby uniknąć przerw w działaniu usługi, zaktualizuj integrację w ten sposób:
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ą aktualizacji istniejące algorytmy ustalania stawek niestandardowych są 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 przestaną umożliwiać nieograniczony czas trwania członkostwa w odbiorcach. Żądania firstAndThirdPartyAudiences.create i firstAndThirdPartyAudiences.patch, w których wartość pola membershipDurationDays jest ustawiona na 10 000, będą zwracać błąd 400. Dotychczasowe listy odbiorców z wartością pola membershipDurationDays wynoszącą 10 000 zostaną zaktualizowane do 540,a nowy czas trwania subskrypcji zostanie zastosowany wstecznie do istniejących 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 lub dotychczasowych odbiorców na 10 000.
Kampanie wideo zachęcające do działania w plikach danych strukturalnych
22 kwietnia 2025 r.
22 kwietnia 2025 r. nie będzie już można tworzyć elementów zamówienia w kampaniach wideo zachęcających do działania za pomocą plików uporządkowanych danych, ponieważ zostaną one przekształcone w kampanie generujące popyt. Próby przesłania wpisów elementów zamówienia z wartością kolumny Subtype „Action” (Działanie) i wartością kolumny Type „TrueView” zakończą się niepowodzeniem.
Aby uniknąć przerw w działaniu usługi, zaktualizuj integrację, aby korzystać z kampanii generujących popyt zamiast z kampanii wideo zachęcających do działania.
Wymagaj źródła zasobów reklamowych sieci partnerów wideo w przypadku elementów zamówienia generujących popyt w plikach danych strukturalnych
22 kwietnia 2025 r.
Od 22 kwietnia 2025 r. w kolumnie TrueView Inventory Source Targeting wpisów elementów zamówienia, które mają w kolumnie Type wartość „Generowanie popytu”, musisz podawać wartość „Partnerzy wideo”. Gdy zaczniemy egzekwować to wymaganie, wartość zostanie uzupełniona w przypadku dotychczasowych elementów zamówienia i uwzględniona podczas pobierania nowych plików danych strukturalnych.
Aby uniknąć przerw w działaniu usługi:
Zaktualizuj integrację, aby we wszystkich wpisach elementu zamówienia z kampanii generującej popyt uwzględniać wartość „Sieć partnerów wideo”.
Zaktualizuj integrację, aby zarządzać źródłami asortymentu kampanii generujących popyt na poziomie grupy reklam za pomocą kolumn SDF w wersji 8.1 – grupa reklamDemand Gen Inventory Source Strategy i Demand Gen Enabled Inventory Sources.
Kolumna „Mnożniki stawek” w plikach danych strukturalnych elementów zamówienia
1 maja 2025 r.
1 maja 2025 r. wpisy w plikach uporządkowanych danych Element zamówienia, które próbują ustawić kolumnę „Mnożniki stawek”, nie będą mogły utworzyć ani zaktualizować zasobu podczas przesyłania pliku.
Ustawienia kategorii treści w przypadku elementów zamówienia typu YouTube i sieć partnerów wideo Google
12 czerwca 2025 r.
12 czerwca 2025 r. w ramach aktualizacji funkcji dopasowania do marki konfiguracje kategorii treści w poszczególnych elementach zamówienia typu YouTube i sieć partnerów wideo Google nie będą już modyfikowalnym poziomem. Ustawienia kategorii treści będą odtąd kontrolowane wyłącznie na poziomie reklamodawcy. Aby uwzględnić tę zmianę, w interfejsie Display & Video 360 API i plikach uporządkowanych danych zostaną wprowadzone te zmiany:
Pole contentCategory w obiektach YoutubeAndPartnersSettings zasobów LineItem YouTube i sieci partnerów wideo Google nie będzie już aktualizowane. Zostanie on całkowicie usunięty w późniejszym terminie.
Kolumna TrueView Content Filter w plikach SDF elementu zamówienia nie będzie już dostępna do zapisu.
Aby uniknąć przerw w działaniu usługi:
Podczas sprawdzania w interfejsie API elementów zamówienia typu YouTube i sieć partnerów wideo Google pobieraj pole effectiveContentCategory zamiast pola contentCategory.
Podczas aktualizowania wpisów elementu zamówienia SDF nie modyfikuj kolumny TrueView Content Filter. Podczas tworzenia nowych elementów zamówienia pozostaw tę kolumnę pustą.
Aktualizacje budżetu elementu zamówienia z optymalizacją zamówienia reklamowego
12 czerwca 2025 r.
Od 12 czerwca 2025 r. nie będzie można aktualizować ustawień budżetu w przypadku elementów zamówienia z nadrzędnymi zamówieniami reklamowymi skonfigurowanymi pod kątem optymalizacji za pomocą strategii automatycznego określania stawek.
W pliku SDF: sprawdź, czy w przypadku nadrzędnego zamówienia reklamowego elementu zamówienia w kolumnie Insertion Order Optimization jest ustawiona wartość TRUE. Jeśli tak jest, nie próbuj aktualizować kolumn Budget Type ani Budget Amount w przypadku wpisu SDF elementu zamówienia.
Ograniczenia dotyczące witryn w przypadku plików uporządkowanych danych
12 czerwca 2025 r.
12 czerwca 2025 r. usuniemy istniejące ograniczenie dotyczące adresów URL kierowanych w pozycjach SDF, które uniemożliwiało uwzględnianie nowszych witryn. Zamiast tego SDF będzie dopasowywać się do działania interfejsu API i interfejsu użytkownika oraz umożliwiać kierowanie na adresy URL, o ile są one prawidłowo sformatowane.
Zadeklaruj, czy elementy zamówienia wyświetlają reklamy polityczne w UE
8 września 2025 r.
Od 8 września 2025 r. podczas tworzenia nowego elementu zamówienia za pomocą interfejsu Display & Video 360 API lub plików SDF będziesz musiał(-a) zadeklarować, czy element zamówienia będzie wyświetlać reklamy polityczne w Unii Europejskiej. Oświadczenia te można składać w następujący sposób:
Za pomocą kolumny Contains EU Political Ads w pliku SDF w wersji 9 o typie Element zamówienia.
Jeśli reklamodawca nadrzędny nie będzie zawierać żadnych elementów zamówienia wyświetlających unijne reklamy polityczne, możesz zadeklarować to na poziomie reklamodawcy za pomocą pola containsEuPoliticalAds w zasobie Advertiser interfejsu Display & Video 360 API. Jeśli to pole ma wartość DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, wszystkie nowe elementy zamówienia w ramach reklamodawcy będą miały przypisaną tę samą wartość, o ile nie określono inaczej, a wszystkie dotychczasowe elementy zamówienia w ramach reklamodawcy zostaną zaktualizowane, aby używać tej samej wartości, jeśli nie jest ona jeszcze ustawiona. Deklarację elementu zamówienia można zaktualizować w dowolnym momencie po jego utworzeniu za pomocą interfejsu, interfejsu API lub pliku SDF.
Jeśli nie możesz zadeklarować na poziomie reklamodawcy lub zadeklarowałeś(-aś), że w ramach Twojego reklamodawcy mogą być wyświetlane unijne reklamy polityczne, zaktualizuj integrację interfejsu Display & Video 360 API i SDF przed 8 września 2025 r., aby uniknąć przerw w działaniu usługi:
Przejdź na używanie plików uporządkowanych danych w wersji 9 i ustaw kolumnę Contains EU Political Ads dla wszystkich nowych elementów zamówienia na Yes lub No podczas przesyłania. Szczegółowe instrukcje znajdziesz w naszym przewodniku po migracji do wersji 9.
Przed zaktualizowaniem kierowania geograficznego w przypadku istniejącego elementu zamówienia za pomocą interfejsu Display & Video 360 API lub pliku SDF zaktualizuj element zamówienia, aby podać deklarację.
[null,null,["Ostatnia aktualizacja: 2025-08-21 UTC."],[[["\u003cp\u003eThis page provides a schedule of deprecation and sunset dates for Display & Video 360 API versions and features.\u003c/p\u003e\n"],["\u003cp\u003eDisplay & 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.\u003c/p\u003e\n"],["\u003cp\u003eThe page includes tables outlining version and feature deprecations, with details on timelines, descriptions, and recommended actions for each.\u003c/p\u003e\n"],["\u003cp\u003eUsers 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.\u003c/p\u003e\n"]]],[],null,[]]
