Informacje o wersjach

Na tej stronie znajdziesz informacje o wersji dotyczące Interfejs Video 360 API.

Najnowsza wersja interfejsu API: 3

15 lipca 2024 r.

Nowe funkcje

Dodaliśmy obsługę pobierania plików uporządkowanych danych elementów zamówienia i grup reklam w Format kontroli jakości w wersji 3.

Wersja 3

17 czerwca 2024 r.

Nowe funkcje

Dodano obsługę zarządzania kierowaniem na słowa kluczowe na poziomie reklamodawcy.

Do zamówienia reklamowego dodano nowe pole optimizationObjective . Aplikacja optimizationObjective jest dostępna tylko dla klientów z białej listy.

Wersja 3

v2

30 maja 2024 r.

Nowe funkcje

Dodaliśmy obsługę plików uporządkowanych danych (SDF) w wersji 7.1.

Wersja 3

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    SdfVersion

    SDF_VERSION_7_1

v2

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    SdfVersion

    SDF_VERSION_7_1

23 kwietnia 2024 r.

Nowe funkcje

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

Wersja 3

  • Dodano te pola:

    ZasóbPola
    KPI

    kpiAlgorithmId

  • Dodaliśmy te wartości wyliczeniowe:

    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 użytkowników z list odbiorców kierowania na listę klientów.

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

Wersja 3

v2

29 stycznia 2024 r.

Nowe funkcje

Dodaliśmy możliwość pobierania aktywności Floodlight za pomocą nowego floodlightGroups.floodlightActivities.

Dodaliśmy nowe pole informujące, czy Element zamówienia typu „Partnerzy” uwzględnia w kierowaniu zasoby reklamowe Google TV.

Dodaliśmy nowe pole do przekazywania czasu ostatniego logowania na Film sferyczny użytkownika.

Wersja 3

v2

14 listopada 2023 r.

Nowe funkcje

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

Wersja 3

v2

31 października 2023 r.

Nowe funkcje

Przeniesienie wersji 3 z publicznej wersji beta i udostępnienie wszystkim użytkownikom.

W wersji 3 nazwa wartości wyliczenia AdGroupFormat została zmieniona na dokładniejszą mają odpowiedni format.

Dodaliśmy obsługę plików uporządkowanych danych w wersji 7 oraz Wartość enum SDF_VERSION_7 w wersjach 2 i 3.

Wersja 3

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

    Typ wyliczeniowyWartości
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    SdfVersion

    SDF_VERSION_7

2 października 2023 r.

Nowe funkcje

Opublikowaliśmy wersję 3 w publicznej wersji beta, która wprowadza te zmiany:

Wykonaj czynności opisane w naszym przewodniku po migracji, aby przejść z wersji 2 na wersję 2. wersja 3.

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

Wersja 3

v2

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    LineItemType

    LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

    LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

    PartnerCostType

    PARTNER_COST_TYPE_SCIBIDS_FEE

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

25 sierpnia 2023 r.

Nowe funkcje

Dodaliśmy obsługę dwóch giełd i dwóch nowych YouTube i Partnerzy strategie ustalania stawek.

Dodano nowe pole effectiveContentCategory do YouTube i Partnerzy, aby wyświetlać YoutubeAndPartnersContentCategory używany przez element zamówienia, gdy: z uwzględnieniem wartości przypisanych zarówno na poziomie reklamodawcy, jak i elementu zamówienia.

v2

5 czerwca 2023 r.

Nowe funkcje

Dodaliśmy nową wartość SdfVersion w przypadku plików uporządkowanych danych (SDF) wersja 6 w wersjach 1 i 2.

v2

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    SdfVersion

    SDF_VERSION_6

v1

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    SdfVersion

    SDF_VERSION_6

9 marca 2023 r.

Nowe funkcje

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

v2

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 lutego 2023 r.

Nowe funkcje

Dodano możliwość pobierania YouTubeAdGroup oraz Zasoby YouTubeAdGroupAd, a także grupa reklam w YouTube do kierowania na zasoby. Dodaliśmy również nowe dostępne typy kierowania stosowane w grupach reklam w YouTube; na poziomie 300%. Przeczytaj nową stronę przewodnika po pobieraniu treści z YouTube Partnerzy .

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

v2

