Informacje o wersjach

Na tej stronie znajdziesz informacje o wersji interfejsu Display & Video 360 API.

Najnowsza wersja interfejsu API: v3

23 kwietnia 2024 r.

Nowe funkcje

Dodaliśmy obsługę nowych typów wskaźników KPI, giełd i platform aplikacji.

v3

  • Dodaliśmy te pola:

    ZasóbPola
    Kpi

    kpiAlgorithmId

  • Dodano te wartości enum:

    Typ wyliczeniowyWartości
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    Giełda

    EXCHANGE_DRAX

    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

28 lutego 2024 r.

Nowe funkcje

Dodaliśmy możliwość bezpośredniego usuwania członków z list odbiorców kierowania na listę klientów.

Dodaliśmy obsługę kierowania na nowe giełdy.

v3

v2

29 stycznia 2024 r.

Nowe funkcje

Dodaliśmy możliwość pobierania aktywności Floodlight za pomocą nowej usługi floodlightGroups.floodlightActivities.

Dodaliśmy nowe pole informujące, czy element zamówienia YouTube i sieć partnerów wideo Google uwzględnia w kierowaniu zasoby reklamowe Google TV.

Dodaliśmy nowe pole, które przekazuje czas ostatniego logowania użytkownika Display & Video 360.

v3

v2

14 listopada 2023 r.

Nowe funkcje

Dodaliśmy obsługę przekazywania zgody użytkownika podczas przesyłania list odbiorców z kierowania na listę klientów we wszystkich aktywnych wersjach.

v3

v2

31 października 2023 r.

Nowe funkcje

Wersja 3 została wycofana z publicznej wersji beta i udostępniona wszystkim użytkownikom.

Zmieniliśmy nazwę wartości wyliczenia AdGroupFormat w wersji 3, aby trafniej odzwierciedlała odpowiedni format.

Dodaliśmy obsługę plików uporządkowanych danych w wersji 7 i dodaliśmy wartość wyliczeniową SDF_VERSION_7 w wersjach 2 i 3.

v3

  • Usunęliśmy te wartości enum:

    Typ wyliczeniowyWartości
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Dodano te wartości enum:

    Typ wyliczeniowyWartości
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Dodano te wartości enum:

    Typ wyliczeniowyWartości
    SdfVersion

    SDF_VERSION_7

2 października 2023 r.

Nowe funkcje

Wprowadziliśmy wersję 3 w publicznej wersji beta, w której wprowadziliśmy te zmiany:

Aby przejść z wersji 2 na wersję 3, wykonaj czynności opisane w przewodniku po migracji.

Dodaliśmy obsługę 3 nowych wartości LineItemType, 1 nowej YoutubeAndPartnersBiddingStrategyType i 1 nowego PartnerCostType w wersjach 2 i 3.

v3

v2

25 sierpnia 2023 r.

Nowe funkcje

Dodaliśmy obsługę 2 giełd i 2 nowych typów strategii ustalania stawek typu YouTube i sieć partnerów wideo Google.

Do elementów zamówienia typu YouTube i sieć partnerów wideo Google dodaliśmy nowe pole effectiveContentCategory, aby wyświetlać wartość YoutubeAndPartnersContentCategory używaną przez element zamówienia podczas uwzględniania wartości przypisanych na poziomie reklamodawcy i elementu zamówienia.

v2

5 czerwca 2023 r.

Nowe funkcje

W wersjach 1 i 2 dodaliśmy nową wartość SdfVersion do plików uporządkowanych danych (SDF) v6.

v2

  • Dodano te wartości enum:

    Typ wyliczeniowyWartości
    SdfVersion

    SDF_VERSION_6

v1

  • Dodano te wartości enum:

    Typ wyliczeniowyWartości
    SdfVersion

    SDF_VERSION_6

9 marca 2023 r.

Nowe funkcje

Dodaliśmy nową wartość LineItemWarningMessage, która zostanie przypisana do pola warningMessages elementu zamówienia, jeśli wycofane pole excludeFirstPartyAudience ma wartość true. Po 25 marca 2023 r. pole excludeFirstPartyAudience zostanie wycofane i ustawione na false.

