Informacje o wersjach

Ta strona zawiera informacje o wersji interfejsu Display & Video 360 API.

Najnowsza wersja interfejsu API: 3

4 grudnia 2024 r.

Nowe funkcje

Dodaliśmy obsługę wartości Core i Tubi Exchange.

Zwiększyliśmy maksymalny dopuszczalny rozmiar strony w firstAndThirdPartyAudiences.list z 200 na 5000. Aby jeszcze bardziej zoptymalizować wykorzystanie limitu, zaktualizuj parametr pageSize w żądaniach firstAndThirdPartyAudiences.list.

Wersja 3

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• Maksymalny rozmiar strony został zwiększony w przypadku tych metod list:

  Metoda	Nowy maksymalny rozmiar strony
  firstAndThirdPartyAudiences.list	5000

22 października 2024 r.

Nowe funkcje

Dodaliśmy obsługę celu skuteczności „Koszt obejrzenia”.

Dodaliśmy możliwość ustawiania i pobierania kierowania na połączone urządzenia.

Dodaliśmy nowe ustawienia bezpieczeństwa marki Adloox w sekcji Ukierunkowanie weryfikatora zewnętrznego.

Dodaliśmy obsługę pobierania plików uporządkowanych wersji 8, które są obecnie w zamkniętej wersji beta.

Wersja 3

• Dodano następujące pola:

  Obiekt

  Pola

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

Wycofane wartości

Wycofano obsługę formatu SDF w wersji 5.5, ponieważ zostanie on wycofany 3 października 2024 roku.

Wersja 3

• Wycofane zostały te wartości wyliczenia:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_5_5

15 sierpnia 2024 r.

Nowe funkcje

Dodaliśmy obsługę typu Exchange Netflix.

Wersja 3

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_NETFLIX

v2

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_NETFLIX

15 lipca 2024 r.

Nowe funkcje

W wersji 3 dodaliśmy obsługę pobierania plików uporządkowanych danych elementu zamówienia i grupy reklam w formacie QA.

Wersja 3

• Dodano następujące pola:

  Zasób	Pola
  IdFilter	adGroupQaIds lineItemQaIds

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

17 czerwca 2024 r.

Nowe funkcje

Dodaliśmy obsługę zarządzania kierowaniem na słowa kluczowe przypisanym na poziomie reklamodawcy.

Dodano nowe pole optimizationObjective do zasobu zamówienia reklamowego. Usługa optimizationObjective jest dostępna tylko dla klientów z białej listy.

Wersja 3

• Dodano następujące pola:

  Zasób	Pola
  InsertionOrder	optimizationObjective

• Te metody obsługują teraz te typy kierowania:

  Typ kierowania	Metody
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• Te metody obsługują teraz te typy kierowania:

  Typ kierowania	Metody
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

30 maja 2024 r.

Nowe funkcje

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

Wersja 3

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_7_1

v2

• Dodano te wartości enum:

  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 następujące pola:

  Zasób	Pola
  KPI	kpiAlgorithmId

• 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ść wyraźnego usuwania użytkowników z list odbiorców kierowanych na listę klientów.

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

Wersja 3

• Dodano następujące pola:

  Zasób	Pola
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• 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

• Dodano następujące pola:

  Zasób	Pola
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• 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

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

Dodaliśmy nowe pole, które informuje, czy element zamówienia typu YouTube i sieć partnerów wideo Google uwzględnia w kierowaniu zasoby reklamowe Google TV.

Dodaliśmy nowe pole, w którym zapisywany jest czas ostatniego logowania użytkownika Display & Video 360.

Wersja 3

• Dodano te metody:

  Usługa	Metody
  floodlightGroups.floodlightActivities	get list

• Dodano te pola:

  Zasób	Pola
  Użytkownik	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Dodano te metody:

  Usługa	Metody
  floodlightGroups.floodlightActivities	get list

• Dodano następujące pola:

  Zasób	Pola
  Użytkownik	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

14 listopada 2023 r.

Nowe funkcje

