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ób Pola Kpi Dodano te wartości enum:
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
Dodano te wartości enum:
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 członków z list odbiorców kierowania na listę klientów.
Dodaliśmy obsługę kierowania na nowe giełdy.
v3
Dodaliśmy te pola:
Zasób Pola firstAndThirdPartyAudiences.editCustomerMatchMembers Dodano te wartości enum:
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
Dodaliśmy te pola:
Zasób Pola firstAndThirdPartyAudiences.editCustomerMatchMembers Dodano te wartości enum:
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ą 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
Dodaliśmy te metody:
Usługa Metody floodlightGroups.floodlightActivities Dodaliśmy te pola:
Zasób Pola Użytkownik YoutubeAndPartnersInventorySourceConfig
v2
Dodaliśmy te metody:
Usługa Metody floodlightGroups.floodlightActivities Dodaliśmy 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 list odbiorców z kierowania na listę klientów we wszystkich aktywnych wersjach.
v3
Dodaliśmy te pola:
Zasób Pola ContactInfoList MobileDeviceIdList
v2
Dodaliśmy te pola:
Zasób Pola ContactInfoList MobileDeviceIdList
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 wyliczeniowy Wartości AdGroupFormat AD_GROUP_FORMAT_ACTION
Dodano te wartości enum:
Typ wyliczeniowy Wartości AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Dodano te wartości enum:
Typ wyliczeniowy Wartoś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:
- Możliwość pełnego zarządzania listami pobliskich lokalizacji, co umożliwia korzystanie z usługi
advertisers.locationLists.assignedLocations
do tworzenia i usuwania lokalizacji przypisanych do zasobówTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. - Nowe pole wartości logicznej
enableOptimizedTargeting
, które zastępuje poletargetingExpansionLevel
w obiekcieTargetingExpansionConfig
. - Wymagania dotyczące pola
billingConfig
w zasobieAdvertiser
, które należy uwzględnić podczas tworzenia żądańadvertisers.create
, oraz nowego polabillingConfig
w zasobiePartner
. - Nowe zasoby
AdGroup
iAdGroupAd
, które zastępują zasobyYoutubeAdGroup
iYoutubeAdGroupAd
w wersji 2.
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
Dodaliśmy te metody:
Usługa Metody advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules create (utwórz)
Usunęliśmy te metody:
Usługa Metody advertisers.manualTriggers aktywuj
create
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 Obsługuje teraz tworzenie TARGETING_LOCATION_TYPE_PROXIMITY
zasobów typuLocationList
.advertisers.locationLists.patch Teraz obsługuje aktualizowanie TARGETING_LOCATION_TYPE_PROXIMITY
zasobów typuLocationList
.advertisers.locationLists.assignedLocations.bulkEdit Umożliwia teraz zbiorczą edycję zasobów AssignedLocation
wTARGETING_LOCATION_TYPE_PROXIMITY
zasobachLocationList
.advertisers.locationLists.assignedLocations.create Obsługuje teraz tworzenie zasobów typu AssignedLocation
wTARGETING_LOCATION_TYPE_PROXIMITY
zasobachLocationList
.Dodaliśmy te parametry zapytania:
Metoda Parametry inventorySources.get Te pola są wymagane:
Zasób Pola Reklamodawca Dodaliśmy te pola:
Zasób Pola BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Te pola zostały usunięte:
Zasób Pola InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Dodano te wartości enum:
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 enum:
Typ wyliczeniowy Wartości LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Dodano te wartości enum:
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ę 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
Dodaliśmy te pola:
Zasób Pola YoutubeAndPartnersSettings Te pola zostały usunięte:
Zasób Pola InventorySource subSitePropertyId
Dodano te wartości enum:
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
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 wyliczeniowy Wartości SdfVersion SDF_VERSION_6
v1
Dodano te wartości enum:
Typ wyliczeniowy Wartoś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 wyliczeniowy Wartości LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Dodano te wartości enum:
Typ wyliczeniowy Wartoś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
Dodaliśmy te metody:
Usługa Metody advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Dodaliśmy te pola:
Usługa Metody AssignedTargetingOption YoutubeAndPartnersSettings Dodano te wartości enum:
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
Dodano te wartości enum:
Typ wyliczeniowy Wartoś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
Dodaliśmy te pola:
Zasób Pola Reklamodawca AssignedTargetingOption Dodano te wartości enum:
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
Maksymalny rozmiar strony został zwiększony dla następujących metod tworzenia listy:
v1
Maksymalny rozmiar strony został zwiększony dla następujących metod tworzenia listy:
Znane problemy
Ta aktualizacja rozwiązuje następujące znane problemy w wersji 2:
- Przypisanych opcji kierowania w typach kierowania przypisanych za pomocą wartości wyliczeniowych w wersji 2 nie udało się usunąć ani pobrać za pomocą parametru
assignedTargetingOptionId
. Zamiast tego użytkownicy powinni używać wartości enum. Dzięki tej aktualizacji te przypisane opcje kierowania można usuwać lub pobierać za pomocą wartościassignedTargetingOptionId
lub wartości enum określonej przez nowe poleassignedTargetingOptionIdAlias
w zasobieAssignedTargetingOption
. - Żądanie dotyczące elementu zamówienia
bulkUpdate
nie korzystało prawidłowo z parametru żądaniaadvertisersId
, co spowodowało błąd. W ramach tej aktualizacji metoda została naprawiona, a nazwa parametru żądania została zmieniona zadvertisersId
naadvertiserId
.
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
Dodaliśmy te metody:
Usługa Metody advertisers.insertionOrders.targetingTypes.assignedTargetingOptions create (utwórz)
advertisers.lineItems
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:
- Możliwość pobierania elementów zamówienia typu YouTube i sieć partnerów wideo Google oraz ich ustawień kierowania za pomocą metod
get
ilist
w usługachadvertisers.lineItems
iadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Dwie nowe metody kierowania zbiorczego w usłudze
advertisers.lineItems
, które umożliwiają edytowanie i pobieranie przypisanych ustawień kierowania do wielu elementów zamówienia w ramach jednego żądania. - Nowa metoda
bulkUpdate
, która umożliwia użytkownikom aktualizowanieentityStatus
wielu elementów zamówienia w ramach jednego żądania. - Nowa logika kierowania, która wymaga przypisania i pobierania zasobów
AssignedTargetingOption
podzbioru typów kierowania za pomocą wartości wyliczeniowych zamiast identyfikatorów opcji kierowania pobranych za pomocą usługitargetingTypes.targetingOptions
.
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:
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 nazwy tych metod zostały zmienione:
Usługa Stara nazwa metody Nowa nazwa metody reklamodawcy, bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Zasoby
AssignedTargetingOption
należące do tych typów kierowania używają wyliczeń do przypisywania kierowania w wersji 2. W wersji 2 poleassignedTargetingOptionId
zasobówAssignedTargetingOption
tych typów kierowania zostało też zaktualizowane tak, aby używało wersji ciągów 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 dodano te pola:
W wersji 2 usunęliśmy te pola:
W wersji 2 te pola są wymagane:
W wersji 2 dodano 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 enum:
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 dodano te wartości wyliczeniowe:
Typ wyliczeniowy Wartoś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
Dodaliśmy te metody:
Usługa Metody guaranteedOrders create (utwórz)
inventorySources create (utwórz)
Dodaliśmy te pola:
Zasób Pola CustomBiddingAlgorithm InventorySource Dodano te wartości enum:
Typ wyliczeniowy Wartości SdfVersion Metody filtrowania można teraz filtrować według tych właściwości:
Metoda Pola advertisers.creatives.list
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
Dodaliśmy te pola:
Zasób Pola AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Dodano te wartości enum:
Typ wyliczeniowy Wartości TargetingType
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
Dodaliśmy te metody:
Usługa Metody firstAndThirdPartyAudiences create (utwórz)
Dodaliśmy te pola:
Zasób Pola FirstAndThirdPartyAudience InsertionOrder LineItem
Grudzień 8, 2021
Dodaliśmy obsługę kierowania na typ treści audio w ramach typu kierowania TARGETING_TYPE_AUDIO_CONTENT_TYPE
.
Nowe funkcje
Dodaliśmy te pola:
Zasób Pola AssignedTargetingOption TargetingOption Dodano te wartości enum:
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.:
- Funkcje do tworzenia i aktualizowania istniejących
customBiddingAlgorithms
. - Możliwość przesyłania skryptów w ramach procesu pobierania dostępnej lokalizacji zasobów, a potem przesyłania pliku do tej lokalizacji.
- Nowa usługa
customBiddingAlgorithms.scripts
do pobierania i tworzeniacustomBiddingScripts
.
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
Dodaliśmy te metody:
Usługa Metody customBiddingAlgorithms create (utwórz)
customBiddingAlgorithms.scripts create (utwórz)
media Dodano te wartości enum:
Typ wyliczeniowy Wartości SdfVersion
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
Dodaliśmy te pola:
Zasób Pola AssignedTargetingOption CustomBiddingAlgorithm TargetingOption KierowanieOptions.search Treść żądania Dodano te wartości enum:
Typ wyliczeniowy Wartości CustomBiddingAlgorithmType Giełda TargetingType Metody filtrowania można teraz filtrować według tych właściwości:
Metoda Pola customBiddingAlgorithms.list
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
Dodaliśmy te pola:
Zasób Pola AssignedTargetingOption TargetingOption Dodano te wartości enum:
Typ wyliczeniowy Wartości TargetingType Maksymalny rozmiar strony został zwiększony dla następujących metod tworzenia listy:
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
Dodaliśmy te metody:
Usługa Metody advertisers.invoices Dodaliśmy te pola:
Zasób Pola Reklamodawca AssignedTargetingOption TargetingOption Dodano te wartości enum:
Typ wyliczeniowy Wartości AssignedTargetingOption.Recency Giełda TargetingType Następujące wartości wyliczeniowe są teraz prawidłowe w następujących polach:
Zasób Pole Wartości Reklamodawca entityStatus ENTITY_STATUS_PAUSED
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
Dodaliśmy te pola:
Zasób Pola Kanał Metody filtrowania 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 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
anicreatedNegativeKeywords
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
Dodaliśmy te metody:
Dodaliśmy te pola:
Zasób Pola AssignedTargetingOption.AppAssignedTargetingOptionDetails Maksymalny rozmiar strony został zwiększony dla następujących metod tworzenia listy:
Metoda Stary 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 wyliczeniowych 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.
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
Dodaliśmy te metody:
Usługa Metody advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Dodaliśmy te pola:
Zasób Pola Kreacja Dodano te wartości enum:
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.
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
Dodaliśmy te pola:
Zasób Pola InsertionOrder LineItem Dodano te wartości enum:
Typ wyliczeniowy Wartości Giełda GoogleAudienceType LineItemType SdfVersion Następujące metody list można teraz sortować i filtrować według tych pól:
Metoda Pola reklamodawców
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
Dodaliśmy te metody:
Usługa Metody targetingTypes.targetingOptions Dodano te wartości enum:
Typ wyliczeniowy Wartości Giełda LineItemWarningMessage Następujące metody list można teraz sortować i filtrować według tych pól:
Metoda Pola advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
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
Dodaliśmy te usługi:
Usługa Metody advertisers.manualTriggers Dodaliśmy te pola:
Zasób Pola AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Dodano te wartości enum:
Typ wyliczeniowy Wartości LineItemFlightDateType Metody wyświetlania listy można teraz filtrować według tych pól:
Metoda Pola advertisers.lineItems.list
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
Dodaliśmy te pola:
Zasób Pola LineItem Dodano te wartości enum:
Typ wyliczeniowy Wartości PerformanceGoalType Metody wyświetlania listy można teraz filtrować według tych pól:
Metoda Pola advertisers.lineItems.list
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
Dodaliśmy te pola:
Zasób Pola Reklamodawcy.Treść odpowiedzi na audyt Metody wyświetlania listy 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 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
Dodaliśmy te usługi:
Usługa Metody customBiddingAlgorithms partnerzy partners.targetingTypes.assignedTargetingOptions użytkowników Dodaliśmy te metody:
Usługa Metody reklamodawców Dodaliśmy te pola:
Zasób Pola MaximizeSpendBidStrategy PerformanceGoalBidStrategy Dodano te wartości enum:
Typ wyliczeniowy Wartości BiddingStrategyPerformanceGoalType LineItemType Następujące metody list można teraz sortować i filtrować według tych pól:
Metoda Pola advertisers.lineItems.list Dodaliśmy zakresy do tych usług:
Zakres Usługi https://www.googleapis.com/auth/display-video-user-management
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
Dodaliśmy te usługi:
Usługa Metody advertisers.channels partners.channels Dodaliśmy te pola:
Zasób Pola FirstAndThirdPartyAudience Dodano te wartości enum:
Typ wyliczeniowy Wartości Giełda Metody wyświetlania listy można teraz filtrować według tych pól:
Metoda Pola advertisers.creatives.list
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
Dodaliśmy te usługi:
Dodaliśmy te metody:
Usługa Metody reklamodawców advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Dodaliśmy te pola:
Zasób Pola reklamodawca kreacja insertionOrder.insertionOrderBudgetSegment
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:
9 marca 2020 r.
Wprowadziliśmy wersję 1 interfejsu Display & Video 360 API. To jest początkowa wersja interfejsu API.
Znane problemy
Brak.