v1

  • Dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    Giełda

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 grudnia 2022 r.

Nowe funkcje

Przeniesienie wersji 2 z publicznej wersji beta i udostępnienie wszystkim użytkownikom.

Do pola assignedTargetingOptionIdAlias dodaliśmy nowe pole AssignedTargetingOption, którego można użyć zamiast assignedTargetingOptionId przy pobieraniu i usuwaniu ustawień kierowania. To pole jest ustawione tylko dla przypisanych opcji kierowania typów kierowania, które są przypisywane przez wyliczenie. Wartość aliasu to odpowiednia wartość wyliczeniowa w formie ciągu znaków.

Do pola billingConfig dodaliśmy nowe pole Advertiser zasób.

Dodano obsługę pobierania treści z YouTube i elementy zamówienia Over-The-Top dla partnerów, oznaczone 3 nowymi wartościami LineItemType.

Zwiększyliśmy maksymalny rozmiar strony do 200 w przypadku wielu metod list w wersjach 1 i 2. domyślny rozmiar strony pozostaje bez zmian.

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 ramach elementu nadrzędnego. InsertionOrder.

Wprowadzono obsługę zapisu częściowego kierowania zamówień reklamowych dla podzbioru uwzględniające typy kierowania create oraz delete do advertisers.insertionOrders.targetingTypes.assignedTargetingOptions posprzedażna.

Nowe funkcje

v2

v1

W wersji 1 nie dodaliśmy żadnych nowych funkcji.

20 września 2022 r.

Opublikowaliśmy wersję 2 w publicznej wersji beta, która wprowadza te zmiany:

Wykonaj czynności opisane w naszym przewodniku po migracji, aby przejść z wersji 1 na wersję 1. wersja 2.

Dodaliśmy obsługę 3 nowych giełd w wersji 1.

Nowe funkcje

v2

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

v1

  • W wersji 1 dodaliśmy te wartości wyliczeniowe:

    Typ wyliczeniowyWartości
    Giełda

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 maja 2022 r.

Dodano możliwość tworzenia zasobów InventorySource oraz i zarządzaj zasobami w GuaranteedOrder za pomocą Metody zapisu usługi inventorySources oraz nowy guaranteedOrders.

Wprowadzenie pola modelReadiness w CustomBiddingAlgorithm zasób. To pole zawiera informacje o gotowości dla każdego reklamodawcy, który ma do niego dostęp.

Włączono nową funkcję parametrów zapytania filter dla: metoda advertisers.creatives.list, która pozwala użytkownikowi aby pobierać kreacje tylko z updateTime przed daną sygnaturą czasową lub po niej.

Dodaliśmy obsługę najnowszej wersji plików SDF (v5.5) dodanie wartości wyliczeniowej SdfVersion.

Nowe funkcje

31 marca 2022 r.

Dodano obsługę pobierania i ustawiania kierowania czas trwania treści, typ strumienia, oraz gatunek.

Pole billableOutcome zostało dodane do sekcji InsertionOrder obiektu.

Dodaliśmy pole raiseBidForDeals do MaximizeSpendBidStrategy, który pozwala użytkownikom określić, czy określanie stawek stosuje ceny minimalne reklamodawcy w umowach objętych kierowaniem.

Nowe funkcje

2 lutego 2022 r.

Dodaliśmy obsługę tworzenia, aktualizowania i edytowania członków określonych kierowania na listę klientów; FirstAndThirdPartyAudience materiały. Nowa strona Prześlij odbiorców z kierowania na listę klientów Szczegółowe informacje o korzystaniu z tych nowych funkcji znajdziesz w przewodniku Korzystanie z funkcji Odbiorcy.

Dodano nowe pole reservationType w: InsertionOrder i LineItem zasobów określających, czy zasób jest objęty gwarancją tagu, automatyzacją Gwarantowane lub niegwarantowane.

Dodano możliwość pobierania i określania, czy element zamówienia ma być automatycznie kierowany nowych giełd za pomocą nowej excludeNewExchanges .

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

Nowe funkcje

8 grudnia 2021 r.

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 kampanii należy dodać nową stronę Wdróż ustalanie stawek niestandardowych w przewodniku Zarządzanie elementami zamówienia, w którym opisano procesu tworzenia algorytmu ustalania stawek niestandardowych, przesyłania skryptu przez przypisanie algorytmu ustalania stawek niestandardowych jako strategii ustalania stawek elementu zamówienia.