Dodaliśmy obsługę przekazywania zgody użytkownika końcowego podczas przesyłania list odbiorców na podstawie dopasowania do klientów we wszystkich wersjach docelowych.

Wersja 3

• Dodano następujące pola:

  Zasób	Pola
  ContactInfoList	consent
  MobileDeviceIdList	consent

v2

• Dodano następujące pola:

  Zasób	Pola
  ContactInfoList	zgodę.
  MobileDeviceIdList	zgodę.

31 października 2023 r.

Nowe funkcje

Wersja 3. została wycofana z publicznej wersji beta i udostępniona ogólnie.

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

Dodano obsługę plików danych strukturalnych w wersji 7 z dodatkiem wartości enumeracji SDF_VERSION_7 w wersjach 2 i 3.

Wersja 3

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

  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

Udostępniliśmy wersję 3 w wersji publicznej beta, która zawiera te zmiany:

• Możliwość pełnego zarządzania listami lokalizacji zbliżonych, umożliwiająca korzystanie z usługi advertisers.locationLists.assignedLocations do tworzenia i usuwania lokalizacji przypisanych do zasobów TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• nowe pole logiczne enableOptimizedTargeting, które zastępuje pole targetingExpansionLevel w obiekcie TargetingExpansionConfig;
• Wymaganie pola billingConfig w zasobie Advertiser, które musi być uwzględnione podczas wysyłania żądań advertisers.create, oraz nowe pole billingConfig w zasobie Partner.
• Nowe zasoby AdGroup i AdGroupAd, które zastępują zasoby YoutubeAdGroup i YoutubeAdGroupAd w wersji 2.

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

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

Wersja 3

• Dodano te metody:

  Usługa	Metody
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create (utwórz) get list

• 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 tych metod:

  Metoda	Zmiana
  advertisers.locationLists.create	Obsługa tworzenia zasobów TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.patch	Aktualizacja zasobów TARGETING_LOCATION_TYPE_PROXIMITY LocationList jest teraz obsługiwana.
  advertisers.locationLists.assignedLocations.bulkEdit	Zasoby AssignedLocation w zasobach TARGETING_LOCATION_TYPE_PROXIMITY LocationList można teraz edytować zbiorczo.
  advertisers.locationLists.assignedLocations.create	Usługa obsługuje teraz tworzenie zasobów AssignedLocation w zasobach TARGETING_LOCATION_TYPE_PROXIMITY LocationList.

• Dodano te parametry zapytania:

  Metoda	Parametry
  inventorySources.get	advertiserId

• Te pola stały się wymagane:

  Zasób	Pola
  Reklamodawca	billingConfig

• Dodano następujące pola:

  Zasób	Pola
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  Partner	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• Usunęliśmy te pola:

  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 wyliczenia:

  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 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ści YoutubeAndPartnersContentCategory używane przez element zamówienia podczas uwzględniania wartości przypisanych na poziomie reklamodawcy i elementu zamówienia.

v2

• Dodano następujące pola:

  Zasób	Pola
  YoutubeAndPartnersSettings	effectiveContentCategory

• Usunęliśmy te pola:

  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

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

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

Dodano nową wartość LineItemWarningMessage, która zostanie przypisana do pola warningMessages elementu zamówienia, jeśli pole excludeFirstPartyAudience ma wartość true. Po 25 marca 2023 r. wycofamy pole excludeFirstPartyAudience i ustawimy je 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

Dodano możliwość pobierania zasobów YouTubeAdGroup i YouTubeAdGroupAd, a także kierowanie na zasoby grupy reklam w YouTube. Dodaliśmy też nowe typy kierowania, które można odzyskać, i które są używane na poziomie grup reklam w YouTube. Więcej informacji znajdziesz na nowej stronie z przewodnikiem po zasobach YouTube i partnerów wideo Google.

Dodano obsługę 4 dodatkowych giełd w wersjach 1 i 2.

v2

• Dodano te metody:

  Usługa	Metody
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Dodano następujące pola:

  Usługa	Metody
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• 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 ogólnie.