v2

  • Dodano te wartości enum:

    Typ wyliczeniowyWartości
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Dodano te wartości enum:

    Typ wyliczeniowyWartości
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 lutego 2023 r.

Nowe funkcje

Dodaliśmy możliwość pobierania zasobów YouTubeAdGroup i YouTubeAdGroupAd, a także kierowanie na zasoby grupy reklam w YouTube. Dodaliśmy również nowe typy kierowania dostępne na poziomie grup reklam w YouTube. Więcej informacji znajdziesz na nowej stronie z przewodnikiem dotyczącym pobierania materiałów dla YouTube i partnerów.

Dodaliśmy obsługę 4 dodatkowych giełd w wersjach 1 i 2.

v2

v1

  • Dodano te wartości enum:

    Typ wyliczeniowyWartości
    Giełda

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 grudnia 2022 r.

Nowe funkcje

Wersja 2 została wycofana z publicznej wersji beta i udostępniona wszystkim użytkownikom.

Do zasobu AssignedTargetingOption dodaliśmy nowe pole assignedTargetingOptionIdAlias, którego można używać zamiast assignedTargetingOptionId podczas pobierania i usuwania ustawień kierowania. To pole jest ustawione tylko dla przypisanych opcji kierowania typów kierowania przypisanych przez wyliczenie. Wartość aliasu to odpowiednia wartość wyliczenia jako ciąg znaków.

Do zasobu Advertiser dodano nowe pole billingConfig.

Dodaliśmy obsługę pobierania elementów zamówienia Over-The-Top typu YouTube i sieć partnerów wideo Google, które są identyfikowane na podstawie 3 nowych wartości parametru LineItemType.

Zwiększyliśmy maksymalny rozmiar strony do 200 dla wielu metod list w wersjach 1 i 2. Domyślny rozmiar strony się nie zmieni.

v2

v1

Znane problemy

Ta aktualizacja rozwiązuje następujące znane problemy w wersji 2:

27 października 2022 r.

Dodaliśmy możliwość duplikowania istniejącego elementu zamówienia w elemencie nadrzędnym InsertionOrder.

Wprowadziliśmy obsługę zapisu częściowego kierowania zamówień reklamowych w przypadku podzbioru typów kierowania oraz dodaliśmy metody create i delete do usługi advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Nowe funkcje

v2

v1

Do wersji 1 nie dodano żadnych nowych funkcji.

20 września 2022 r.

Wprowadziliśmy wersję 2 w publicznej wersji beta, w której wprowadziliśmy te zmiany:

Aby przejść z wersji 1 na wersję 2, wykonaj czynności opisane w przewodniku po migracji.

W wersji 1 dodaliśmy obsługę 3 nowych giełd.

Nowe funkcje

v2

Poniżej znajduje się lista zmian wprowadzonych w wersjach 1 i 2:

v1

  • W wersji 1 dodano te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    Giełda

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 maja 2022 r.

Dodaliśmy możliwość tworzenia zasobów InventorySource i zarządzania zasobami GuaranteedOrder za pomocą nowych metod zapisu w usłudze inventorySources oraz nowej usługi guaranteedOrders.

W zasobie CustomBiddingAlgorithm wprowadzono pole modelReadiness. To pole zawiera informacje o gotowości modelu algorytmu dla każdego reklamodawcy, który ma do niego dostęp.

Włączono nową funkcję parametru zapytania filter w przypadku metody advertisers.creatives.list, która umożliwia użytkownikowi pobieranie kreacji tylko z wartością updateTime przed podaną sygnaturą czasową lub po niej.

Dodaliśmy obsługę najnowszej wersji SDF (v5.5) dzięki dodaniu wartości wyliczeniowej SdfVersion.

Nowe funkcje

31 marca 2022 r.

Dodaliśmy obsługę pobierania i ustawiania kierowania na czas trwania treści, typ strumienia i gatunek.

Dodano pole billableOutcome do obiektu InsertionOrder.

