Zarchiwizowane wycofania funkcji

W tej tabeli znajdziesz listę wycofanych funkcji, które miały wpływ na wycofane wersje interfejsu Display & Video 360 API lub plików uporządkowanych danych. Zawiera ona początkową datę wejścia w życie, opis wycofania, zalecane działania i linki do odpowiedniej dokumentacji:

Funkcja Początkowa data wejścia w życie Opis
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:

  • Pliki SDF w wersjach v6v7 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.
Nowy błąd sdfdownloadtasks.create niezgodności partnera/reklamodawcy 6 marca 2025 r.

6 marca 2025 r. żądania sdfdownloadtasks.create, które używają filtra jednostki nadrzędnej do filtrowania reklamodawców, którzy nie są podmiotami podrzędnymi zestawu partnerId, zaczną zwracać błąd 400.

Zmiana domyślnego rozmiaru strony firstAndThirdPartyAudiences.list 6 marca 2025 r.

6 marca 2025 r. domyślny rozmiar strony w przypadku żądań firstAndThirdPartyAudiences.list zostanie zmieniony ze 100 na 5000.

Aby uniknąć przerw w działaniu usługi, zaktualizuj integrację, aby ustawić parametr zapytania pageSize w żądaniach firstAndThirdPartyAudiences.list na preferowany rozmiar strony.

Kierowanie zoptymalizowane w przypadku elementów zamówienia korzystających ze stałych stawek 6 marca 2025 r.

6 marca 2025 r.:

  • Żądania tworzenia lub aktualizowania zasobów LineItem, które ustawiają pola BiddingStrategy fixedBid i TargetingExpansionConfig enableOptimizedTargeting na wartość true, będą zwracać błąd 400.
  • 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 integracja nie ustawia stałej strategii ustalania stawek i kierowania zoptymalizowanego podczas tworzenia lub aktualizowania zasobów elementów zamówienia za pomocą interfejsu Display & Video 360 API lub plików uporządkowanych danych.
Okres obowiązywania limitu wyświetleń na użytkownika dłuższy niż 30 dni 28 lutego 2025 r.

28 lutego 2025 r.:

  • Żądania tworzenia lub aktualizowania zasobów LineItem, InsertionOrderCampaign, które używają obiektu FrequencyCap z polem timeUnit ustawionym na TIME_UNIT_LIFETIME lub polem timeUnit ustawionym na TIME_UNIT_MONTH i polem timeUnitCount ustawionym na 2, zwrócą błąd 400.
  • Wpisy w plikach uporządkowanych danych Line Item, Insertion OrderCampaign, 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.
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_ASAPPACING_PERIOD_FLIGHT.

Kierowanie zoptymalizowane w elemencie zamówienia w przypadku podzbioru strategii ustalania stawek 30 września 2024 r.

30 września 2024 r. LineItem zasoby korzystające z podzbioru strategii ustalania stawek przestaną być zgodne z kierowaniem zoptymalizowanym. W wyniku tej zmiany zasoby LineItem, w których parametr targetingExpansion.enableOptimizedTargeting ma wartość True, a parametr bidStrategy.maximizeSpendAutoBid.performanceGoalType ma wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN lub BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED albo parametr bidStrategy.performanceGoalAutoBid.performanceGoalType ma wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, zostaną zaktualizowane tak, aby parametr targetingExpansion.enableOptimizedTargeting miał wartość False.

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.

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 zasoby i z odbiorców z połączonych list. Jeśli element zamówienia jest kierowany tylko na wycofywane listy odbiorców lub jest kierowany negatywnie na wycofywane listy odbiorców, zostanie 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 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 elementów zamówienia 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.

pole publisherReviewStatuses w zasobach kreacji, 26 czerwca 2024 r.

Od 26 czerwca 2024 r. pole publisherReviewStatuses zostanie wycofane i będzie puste podczas pobierania zasobów Creative.

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.

Ta zmiana wpłynie na te żądania:

Możliwość filtrowania żądań advertisers.lineItems.list według 4 dodatkowych pól 21 czerwca 2023 r.

Od 21 czerwca 2023 r. advertisers.lineItems.list nie będzie już obsługiwać filtrowania według tych pól:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Aby uniknąć przerw w świadczeniu usług, przed 21 czerwca 2023 r. usuń całą logikę filtrowania korzystającą z tych 4 pól.

Możliwość filtrowania lub sortowania próśb o listę według pól budget.budget_segments.date_range.end_dateflight.dateRange.endDate

Zaktualizowano datę wejścia w życie

21 czerwca 2023 r.

21 czerwca 2023 r. pola budget.budget_segments.date_range.end_dateflight.dateRange.endDate przestaną być akceptowane w parametrach zapytań advertisers.insertionOrders.listadvertisers.lineItems.list filter oraz orderBy. Po tej dacie żądania korzystające z tych pól w parametrach zapytania filterorderBy będą zwracać błąd.

Aby uniknąć przerw w działaniu usługi, przed 21 czerwca 2023 r. usuń całą logikę filtrowania i sortowania korzystającą z tych dwóch pól.

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ż zezwalać na używanie 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:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Więcej informacji o ograniczeniach operatorów logicznych znajdziesz w naszej instrukcji filtrowania żądań LIST.

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.

Obecne limity interfejsu API 30 maja 2023 r.

30 maja 2023 r. dotychczasowe limity wykorzystania zostaną zastąpione hybrydową strukturą limitów, która:

  1. Eliminuje limit żądań dziennie na projekt.
  2. 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.

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 FirstAndThirdPartyAudienceAudienceType 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. Obejmuje to żądania advertisers.lineItems.duplicateadvertisers.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 zmiana, zostaną usunięci z kierowania wszystkich elementów zamówienia i zamówień reklamowych oraz ze wszystkich połączonych list odbiorców. Jeśli element zamówienia nie może wyświetlać reklam po usunięciu tych odbiorców, zostanie wstrzymany. Tego dnia te listy odbiorców nie będą już dostępne w usłudze firstAndThirdPartyAudiences.

Zalecane zadania:

  • Zalecamy, aby podczas wprowadzania przyszłych zmian w kierowaniu 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.
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 GoogleAudienceGoogleAudienceType 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. Obejmuje to żądania advertisers.lineItems.duplicateadvertisers.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 zmiana, zostaną usunięci z kierowania wszystkich elementów zamówienia i zamówień reklamowych oraz ze wszystkich połączonych list odbiorców. Jeśli element zamówienia nie może wyświetlać reklam po usunięciu tych odbiorców, zostanie wstrzymany. Tego dnia te listy odbiorców nie będą już dostępne w usłudze googleAudiences.

Zalecane zadania:

  • Zalecamy, aby podczas wprowadzania przyszłych zmian w kierowaniu 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.
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.
  • przestać wysyłać żądania do usługi advertisers.manualTriggers.
  • Zaktualizuj pola flight.flightDateTypeflight.triggerId we wszystkich elementach zamówienia za pomocą ręcznych wyzwalaczy.
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.