Do zasobu AssignedTargetingOption dodaliśmy nowe pole assignedTargetingOptionIdAlias, które można używać zamiast pola assignedTargetingOptionId podczas pobierania i usuwania kierowania. To pole jest ustawiane tylko w przypadku przypisanych opcji kierowania o typach przypisanych za pomocą enumeracji. Wartość aliasu to odpowiednia wartość typu enum jako ciąg znaków.

Do zasobu Advertiser dodano nowe pole billingConfig.

Dodano obsługę pobierania elementów zamówienia typu YouTube i sieć partnerów wideo Google, które są identyfikowane przez 3 nowe wartości 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 następujące pola:

  Zasób	Pola
  Reklamodawca	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• 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 w przypadku tych metod list:

  Metoda	Nowy maksymalny rozmiar strony
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

• Maksymalny rozmiar strony został zwiększony w przypadku tych metod list:

  Metoda	Nowy maksymalny rozmiar strony
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

Znane problemy

Ta aktualizacja rozwiązuje te znane problemy w wersji 2:

• Przypisane opcje kierowania o typach kierowania przypisanych za pomocą wartości z użyciem listy w wersji 2 nie można było usunąć ani pobrać za pomocą parametru assignedTargetingOptionId. Zamiast tego użytkownicy mieli używać wartości z użyciem listy. Dzięki tej aktualizacji przypisane opcje kierowania można usunąć lub pobrać, korzystając z ustawienia assignedTargetingOptionId lub wartości wyliczanej zidentyfikowanej przez nowe pole assignedTargetingOptionIdAlias w zasobie AssignedTargetingOption.
• Żądanie elementu zamówienia bulkUpdate nie używało prawidłowo parametru advertisersId, więc zwróciło błąd. W tej aktualizacji naprawiliśmy metodę i zmieniliśmy nazwę parametru żądania z advertisersId na advertiserId.

27 października 2022 r.

Dodaliśmy możliwość powielania istniejącego elementu zamówienia w elemencie nadrzędnymInsertionOrder.

Wprowadziliśmy obsługę zapisu w ramach częściowego kierowania zamówienia reklamowego na podstawie typu kierowania. Do usługi advertisers.insertionOrders.targetingTypes.assignedTargetingOptions dodaliśmy metody create i delete.

Nowe funkcje

v2

• Dodano te metody:

  Usługa	Metody
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create (utwórz) usuń
  advertisers.lineItems	duplikat

v1

W wersji 1 nie dodano żadnych nowych funkcji.

20 września 2022 r.

Udostępniliśmy wersję 2 w publicznej wersji beta, która zawiera 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 i list w usługach advertisers.lineItems i advertisers.lineItems.targetingTypes.assignedTargetingOptions .
• 2 nowe metody zbiorczego kierowania w usłudze advertisers.lineItems, które umożliwiają edytowanie i pobieranie przypisanego kierowania w wielu elementach zamówienia za pomocą pojedynczego żądania.
• Nowa metoda bulkUpdate, która umożliwia użytkownikom aktualizowanie entityStatuswielu elementów zamówienia w jednym żądaniu.
• Nowa logika kierowania, która wymaga przypisania i pobrania zasobów AssignedTargetingOption podzbioru typów kierowania za pomocą wartości wyliczeniowych zamiast identyfikatorów opcji kierowania pobieranych przez usługę targetingTypes.targetingOptions.

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

Dodano obsługę 3 nowych giełd w wersji 1.

Nowe funkcje

v2

Poniżej znajdziesz listę zmian między wersją 1 a 2:

• W wersji 2 dodano te metody:

  Usługa	Metody
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• W wersji 2 usunięto te metody:

  Usługa	Metody
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• W wersji 2 zmieniono nazwy tych metod:

  Usługa	Stara nazwa metody	Nowa nazwa metody
  reklamodawcy,	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partnerów,	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Zasoby AssignedTargetingOption tych typów kierowania używają w wersji 2 do przypisywania kierowania wartości wyliczanych. W wersji 2 zaktualizowano też pole assignedTargetingOptionId w przypadku zasobów AssignedTargetingOption tych typów kierowania, aby używało ono wersji ciągu znaków wartości wyliczanych:

  Typ kierowania	Typ enum
  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:

  Zasób	Pola
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	exchange
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• W wersji 2 usunęliśmy te pola:

  Zasób	Pola
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• W wersji 2 wymagane są następujące pola:

  Zasób	Pola
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	environment
  ExchangeAssignedTargetingOptionDetails	exchange
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	widoczność