Wprowadzono pole raiseBidForDeals do obiektu MaximizeSpendBidStrategy, aby umożliwić użytkownikom określenie, czy strategia ustalania stawek ma stosować ceny minimalne reklamodawcy w umowach objętych kierowaniem.

Nowe funkcje

2 lutego 2022 r.

Dodaliśmy obsługę tworzenia, aktualizowania i edytowania użytkowników niektórych zasobów kierowania na listę klientów FirstAndThirdPartyAudience. Informacje o tym, jak korzystać z tych nowych funkcji, znajdziesz na stronie Prześlij odbiorców z kierowania na listę klientów w naszym nowym przewodniku Używanie list odbiorców.

W zasobach InsertionOrder i LineItem wprowadziliśmy nowe pole reservationType, które wskazuje, czy zasób jest objęty gwarancją tagu, gwarantowaną automatyzacją czy niegwarantowaną automatyzacją.

W nowym polu excludeNewExchanges dodaliśmy możliwość pobierania danych i określania, czy element zamówienia jest automatycznie kierowany na nowe giełdy.

Oprócz nowych funkcji podwoiliśmy też domyślne limity.

Nowe funkcje

Grudzień 8, 2021

Dodaliśmy obsługę kierowania na typ treści audio w ramach typu kierowania TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Nowe funkcje

8 listopada 2021 r.

Dodaliśmy pełną obsługę zarządzania algorytmami ustalania stawek niestandardowych i ich skryptami. Obejmuje to m.in.:

Do przewodnika Zarządzanie elementami zamówienia dodaliśmy nową stronę Wdrażanie ustalania stawek niestandardowych, która opisuje proces tworzenia algorytmu ustalania stawek niestandardowych, przesyłania skryptu i przypisywania algorytmu ustalania stawek niestandardowych jako strategii ustalania stawek elementu zamówienia.

Dodaliśmy obsługę najnowszej wersji SDF (v5.4) dzięki dodaniu wartości wyliczeniowej SdfVersion.

Nowe funkcje

14 września 2021 r.

Dodaliśmy obsługę kierowania na zbliżony obszar w przypadku typów kierowania TARGETING_TYPE_BUSINESS_CHAIN i TARGETING_TYPE_POI.

Dodaliśmy możliwość wyszukiwania dostępnych opcji kierowania TARGETING_TYPE_BUSINESS_CHAIN i TARGETING_TYPE_POI przy użyciu targetingTypes.targetingOptions.search, ponieważ nie można ich pobrać za pomocą metody targetingTypes.targetingOptions.get ani targetingTypes.targetingOptions.list.

W zasobie algorytmu ustalania stawek niestandardowych wprowadziliśmy nowe pola sharedAdvertiserIds i customBiddingAlgorithmState oraz dodaliśmy obsługę algorytmu ustalania stawek niestandardowych GOAL_BUILDER_BASED.

Dodaliśmy 2 nowe wartości do wyliczenia Exchange.

Nowe funkcje

4 sierpnia 2021 r.

Dodaliśmy obsługę kierowania na zasoby reklamowe z obsługą Open Measurement w ramach typu kierowania TARGETING_TYPE_OMID.

Zwiększyliśmy maksymalną liczbę przypisanych opcji kierowania, które mogą zostać zwrócone na jednej stronie w przypadku różnych metod listy opcji kierowania reklamodawców, kampanii, zamówień reklamowych i elementów zamówienia, które przypisano za pomocą parametru metody pageSize.

Nowe funkcje

26 maja 2021 r.

Udostępniliśmy usługę advertisers.invoices, która umożliwia użytkownikom:

  • pobieranie faktur wystawionych reklamodawcy w danym miesiącu.
  • wyszukać kod waluty używany przez reklamodawcę w danym miesiącu.

Dodano pole campaignBudgets do zasobu kampanii. Segmenty budżetu zamówienia reklamowego można połączyć z budżetem kampanii, dzięki czemu łączny budżet powiązanych segmentów jest ograniczony do kwoty łącznego budżetu kampanii.

W ramach nowego typu kierowania TARGETING_TYPE_NATIVE_CONTENT_POSITION dodaliśmy obsługę natywnego kierowania na pozycję treści.

