Na tej stronie znajdziesz informacje o wersji dotyczące Interfejs Video 360 API.
Najnowsza wersja interfejsu API: 3
15 sierpnia 2024 r.
Nowe funkcje
Dodano obsługę typu Netflix Exchange
.
Wersja 3
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda EXCHANGE_NETFLIX
v2
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda EXCHANGE_NETFLIX
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
Dodano te pola:
Zasób Pola IdFilter Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
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
Dodano te pola:
Zasób Pola InsertionOrder Poniższe metody obsługują teraz następujące typy kierowania:
v2
Poniższe metody obsługują teraz następujące typy kierowania:
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 wyliczeniowy Wartości SdfVersion SDF_VERSION_7_1
v2
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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ób Pola KPI Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Giełda EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
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
Dodano te pola:
Zasób Pola firstAndThirdPartyAudiences.editCustomerMatchMembers Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Dodano te pola:
Zasób Pola firstAndThirdPartyAudiences.editCustomerMatchMembers Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
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 urządzenie Display & Film sferyczny użytkownika.
Wersja 3
Dodaliśmy te metody:
Usługa Metody floodlightGroups.floodlightActivities Dodano te pola:
Zasób Pola Użytkownik YoutubeAndPartnersInventorySourceConfig
v2
Dodaliśmy te metody:
Usługa Metody floodlightGroups.floodlightActivities Dodano te pola:
Zasób Pola Użytkownik YoutubeAndPartnersInventorySourceConfig
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
Dodano te pola:
Zasób Pola ContactInfoList MobileDeviceIdList
v2
Dodano te pola:
Zasób Pola ContactInfoList MobileDeviceIdList
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 wyliczeniowy Wartości AdGroupFormat AD_GROUP_FORMAT_ACTION
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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:
- Możliwość pełnego zarządzania listami lokalizacji przybliżonych,
Usługa
advertisers.locationLists.assignedLocations
do utworzenia i usuń lokalizacje przypisane do użytkownikaTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
– materiały. - nowe pole
enableOptimizedTargeting
z wartością logiczną, zastępuje poletargetingExpansionLevel
wTargetingExpansionConfig
. - wymaganie z pola
billingConfig
w poluAdvertiser
, który musi być uwzględniony przy tworzeniuadvertisers.create
próśb oraz nowybillingConfig
w poluPartner
. - Nowe materiały na temat
AdGroup
iAdGroupAd
, które zastąpi zasobyYoutubeAdGroup
iYoutubeAdGroupAd
w wersji 2.
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
Dodaliśmy te metody:
Usługa Metody advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Usunęliśmy te metody:
Usługa Metody advertisers.manualTriggers aktywuj
utwórz
dezaktywuj
get
lista
patch
advertisers.youtubeAdGroupAds get
lista
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
lista
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
lista
Zmieniło się działanie tej metody:
Metoda Zmiany advertisers.locationLists.create Teraz obsługuje tworzenie TARGETING_LOCATION_TYPE_PROXIMITY
zasobów typuLocationList
.advertisers.locationLists.patch Teraz obsługuje aktualizowanie zasobów typu LocationList
(TARGETING_LOCATION_TYPE_PROXIMITY
).advertisers.locationLists.assignedLocations.bulkEdit Teraz obsługuje edycję zbiorczą zasobów AssignedLocation
wTARGETING_LOCATION_TYPE_PROXIMITY
zasobachLocationList
.advertisers.locationLists.assignedLocations.create Teraz można tworzyć zasoby AssignedLocation
wTARGETING_LOCATION_TYPE_PROXIMITY
zasobachLocationList
.Dodano te parametry zapytania:
Metoda Parametry inventorySources.get Te pola zostały wypełnione:
Zasób Pola Reklamodawca Dodano te pola:
Zasób Pola BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Usunęliśmy te pola:
Zasób Pola InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości CustomBiddingAlgorithmType RULE_BASED
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
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Usunęliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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
Dodano te pola:
Zasób Pola YoutubeAndPartnersSettings Usunęliśmy te pola:
Zasób Pola InventorySource subSitePropertyId
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
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 wyliczeniowy Wartości SdfVersion SDF_VERSION_6
v1
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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 wyliczeniowy Wartości LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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
Dodaliśmy te metody:
Usługa Metody advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Dodano te pola:
Usługa Metody AssignedTargetingOption YoutubeAndPartnersSettings Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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
Dodano te pola:
Zasób Pola Reklamodawca AssignedTargetingOption Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
Zwiększyliśmy maksymalny rozmiar strony w przypadku tych metod tworzenia listy:
v1
Zwiększyliśmy maksymalny rozmiar strony w przypadku tych metod tworzenia listy:
Znane problemy
Ta aktualizacja rozwiązuje następujące znane problemy w wersji 2:
- Przypisane opcje kierowania typów kierowania przypisanych na podstawie wyliczenia
nie udało się usunąć ani pobrać wartości w wersji 2
używający
assignedTargetingOptionId
i oczekiwano do użycia wartości wyliczeniowej. Po tej aktualizacji przypisane kryteria kierowania można usunąć lub pobrać za pomocąassignedTargetingOptionId
lub wartość wyliczenia identyfikowana przez nowe poleassignedTargetingOptionIdAlias
wAssignedTargetingOption
zasób. - Żądanie dotyczące elementu zamówienia
bulkUpdate
nieprawidłowo korzystało z parametr żądaniaadvertisersId
, który zwraca błąd. Dzięki tej aktualizacji metoda została naprawiona, a nazwa parametru żądania została zmieniona zadvertisersId
doadvertiserId
.
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
Dodaliśmy te metody:
Usługa Metody advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
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:
- Możliwość pobierania filmów z YouTube i Elementy zamówienia typu „Partnerzy” i ich kierowanie
ustawienia za pomocą metod
get
ilist
wadvertisers.lineItems
iadvertisers.lineItems.targetingTypes.assignedTargetingOptions
usług. - Dwie nowe metody kierowania zbiorczego w usłudze
advertisers.lineItems
które umożliwiają edytowanie i pobieranie przypisanego kierowania do wielu elementów zamówienia ze tylko jedno żądanie. - Nowa metoda
bulkUpdate
, która umożliwia użytkownikom aktualizowanieentityStatus
z kilku elementów zamówienia w jednym żądaniu. - Nowa logika kierowania wymagająca
AssignedTargetingOption
zasobów podzbioru typów kierowania, przypisane i pobrane za pomocą wartości wyliczeniowych zamiast identyfikatorów opcji kierowania pobrane przy użyciu usługitargetingTypes.targetingOptions
.
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:
W wersji 2 dodaliśmy te metody:
Usługa Metody advertisers.lineItems bulkEditAssignedTargetingOptions
W wersji 2 usunęliśmy te metody:
Usługa Metody advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
W wersji 2 zmieniły się nazwy tych metod:
Usługa Stara nazwa metody Nowa nazwa metody reklamodawców bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partnerzy bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Zasoby
AssignedTargetingOption
tych typów kierowania używają wyliczeniowych do przypisywania kierowania w wersji 2. PoleassignedTargetingOptionId
zasobówAssignedTargetingOption
tych typów kierowania zostało też zaktualizowane w wersji 2, aby obejmowało wersje ciągu znaków wartości wyliczeniowej:Typ kierowania Typ wyliczenia TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Środowisko TARGETING_TYPE_EXCHANGE Giełda TARGETING_TYPE_GENDER Płeć TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Widoczność W wersji 2 dodaliśmy te pola:
W wersji 2 usunęliśmy te pola:
W wersji 2 wymagane są te pola:
W wersji 2 dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Giełda EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
W wersji 2 usunęliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
W wersji 1 dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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
Dodaliśmy te metody:
Usługa Metody guaranteedOrders inventorySources Dodano te pola:
Zasób Pola CustomBiddingAlgorithm InventorySource Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości SdfVersion Te metody można teraz filtrować według tych właściwości:
Metoda Pola advertisers.creatives.list
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
Dodano te pola:
Zasób Pola AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości TargetingType
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
Dodaliśmy te metody:
Usługa Metody firstAndThirdPartyAudiences Dodano te pola:
Zasób Pola FirstAndThirdPartyAudience InsertionOrder LineItem
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
Dodano te pola:
Zasób Pola AssignedTargetingOption TargetingOption Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości TargetingType
8 listopada 2021 r.
Dodaliśmy pełną obsługę zarządzania algorytmami ustalania stawek niestandardowych i ich skryptami. Obejmuje to m.in.:
- funkcji do tworzenia nowych i aktualizowania istniejących;
customBiddingAlgorithms
- Możliwość przesyłania skryptów przez proces pobieranie dostępnej lokalizacji zasobu, a następnie przesyłając plik do tej lokalizacji.
- nową usługę
customBiddingAlgorithms.scripts
do pobrać i utworzyćcustomBiddingScripts
.
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
Dodaliśmy te metody:
Usługa Metody customBiddingAlgorithms customBiddingAlgorithms.scripts multimedia, Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości SdfVersion
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
Dodano te pola:
Zasób Pola AssignedTargetingOption CustomBiddingAlgorithm TargetingOption TargetingOptions.search Treść żądania Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości CustomBiddingAlgorithmType Giełda TargetingType Te metody można teraz filtrować według tych właściwości:
Metoda Pola customBiddingAlgorithms.list
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
Dodano te pola:
Zasób Pola AssignedTargetingOption TargetingOption Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości TargetingType Zwiększyliśmy maksymalny rozmiar strony w przypadku tych metod tworzenia listy:
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
Dodaliśmy te metody:
Usługa Metody advertisers.invoices Dodano te pola:
Zasób Pola Reklamodawca AssignedTargetingOption TargetingOption Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości AssignedTargetingOption.Recency Giełda TargetingType W tych polach są teraz prawidłowe wartości wyliczeniowe:
Zasób Pole Wartości Reklamodawca entityStatus ENTITY_STATUS_PAUSED
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
Dodano te pola:
Zasób Pola Kanał Te metody można teraz filtrować według tych właściwości:
Metoda Pola advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
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
lubcreatedNegativeKeywords
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
Dodaliśmy te metody:
Dodano te pola:
Zasób Pola AssignedTargetingOption.AppAssignedTargetingOptionDetails Zwiększyliśmy maksymalny rozmiar strony w przypadku tych metod tworzenia listy:
Metoda Poprzedni maksymalny rozmiar strony Nowy maksymalny rozmiar strony advertisers.channels.sites.list 100 10 tys. advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10 tys.
Elementy wycofane
Tych wartości enum nie można już przypisywać do nowych ani istniejących zasobów:
Typ wyliczeniowy Wartości PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
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
Dodaliśmy te metody:
Usługa Metody advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Dodano te pola:
Zasób Pola Kreacja Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
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
Dodano te pola:
Zasób Pola InsertionOrder LineItem Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda GoogleAudienceType LineItemType SdfVersion Sortowanie i filtrowanie według tych pól jest teraz możliwe w przypadku tych metod:
Metoda Pola reklamodawcy
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
Dodaliśmy te metody:
Usługa Metody targetingTypes.targetingOptions Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda LineItemWarningMessage Sortowanie i filtrowanie według tych pól jest teraz możliwe w przypadku tych metod:
Metoda Pola advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
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
Te usługi zostały dodane:
Usługa Metody advertisers.manualTriggers Dodano te pola:
Zasób Pola AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości LineItemFlightDateType Te metody można teraz filtrować według tych pól:
Metoda Pola advertisers.lineItems.list
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
Dodano te pola:
Zasób Pola LineItem Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości PerformanceGoalType Te metody można teraz filtrować według tych pól:
Metoda Pola advertisers.lineItems.list
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
Dodano te pola:
Zasób Pola Reklamodawcy.Treść odpowiedzi na audyt Te metody można teraz filtrować według tych pól:
Metoda Pola advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
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
Te usługi zostały dodane:
Usługa Metody customBiddingAlgorithms partnerów partners.targetingTypes.assignedTargetingOptions użytkownicy Dodaliśmy te metody:
Usługa Metody reklamodawcy Dodano te pola:
Zasób Pola MaximizeSpendBidStrategy PerformanceGoalBidStrategy Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości BiddingStrategyPerformanceGoalType LineItemType Sortowanie i filtrowanie według tych pól jest teraz możliwe w przypadku tych metod:
Metoda Pola advertisers.lineItems.list Te zakresy zostały dodane do wykorzystania w tych usługach:
Zakres Usługi https://www.googleapis.com/auth/display-video-user-management
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
Te usługi zostały dodane:
Usługa Metody advertisers.channels partners.channels Dodano te pola:
Zasób Pola FirstAndThirdPartyAudience Dodaliśmy te wartości wyliczeniowe:
Typ wyliczeniowy Wartości Giełda Te metody można teraz filtrować według tych pól:
Metoda Pola advertisers.creatives.list
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
Te usługi zostały dodane:
Dodaliśmy te metody:
Usługa Metody reklamodawcy advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Dodano te pola:
Zasób Pola reklamodawcy kreacji insertionOrder.insertionOrderBudgetSegment
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:
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.