• W wersji 2 dodano te wartości wyliczenia:

  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 wyliczenia:

  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 wyliczenia:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26 maja 2022 r.

Dodano możliwość tworzenia zasobów InventorySource i zarządzania nimi GuaranteedOrder za pomocą nowych metod zapisu usługi inventorySources i nowej usługi guaranteedOrders.

Wprowadziliśmy pole modelReadiness w zasobie CustomBiddingAlgorithm. To pole zawiera informacje o gotowości modelu algorytmu w przypadku każdego reklamodawcy, który może z niego korzystać.

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

Dodano obsługę najnowszej wersji SDF, v5.5, poprzez dodanie wartości encji SdfVersion.

Nowe funkcje

• Dodano te metody:

  Usługa	Metody
  guaranteedOrders	create (utwórz) editGuaranteedOrderReadAccessors get list patch
  inventorySources	create (utwórz) editInventorySourceReadWriteAccessors patch

• Dodano następujące pola:

  Zasób	Pola
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_5_5

• Te metody listy można teraz filtrować według tych właściwości:

  Metoda	Pola
  advertisers.creatives.list	updateTime

31 marca 2022 r.

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

Dodano pole billableOutcome do obiektu InsertionOrder.

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

Nowe funkcje

• Dodano następujące pola:

  Zasób	Pola
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 lutego 2022 r.

Dodano obsługę tworzenia, aktualizowania i edytowania członków niektórych zasobów FirstAndThirdPartyAudience Customer Match. W nowym przewodniku Korzystanie z list odbiorców znajdziesz stronę Przesyłanie list odbiorców kierowania na listę klientów, która zawiera szczegółowe informacje o korzystaniu z tych nowych funkcji.

Wprowadziliśmy nowe pole reservationType w zasobach InsertionOrder i LineItem, które wskazuje, czy zasób jest objęty gwarancją tagu, gwarancją programmaticzną czy nie jest objęty gwarancją.

Dodano możliwość pobierania i ustawiania wartości określającej, czy element zamówienia automatycznie kieruje reklamy na nowe giełdy za pomocą nowego pola excludeNewExchanges.

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

Nowe funkcje

• Dodano te metody:

  Usługa	Metody
  firstAndThirdPartyAudiences	create (utwórz) editCustomerMatchMembers patch

• Dodano następujące pola:

  Zasób	Pola
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

8 grudnia 2021 r.

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

Nowe funkcje

• Dodano następujące pola:

  Zasób	Pola
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 listopada 2021 r.

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

• Funkcje do tworzenia nowych i aktualizowania istniejących customBiddingAlgorithms.
• Możliwość przesyłania skryptów w ramach procesu pobierania dostępnej lokalizacji zasobu, a następnie przesyłania pliku do tej lokalizacji.
• nowa usługa customBiddingAlgorithms.scripts do pobierania i tworzenia customBiddingScripts;

Do naszego 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.

Dodano obsługę najnowszej wersji pliku SDF, v5.4, poprzez dodanie wartości encji SdfVersion.

Nowe funkcje

• Dodano te metody:

  Usługa	Metody
  customBiddingAlgorithms	create (utwórz) patch uploadScript
  customBiddingAlgorithms.scripts	create (utwórz) get list
  media	upload

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_5_4

14 września 2021 r.

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

Dodano możliwość wyszukiwania dostępnych opcji kierowania TARGETING_TYPE_BUSINESS_CHAIN i TARGETING_TYPE_POI za pomocą targetingTypes.targetingOptions.search, ponieważ nie można ich pobrać za pomocą metod targetingTypes.targetingOptions.get ani targetingTypes.targetingOptions.list.