Dodaliśmy obsługę najnowszej wersji plików SDF (v5.4) dodanie wartości wyliczeniowej SdfVersion.

Nowe funkcje

14 września 2021 r.

Dodano obsługę kierowania na zbliżony obszar w typach kierowania TARGETING_TYPE_BUSINESS_CHAIN i TARGETING_TYPE_POI.

Dodano możliwość wyszukiwania dostępnych TARGETING_TYPE_BUSINESS_CHAIN i TARGETING_TYPE_POI opcji kierowania za pomocą targetingTypes.targetingOptions.search, ponieważ nie mogą pobrane za pomocą funkcji targetingTypes.targetingOptions.get lub targetingTypes.targetingOptions.list.

Wprowadzenie nowych sharedAdvertiserIds i Pola customBiddingAlgorithmState do ustalania stawek niestandardowych Zasób algorytmu oraz dodanie obsługi GOAL_BUILDER_BASED Typ algorytmu ustalania stawek niestandardowych.

Do wyliczenia Exchange dodaliśmy 2 nowe wartości.

Nowe funkcje

4 sierpnia 2021 r.

Dodano obsługę włączonego pomiaru Open Measurement kierowania na zasoby reklamowe w ramach typu kierowania. TARGETING_TYPE_OMID.

Zwiększono maksymalną liczbę przypisanych opcji kierowania, które można zwrócić na jednej stronie różnych reklamodawców, kampanii zamówienie reklamowe i kierowanie przypisane do elementu zamówienia metod listy opcji za pomocą parametru metody pageSize.

Nowe funkcje

26 maja 2021 r.

Wprowadziliśmy usługę advertisers.invoices, która umożliwia użytkownicy:

  • Pobieranie faktur wystawionych reklamodawcy w danym miesiącu.
  • Wyszukiwanie kodu waluty używanej przez reklamodawcę w danym miesiącu.

Do kampanii dodano pole campaignBudgets . Segmenty budżetu zamówienia reklamowego można łączyć budżetu kampanii, ograniczając łączny budżet kampanii powiązanych segmentów do kwoty całkowitego budżetu kampanii.

Dodano obsługę: kierowanie na pozycję w natywnych treściach w ramach nowej typu kierowania TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Przedstawiliśmy reklamodawcy nowe pole prismaEnabled który umożliwia użytkownikom włączenie integracji z narzędziem Prisma firmy Mediaocean.

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

Nowe funkcje

29 kwietnia 2021 r.

Dodaliśmy nowe pola do sekcji Kanał oraz Zasoby listy wykluczających słów kluczowych, które zwracają liczbę wierszy elementy korzystające z zasobu do kierowania reklam. Włączono nową usługę filter właściwości metody listy elementów zamówienia, które umożliwiają użytkownikowi pobierają tylko elementy zamówienia, które korzystają z określonych kanałów lub wykluczających słów kluczowych w kierowaniu.

Nowe funkcje

30 marca 2021 r.

Do usługi elementu zamówienia dodaliśmy nową metodę, która generuje elementu zamówienia z konfiguracjami domyślnymi. Wartości domyślne są oparte na danego typu elementu zamówienia, a także ustawień i przypisanych dotyczące kierowania na nadrzędne zamówienie reklamowe.

Możliwość pobierania ustawień kierowania kampanii za pomocą nowej usługi kierowania kampanii dodatkową metodę tworzenia listy zbiorczej.

Rozszerzyliśmy kierowanie na aplikacje, by umożliwić kierowanie na aplikacje. na większej liczbie platform.

Wprowadziliśmy wiele zmian w advertisers.channels.sites. partners.channels.sites i advertisers.negativeKeywordLists.negativeKeywords usługi do ułatwiają zarządzanie treścią kanału i listy wykluczających słów kluczowych. Te zmiany obejmują:

  • Dodanie metod replace, które umożliwiają użytkownikowi pełne zastąpienie dotychczasowej zawartości kanału lub listy wykluczających słów kluczowych.
  • Usunięcie wymogu, zgodnie z którym żadne istniejące elementy, które mają być uwzględnione w createdSites lub createdNegativeKeywords pól edycji zbiorczej żądań.
  • Zwiększenie maksymalnej liczby produktów, które można zwrócić w ramach jednego produktu witryny na liście witryn lub wyświetl listę wykluczających słów kluczowych.