W zasobach reklamodawcy wprowadziliśmy nowe pole prismaEnabled, które umożliwia użytkownikom włączenie integracji z narzędziem Prisma firmy Mediaocean.

Włączono obsługę wartości wyliczeniowej ENTITY_STATUS_PAUSED w polu entityStatus reklamodawcy.

Nowe funkcje

29 kwietnia 2021 r.

Do zasobów Kanał i Lista wykluczających słów kluczowych dodaliśmy nowe pola, które zwracają liczbę elementów zamówienia korzystających z tego zasobu do kierowania. W metodzie listy elementów zamówienia dodaliśmy nowe właściwości filter, które pozwalają użytkownikowi pobierać tylko te elementy zamówienia, które w kierowaniu używają określonych kanałów lub list wykluczających słów kluczowych.

Nowe funkcje

30 marca 2021 r.

Do usługi elementu zamówienia dodaliśmy nową metodę, która generuje element zamówienia z konfiguracjami domyślnymi. Wartości domyślne zależą od podanego typu elementu zamówienia oraz ustawień i przypisanego kierowania nadrzędnego zamówienia reklamowego.

Pobieranie ustawień kierowania kampanii zostało włączone za pomocą nowej usługi kierowania kampanii i dodatkowej metody zbiorczej listy.

Rozszerzone kierowanie na aplikacje, które umożliwia kierowanie aplikacji na więcej platform.

Wprowadziliśmy wiele zmian w usługach advertisers.channels.sites, partners.channels.sites i advertisers.negativeKeywordLists.negativeKeywords, aby ułatwić zarządzanie treściami związanymi z kanałami i listami wykluczających słów kluczowych. Są to:

  • Dodanie metod replace, które umożliwiają użytkownikowi pełne zastąpienie istniejącej zawartości kanału lub listy wykluczających słów kluczowych.
  • Usunęliśmy wymóg uwzględniania żadnych istniejących elementów w polach createdSites ani createdNegativeKeywords w prośbach o zmianę zbiorczą.
  • Zwiększenie maksymalnej liczby elementów, które można zwrócić na jednej stronie odpowiedzi na listę witryn lub listę wykluczających słów kluczowych.

Nowe funkcje

Elementy wycofane

24 lutego 2021 r.

Wprowadziliśmy nową usługę kierowania zamówień reklamowych oraz dodatkową metodę list zbiorczych, które umożliwiają pobieranie kierowania przypisanych do zamówień reklamowych. Rozwinięto zasób kreacji, dodając pola kreacji „tylko dane wyjściowe” do wykorzystania w kreacjach audio firm zewnętrznych. Dodaliśmy nowe typy celów związanych ze skutecznością do wykorzystania przez zasoby zamówienia reklamowego i kampanii.

Nowe funkcje

27 stycznia 2021 r.

Umożliwiliśmy pobieranie telewizyjnych zamówień reklamowych i elementów zamówienia Over-The-Top oraz zarządzanie nimi dzięki wprowadzeniu nowego pola „InsertOrderType” i nowej wartości wyliczenia LineItemType. W polu elementu zamówienia mobileApp dodaliśmy obsługę elementów zamówienia w aplikacjach mobilnych. Rozszerzyliśmy obsługę Exchange, odbiorców Google i SDF za pomocą dodatkowych wartości enum. Wprowadzono możliwość filtrowania i porządkowania wartości advertisers.list według czasu ostatniej aktualizacji.

Nowe funkcje

Grudzień 4, 2020

Dodaliśmy możliwość wyszukiwania opcji kierowania na regiony geograficzne i filtrowania wielu wyników metod z listą zasobów według czasu ostatniej aktualizacji. Wprowadziliśmy nową wiadomość LineItemWarningMessage informującą użytkowników o tym, że element zamówienia korzysta z wycofanego kierowania geograficznego.

Nowe funkcje

5 listopada 2020 roku