Wprowadziliśmy nowe pola sharedAdvertiserIds i customBiddingAlgorithmState w zasobach algorytmu ustalania stawek niestandardowych oraz dodaliśmy obsługę typu algorytmu ustalania stawek niestandardowych GOAL_BUILDER_BASED.

Dodaliśmy 2 nowe wartości do typu zbiorczego Exchange.

Nowe funkcje

• Dodano następujące pola:

  Zasób	Pola
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search Request Body	businessChainSearchTerms poiSearchTerms

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Giełda	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• Te metody listy można teraz filtrować według tych właściwości:

  Metoda	Pola
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4 sierpnia 2021 r.

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

Zwiększono maksymalną liczbę przypisanych opcji kierowania, które mogą być zwracane na jednej stronie w przypadku różnych reklamodawców, kampanii, zamówień reklamowych i elementów zamówienia przypisanych do metod listy opcji kierowania za pomocą parametru pageSize.

Nowe funkcje

• Dodano następujące pola:

  Zasób	Pola
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  TargetingType	TARGETING_TYPE_OMID

• Maksymalny rozmiar strony został zwiększony w przypadku tych metod list:

  Metoda	Nowy maksymalny rozmiar strony
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

26 maja 2021 r.

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

• pobrać faktury wystawione reklamodawcy w danym miesiącu.
• sprawdzić kod waluty używany przez reklamodawcę w danym miesiącu.

Dodano do zasobu kampanii pole campaignBudgets. Segmenty budżetu zamówienia reklamowego można powiązać z budżetem kampanii, ograniczając sumę budżetów powiązanych segmentów do łącznej kwoty budżetu kampanii.

Dodaliśmy obsługę kierowania na pozycję w treściach własnych w ramach nowego TARGETING_TYPE_NATIVE_CONTENT_POSITIONtypu kierowania.

Wprowadziliśmy nowe pole prismaEnabled w zasobie reklamodawcy, dzięki któremu użytkownicy mogą włączyć integrację z narzędziem Prisma firmy Mediaocean.

Włączyliśmy obsługę wartości encji ENTITY_STATUS_PAUSED w polu entityStatus reklamodawcy.

Nowe funkcje

• Dodano te metody:

  Usługa	Metody
  advertisers.invoices	list lookupInvoiceCurrency

• Dodano następujące pola:

  Zasób	Pola
  Reklamodawca	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Kampania	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Giełda	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• W tych polach można teraz używać tych wartości wyliczenia:

  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ę pozycji na linii korzystających z zasobu do kierowania. Włączyliśmy nowe właściwości filter dla metody listy elementów zamówienia, które umożliwiają użytkownikowi pobieranie tylko elementów zamówienia, które w swoim kierowaniu korzystają z określonych kanałów lub list wykluczających słów kluczowych.

Nowe funkcje

• Dodano następujące pola:

  Zasób	Pola
  Kanał	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• Te metody listy można teraz filtrować według tych właściwości:

  Metoda	Pola
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30 marca 2021 r.

Dodano do usługi elementu zamówienia nową metodę, która generuje element zamówienia z domyślnymi konfiguracjami. Te wartości domyślne zależą od typu elementu zamówienia, a także od ustawień i przypisanych ustawień kierowania zamówienia reklamowego nadrzędnego.

Umożliwiliśmy pobieranie ustawień kierowania kampanii za pomocą nowej usługi kierowania kampanii i dodatkowej metody list zbiorczych.

rozszerzone kierowanie na aplikacje, aby umożliwić kierowanie na aplikacje 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 kanałami i listami wykluczających słów kluczowych. Te zmiany obejmują:

• Dodanie metod replace, które umożliwia użytkownikowi całkowite zastąpienie dotychczasowej zawartości kanału lub listy wykluczających słów kluczowych.
• Usunięcie wymogu, aby w polach createdSites lub createdNegativeKeywords w prośbach o edycję zbiorczą nie były uwzględniane żadne istniejące elementy.
• Zwiększenie maksymalnej liczby elementów, które mogą być zwracane na jednej stronie odpowiedzi list sites lub list negative keywords.