Nowe funkcje

Elementy wycofane

24 lutego 2021 r.

Wprowadzenie nowej usługi kierowania zamówień reklamowych oraz dodatkowa metoda przesyłania zbiorczego, która umożliwia pobieranie danych przypisane do zamówień reklamowych. Rozwinięto zasób kreacji, dodając pola kreacji tylko z danymi wyjściowymi do wykorzystania przez: zewnętrznych kreacji audio. Dodano nowe typy celów związanych ze skutecznością do wykorzystania w zamówieniu reklamowym i w kampanii i zasobami Google Cloud.

Nowe funkcje

27 stycznia 2021 r.

Możliwość pobierania telewizyjnych zamówień reklamowych i Over-The-Top oraz zarządzania nimi. dzięki wprowadzeniu nowe pole insertionOrderType oraz nową wartość wyliczeniową LineItemType. Dodano obsługę aplikacji mobilnych elementów zamówienia za pomocą pola mobileApp. Rozszerzona lista odbiorców Exchange, odbiorcy google Obsługa SDF przez dodatkowe wartości wyliczeniowe. Przedstawiamy możliwość filtrowania i porządkowania elementów advertisers.list według czasu ostatniej aktualizacji.

Nowe funkcje

Grudzień 4, 2020

Dodaliśmy możliwość wyszukiwania Opcje kierowania na region geograficzny i filtrowanie wielu zasobów tworzy listę wyników według czasu ostatniej aktualizacji. Wprowadzenie new LineItemOstrzeżenieMessage informujące użytkowników o tym, element zamówienia korzysta z wycofanego kierowania geograficznego.

Nowe funkcje

5 listopada 2020 roku

Dodano możliwość tworzenia, przypisywania i aktywowania reguł ręcznych, które inicjują powiązane elementy zamówienia pod kątem wydatków. Wprowadzenie opcji rozszerzania zasięgu kierowania, Po ustawieniu może rozszerzyć kierowanie elementu zamówienia o użytkowników podobnych do tych z grupy odbiorców. Pola identyfikatorów segmentów niestandardowych zostały dołączone do DoubleVerify i Integral Ad Science obiekty używane w kierowanie na weryfikację zewnętrzną.

Nowe funkcje

12 października 2020 r.

Wprowadzono do elementu zamówienia komunikaty z ostrzeżeniami, które można pobierać i typ celu dotyczącego współczynnika klikalności (CTR). Dodane warningMessages jako pole możliwe do filtrowania przy wyświetlaniu listy elementów zamówienia.

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

Nowe funkcje

28 sierpnia 2020 r.

Dodaliśmy nowe pola do odpowiedzi na metodę kontroli reklamodawcy oraz nowe pola możliwe do filtrowania przy użyciu różnych metod tworzenia list.

Nowe funkcje

4 sierpnia 2020 roku

Wprowadziliśmy nowe usługi zarządzania użytkownikami, partnerów i kierowania 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 korzystanie 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 małą 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, poprawiania i uzupełniania podzbioru elementów, na które można kierować reklamy, oraz dodaliśmy możliwość modyfikowania kierowania na poziomie reklamodawcy w przypadku 3 typów kierowania: kanału, wykluczenia etykiet treści cyfrowych i wykluczenia kategorii reklam o charakterze kontrowersyjnym.

Nowe funkcje

27 kwietnia 2020 r.

Udostępniliśmy duży zestaw funkcji, rozszerzając zakres interfejsu API poza pliki SDF. Dodane podstawowe zarządzanie zasobami, które umożliwia tworzenie, pobieranie, aktualizowanie i usuwanie elementów takich jak reklamodawcy, kampanie, zamówienia reklamowe, elementy zamówienia za pomocą kreacji. Nowe możliwości umożliwiają też edytowanie kierowania na poziomie elementu zamówienia.

Nowe funkcje

Te usługi zostały dodane:

UsługaMetody
reklamodawcy

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

Marzec 9, 2020

Wprowadzenie na rynek reklam displayowych Interfejs Video 360 API w wersji 1. To jest wstępna wersja interfejsu API.

Znane problemy

Brak.