Dodaliśmy możliwość tworzenia, przypisywania i aktywowania reguł ręcznych, które inicjują wydatki w powiązanych elementach zamówienia. Wprowadziliśmy opcje rozszerzania zasięgu kierowania, które po skonfigurowaniu mogą rozszerzyć kierowanie elementu zamówienia, aby uwzględnić użytkowników podobnych do tych z grup odbiorców docelowych. Do obiektów DoubleVerify i Integral Ad Science wykorzystywanych do kierowania reklam z weryfikacji zewnętrznej dodano niestandardowe pola identyfikatorów segmentów.

Nowe funkcje

12 października 2020 r.

W zasobie elementu zamówienia dodaliśmy ostrzeżenia z możliwością pobierania oraz docelową skuteczność współczynnika klikalności (CTR). Dodano pole warningMessages jako możliwe do filtrowania podczas wyświetlania listy elementów zamówienia.

Oprócz nowych funkcji obowiązują teraz nowe limity limitów i dostępna jest nowa dokumentacja korzystania z żądań zbiorczych.

Nowe funkcje

28 sierpnia 2020 r.

Dodaliśmy nowe pola do odpowiedzi metody kontroli reklamodawców i nowe pola z możliwością filtrowania do różnych metod list.

Nowe funkcje

4 sierpnia 2020 roku

Wprowadziliśmy nowe usługi do zarządzania użytkownikami, partnerów i kierowania reklam na partnerów. Wprowadziliśmy narzędzia, które pomagają użytkownikom aktywnie unikać przekraczania limitów elementów na koncie. Dodaliśmy obsługę elementów zamówienia audio i korzystania z algorytmów ustalania stawek niestandardowych w strategiach ustalania stawek elementów zamówienia i zamówień reklamowych.

Nowe funkcje

24 czerwca 2020 r.

Wprowadziliśmy niewielką aktualizację, dodając metodę tworzenia dla kanałów partnerów i reklamodawców, nowe pola FirstAndThirdPartyAudience oraz dodatkowe wartości wyliczeniowe giełd.

Nowe funkcje

2 czerwca 2020 r.

Wprowadziliśmy możliwość tworzenia, poprawek i wypełniania podzbioru elementów, na które można kierować reklamy, oraz dodawania możliwości modyfikowania kierowania na poziomie reklamodawcy w przypadku 3 typów kierowania: kanału, wykluczania etykiet treści cyfrowych i wykluczania kategorii reklam o charakterze kontrowersyjnym.

Nowe funkcje

27 kwietnia 2020 r.

Wprowadziliśmy duży zestaw funkcji i rozszerzyliśmy zakres interfejsu API poza SDF. Dodaliśmy funkcje zarządzania podstawowymi zasobami, które umożliwiają tworzenie, pobieranie, aktualizowanie i usuwanie elementów takich jak reklamodawcy, kampanie, zamówienia reklamowe, elementy zamówienia i kreacje. Nowe funkcje umożliwiają też edytowanie kierowania na poziomie elementu zamówienia.

Nowe funkcje

Dodaliśmy te usługi:

UsługaMetody
reklamodawców

utwórz

usuń

pobierz

lista

poprawka

advertisers.assets

prześlij

advertisers.campaigns

utwórz

usuń

pobierz

lista

poprawka

advertisers.channels

pobierz

lista

advertisers.creatives

utwórz

usuń

pobierz

lista

poprawka

advertisers.insertionOrders

utwórz

usuń

pobierz

lista

poprawka

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

utwórz

usuń

pobierz

lista

poprawka

advertisers.lineItems.targetingTypes.assignedTargetingOptions

utwórz

usuń

pobierz

lista

advertisers.locationLists

pobierz

lista

advertisers.negativeKeywordLists

pobierz

lista

combinedAudiences

pobierz

lista

customLists

pobierz

lista

firstAndThirdPartyAudiences

pobierz

lista

floodlightGroups

pobierz

poprawka

googleAudiences

pobierz

lista

inventorySourceGroups

pobierz

lista

inventorySources

pobierz

lista

partners.channels

pobierz

lista

partners.channels

pobierz

lista

9 marca 2020 r.

Wprowadziliśmy wersję 1 interfejsu Display & Video 360 API. To jest początkowa wersja interfejsu API.

Znane problemy

Brak.