Nowe funkcje

• Dodano te metody:

  Usługa	Metody
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• Dodano następujące pola:

  Zasób	Pola
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• Maksymalny rozmiar strony został zwiększony w przypadku tych metod list:

  Metoda	Stary maksymalny rozmiar strony	Nowy maksymalny rozmiar strony
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

Elementy wycofane

• Do nowych i dotychczasowych zasobów nie można już przypisywać tych wartości:

  Typ wyliczeniowy	Wartości
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24 lutego 2021 r.

Wprowadziliśmy nową usługę kierowania zamówienia reklamowego i dodatkową metodę list zbiorczych, która umożliwia pobieranie kierowania przypisanego zamówieniom reklamowym. Rozwinęliśmy zasób kreacji, dodając pola kreacji tylko z wyjściem na potrzeby kreacji audio innych firm. Dodano nowe typy celów związanych z wydajnością, które mogą być używane przez zamówienia reklamowe i kampanie.

Nowe funkcje

• Dodano te metody:

  Usługa	Metody
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• Dodano te pola:

  Zasób	Pola
  Kreacje	mp3Audio oggAudio

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

27 stycznia 2021 r.

Umożliwiliśmy pobieranie i zarządzanie zamówieniami reklamowymi i elementami zamówienia typu Over-The-Top dzięki wprowadzeniu nowego pola InsertionOrderType oraz nowego typu wartości za pomocą enumeracji LineItemType. Dodano obsługę elementów zamówienia promujących instalację aplikacji mobilnej za pomocą pola elementu zamówienia mobileApp. Rozszerzone obsługiwane wartościami enumeracji exchange, google audience i SDF. Wprowadziliśmy możliwość filtrowania i sortowania wartości kolumny advertisers.list według daty ostatniej modyfikacji.

Nowe funkcje

• Dodano następujące pola:

  Zasób	Pola
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• Listy można teraz sortować i filtrować według tych pól:

  Metoda	Pola
  reklamodawców	updateTime

4 grudnia 2020 r.

Dodano możliwość wyszukiwania opcji kierowania Geo Region i filtrowania wyników z kilku list zasobów według daty ostatniej aktualizacji. Wprowadziliśmy nowy komunikat o ostrzeganiu dotyczący elementów zamówienia, aby informować użytkowników, gdy element zamówienia korzysta z wycofanego kierowania geograficznego.

Nowe funkcje

• Dodano te metody:

  Usługa	Metody
  targetingTypes.targetingOptions	szukaj

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Listy można teraz sortować i filtrować według tych pól:

  Metoda	Pola
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

5 listopada 2020 roku

Dodaliśmy możliwość tworzenia, przypisywania i aktywowania reguł ręcznych, które inicjują wydawanie środków przez powiązane z nimi elementy zamówienia. Wprowadziliśmy opcje rozszerzania zasięgu kierowania, które po skonfigurowaniu mogą rozszerzyć kierowanie elementu zamówienia o użytkowników podobnych do tych z grup odbiorców. Dodano pola identyfikatorów niestandardowych segmentów do obiektów DoubleVerify i Integral Ad Science używanych w kierowaniu na weryfikację zewnętrzną.

Nowe funkcje

• Dodano te usługi:

  Usługa	Metody
  advertisers.manualTriggers	activate create dezaktywuj get list poprawka

• Dodano te pola:

  Zasób	Pola
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Te metody listy można teraz filtrować za pomocą tych pól:

  Metoda	Pola
  advertisers.lineItems.list	filter.triggerId

12 października 2020 r.

Wprowadziliśmy możliwość wyświetlania komunikatów ostrzegawczych w przypadku zasobu elementu zamówienia i celu skuteczności typu współczynnik klikalności (CTR). Dodano pole warningMessages jako pole, które można filtrować podczas wyświetlania elementów zamówienia.

Oprócz nowych funkcji obowiązują teraz nowe limity kwoty, a dodatkowo dostępna jest nowa dokumentacja dotycząca użytkowania żądań zbiorczych.

Nowe funkcje

• Dodano następujące pola:

  Zasób	Pola
  LineItem	warningMessages

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Te metody listy można teraz filtrować za pomocą tych pól:

  Metoda	Pola
  advertisers.lineItems.list	warningMessages

28 sierpnia 2020 r.

Do odpowiedzi metody kontroli reklamodawcy dodaliśmy nowe pola, a do różnych metod listy – nowe pola, które można filtrować.

Nowe funkcje

• Dodano następujące pola:

  Zasób	Pola
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Te metody listy można teraz filtrować za pomocą tych pól:

  Metoda	Pola
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

4 sierpnia 2020 roku

Wprowadziliśmy nowe funkcje zarządzania użytkownikami, partnerami i kierowania na partnerów. Wprowadziliśmy narzędzia, które pomagają użytkownikom zapobiegać osiąganiu limitów elementów konta. Dodano obsługę elementów zamówienia audio i użycie niestandardowych algorytmów ustalania stawek w strategiach ustalania stawek elementów zamówienia i zamówień reklamowych.

Nowe funkcje

• Dodano te usługi:

  Usługa	Metody
  customBiddingAlgorithms	get list
  partnerów	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create usuń get list
  użytkowników	bulkEditAssignedUserRoles create usuń get list poprawka

• Dodano te metody:

  Usługa	Metody
  reklamodawców	audit

• Dodano następujące pola:

  Zasób	Pola
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Listy można teraz sortować i filtrować według tych pól:

  Metoda	Pola
  advertisers.lineItems.list	flight.dateRange.endDate

• Do tych usług dodano te zakresy:

  Zakres	Usługi
  https://www.googleapis.com/auth/display-video-user-management	użytkownicy

24 czerwca 2020 r.

Wprowadziliśmy niewielką aktualizację, która dodaje metodę tworzenia kanałów partnera i reklamodawcy, nowe pola FirstAndThirdPartyAudience oraz dodatkowe wartości wyliczenia exchange.

Nowe funkcje

• Dodano te usługi:

  Usługa	Metody
  advertisers.channels	create
  partners.channels	create

• Dodano następujące pola:

  Zasób	Pola
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType opis displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• Dodano te wartości enum:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Te metody listy można teraz filtrować za pomocą tych pól:

  Metoda	Pola
  advertisers.creatives.list	creativeId

2 czerwca 2020 r.

Wprowadziliśmy możliwość tworzenia, aktualizowania i wypełniania podzbioru elementów docelowych oraz możliwość modyfikowania kierowania na poziomie reklamodawcy w 3 typach kierowania: kanał, wykluczenie etykiety treści cyfrowych i wykluczenie kategorii o charakterze kontrowersyjnym.

Nowe funkcje

• Dodano te usługi:

  Usługa	Metody
  advertisers.channels.sites	bulkEdit create usuń list
  advertisers.locationLists.assignedLocations	bulkEdit create usuń list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create usuń list
  advertisers.targetingTypes.assignedTargetingOptions	create usuń get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create usuń list
  partners.channels.sites	bulkEdit create usuń list

• Dodano te metody:

  Usługa	Metody
  reklamodawców	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	poprawka
  advertisers.locationLists	create poprawka
  advertisers.negativeKeywordLists	create usuń poprawka
  inventorySourceGroups	create usuń poprawka
  partners.channels	poprawka

• Dodano następujące pola:

  Zasób	Pola
  reklamodawca	servingConfig
  kreacja	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27 kwietnia 2020 r.

Wprowadziliśmy duży zestaw funkcji, rozszerzając zakres interfejsu API poza SDF. Dodano zarządzanie podstawowymi zasobami, które umożliwia 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

Dodano te usługi:

Usługa	Metody
reklamodawców	create usuń get list poprawka
advertisers.assets	upload
advertisers.campaigns	create usuń get list poprawka
advertisers.channels	get list
advertisers.creatives	create usuń get list poprawka
advertisers.insertionOrders	create usuń get list poprawka
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create usuń get list poprawka
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create usuń get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get poprawka
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

9 marca 2020 r.

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

Znane problemy

Brak.