Informacje o wersjach

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

Najnowsza wersja interfejsu API: 3

17 czerwca 2024 r.

Nowe funkcje

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

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

v3

• Dodano te pola:

  Zasób	Pola
  InsertionOrder	optimizationObjective

• Poniższe metody obsługują teraz następujące 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

• Poniższe metody obsługują teraz następujące 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.

v3

• 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.

v3

• Dodano te pola:

  Zasób	Pola
  KPI	kpiAlgorithmId

• 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.

v3

• Dodano te pola:

  Zasób	Pola
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• 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	removedContactInfoList removedMobileDeviceIdList

• 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ą nowej usługi floodlightGroups.floodlightActivities.

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

Dodaliśmy nowe pole do przekazywania czasu ostatniego logowania przez użytkownika Display & Video 360.

v3

• Dodaliśmy te metody:

  Usługa	Metody
  floodlightGroups.floodlightActivities	pobierz list

• Dodano te pola:

  Zasób	Pola
  Użytkownik	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Dodaliśmy te metody:

  Usługa	Metody
  floodlightGroups.floodlightActivities	pobierz list

• Dodano te pola:

  Zasób	Pola
  Użytkownik	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

14 listopada 2023 r.

Nowe funkcje

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

v3

• Dodano te pola:

  Zasób	Pola
  ContactInfoList	zgoda
  MobileDeviceIdList	zgoda

v2

• Dodano te pola:

  Zasób	Pola
  ContactInfoList	zgoda
  MobileDeviceIdList	zgoda

31 października 2023 r.

Nowe funkcje

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

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

Dodaliśmy obsługę plików uporządkowanych danych w wersji 7 oraz wartości wyliczeniowej SDF_VERSION_7 w wersjach 2 i 3.

v3

• 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, co umożliwia korzystanie z usługi advertisers.locationLists.assignedLocations do tworzenia i usuwania lokalizacji przypisanych do zasobów TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• Nowe pole wartości logicznej enableOptimizedTargeting, które zastępuje pole targetingExpansionLevel w obiekcie TargetingExpansionConfig.
• Wymaganie dotyczące pola billingConfig w zasobie Advertiser, które musi być uwzględnione podczas przesyłania żądań advertisers.create, oraz nowego pola billingConfig w zasobie Partner.
• Nowe zasoby AdGroup i AdGroupAd, które zastępują zasoby YoutubeAdGroup i YoutubeAdGroupAd w wersji 2.

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

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

v3

• Dodaliśmy te metody:

  Usługa	Metody
  advertisers.adGroupAds	pobierz list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions pobierz list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	pobierz list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	utwórz pobierz list

• 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	Teraz obsługuje tworzenie TARGETING_LOCATION_TYPE_PROXIMITY zasobów typu LocationList.
  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 w TARGETING_LOCATION_TYPE_PROXIMITY zasobach LocationList.
  advertisers.locationLists.assignedLocations.create	Teraz można tworzyć zasoby AssignedLocation w TARGETING_LOCATION_TYPE_PROXIMITY zasobach LocationList.

• Dodano te parametry zapytania:

  Metoda	Parametry
  inventorySources.get	advertiserId

• Te pola zostały wypełnione:

  Zasób	Pola
  Reklamodawca	billingConfig

• Dodano te 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

• 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ę 2 giełd i 2 nowych typów strategii ustalania stawek dla YouTube i sieci partnerów wideo Google.

Dodaliśmy nowe pole effectiveContentCategory do elementów zamówienia typu YouTube i sieć partnerów wideo Google, aby wyświetlać wartość YoutubeAndPartnersContentCategory używaną przez dany element zamówienia przy uwzględnieniu wartości przypisanych zarówno na poziomie reklamodawcy, jak i elementu zamówienia.

v2

• Dodano te pola:

  Zasób	Pola
  YoutubeAndPartnersSettings	effectiveContentCategory

• 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) w wersji 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 przypisana do pola warningMessages elementu zamówienia, jeśli wycofane pole excludeFirstPartyAudience jest w nim ustawione na true. Po 25 marca 2023 r. pole excludeFirstPartyAudience zostanie wycofane i ustawione na false.

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

Dodaliśmy możliwość pobierania zasobów YouTubeAdGroup i YouTubeAdGroupAd, a także kierowanie na zasoby grup reklam w YouTube. Dodaliśmy też nowe typy kierowania, które można pobierać, używane na poziomie grup reklam w YouTube. Więcej informacji znajdziesz w nowej stronie przewodnika po pobieraniu zasobów dotyczących YouTube i sieci partnerów wideo Google.

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

v2

• Dodaliśmy te metody:

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

• Dodano te pola:

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

• 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 zasobu AssignedTargetingOption dodaliśmy nowe pole assignedTargetingOptionIdAlias, którego można używać zamiast pola assignedTargetingOptionId przy pobieraniu i usuwaniu ustawień kierowania. To pole ustawia się tylko w przypadku przypisanych opcji kierowania typów kierowania, które są przypisane w ramach wyliczenia. Wartość aliasu to odpowiednia wartość wyliczeniowa w formie ciągu znaków.

Do zasobu Advertiser dodano nowe pole billingConfig.

Dodaliśmy obsługę pobierania elementów zamówienia Over-The-Top dla YouTube i sieci partnerów wideo Google, określonych za pomocą 3 nowych 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 te pola:

  Zasób	Pola
  Reklamodawca	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

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

  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

• Zwiększyliśmy maksymalny rozmiar strony w przypadku tych metod tworzenia listy:

  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 następujące znane problemy w wersji 2:

• Nie udało się usunąć ani pobrać przypisanych opcji kierowania typów kierowania przypisanych za pomocą wartości wyliczeniowych w wersji 2przy użyciu ich assignedTargetingOptionId i oczekiwano, że użytkownicy będą używać wartości wyliczeniowej. Dzięki tej aktualizacji te przypisane opcje kierowania można usunąć lub pobrać za pomocą wartości assignedTargetingOptionId lub wyliczenia, które wskazuje nowe pole assignedTargetingOptionIdAlias w zasobie AssignedTargetingOption.
• Żądanie dotyczące elementu zamówienia bulkUpdate nieprawidłowo korzystało z parametru żądania advertisersId, co zwróciło błąd. Ta aktualizacja została naprawiona, a nazwa parametru żądania została zmieniona z advertisersId na advertiserId.

27 października 2022 r.

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

Wprowadzono obsługę zapisu częściowego kierowania zamówień reklamowych dla podzbioru typów kierowania wraz z metodami create i delete do usługi advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Nowe funkcje

v2

• Dodaliśmy te metody:

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

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 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 .
• Dwie nowe metody kierowania zbiorczego w usłudze advertisers.lineItems umożliwiają edytowanie i pobieranie przypisanego kierowania w wielu elementach zamówienia w ramach jednego żądania.
• Nowa metoda bulkUpdate, która umożliwia użytkownikom aktualizowanie wartości entityStatus w wielu elementach 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.

Wykonaj czynności opisane w naszym przewodniku po migracji, aby przejść z wersji 1 na wersję 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 bulkListAssignedTargetingOptions bulkUpdate

• 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	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Zasoby AssignedTargetingOption tych typów kierowania używają wyliczeniowych do przypisywania kierowania w wersji 2. Pole assignedTargetingOptionId zasobów AssignedTargetingOption 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:

  Zasób	Pola
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	giełda
  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ą te pola:

  Zasób	Pola
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	środowisko
  ExchangeAssignedTargetingOptionDetails	giełda
  GenderAssignedTargetingOptionDetails	gender [płeć]
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	widoczność

• 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 i zarządzania zasobami GuaranteedOrder za pomocą nowych metod zapisu w usłudze inventorySources oraz nowej usługi guaranteedOrders.

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

Włączono nową funkcję parametrów zapytania filter dla metody advertisers.creatives.list, która pozwala użytkownikowi pobierać kreacje z updateTime przed określoną sygnaturą czasową lub po niej.

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

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  guaranteedOrders	utwórz editGuaranteedOrderReadAccessors pobierz list poprawka
  inventorySources	utwórz editInventorySourceReadWriteAccessors poprawka

• Dodano te pola:

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

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_5_5

• Te metody 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 strumienia i gatunek.

Do obiektu InsertionOrder dodano pole billableOutcome.

Do obiektu MaximizeSpendBidStrategy dodaliśmy pole raiseBidForDeals, dzięki któremu użytkownicy mogą określić, czy strategia ustalania stawek stosuje ceny minimalne reklamodawcy w umowach objętych kierowaniem.

Nowe funkcje

• Dodano te pola:

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

• Dodaliśmy te wartości wyliczeniowe:

  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 niektórych zasobów kierowania na listę klientów FirstAndThirdPartyAudience. Informacje o korzystaniu z tych nowych funkcji znajdziesz na stronie Przesyłanie odbiorców z kierowania na listę klientów w nowym przewodniku Korzystanie z odbiorców.

W zasobach InsertionOrder i LineItem wprowadziliśmy nowe pole reservationType, które określa, czy zasób jest gwarantowany przez tag, gwarantowana automatyzacja czy nie.

Dodaliśmy możliwość pobierania i określania, czy element zamówienia jest automatycznie kierowany na nowe giełdy, korzystając z nowego pola excludeNewExchanges.

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

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  firstAndThirdPartyAudiences	utwórz editCustomerMatchMembers poprawka

• Dodano te pola:

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

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	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Dodaliśmy te wartości wyliczeniowe:

  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 skryptami. Obejmuje to te sytuacje:

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

Do przewodnika Zarządzanie elementami zamówienia dodaliśmy nową stronę Wdrażanie ustalania stawek niestandardowych. Zawiera ona opis procesu tworzenia algorytmu ustalania stawek niestandardowych, przesyłania skryptu i przypisywania algorytmu ustalania stawek niestandardowych jako strategii ustalania stawek w elemencie zamówienia.

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

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  customBiddingAlgorithms	utwórz poprawka uploadScript
  customBiddingAlgorithms.scripts	utwórz pobierz list
  multimedia,	prześlij

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_5_4

14 września 2021 r.

W typach kierowania TARGETING_TYPE_BUSINESS_CHAIN i TARGETING_TYPE_POI dodaliśmy obsługę kierowania na zbliżony obszar.

Dodaliśmy 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.

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

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

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search Treść żądania	businessChainSearchTerms poiSearchTerms

• Dodaliśmy te wartości wyliczeniowe:

  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 można teraz filtrować według tych właściwości:

  Metoda	Pola
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4 sierpnia 2021 r.

Dodaliśmy obsługę kierowania zasobów reklamowych z włączonym pomiarem Open Measurement w typie kierowania TARGETING_TYPE_OMID.

Zwiększyliśmy maksymalną liczbę przypisanych opcji kierowania, które mogą być zwracane na 1 stronie różnych metod kierowania przypisanych do różnych reklamodawców, kampanii, zamówień reklamowych i elementów zamówienia przy użyciu parametru metody pageSize.

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  TargetingType	TARGETING_TYPE_OMID

• Zwiększyliśmy maksymalny rozmiar strony w przypadku tych metod tworzenia listy:

  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 pozwala użytkownikom:

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

Do zasobów kampanii dodaliśmy pole campaignBudgets. Segmenty budżetu zamówienia reklamowego można połączyć z budżetem kampanii, co ograniczy łączny budżet powiązanych segmentów do kwoty całkowitego budżetu kampanii.

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

Do zasobu 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	list lookupInvoiceCurrency

• Dodano te pola:

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

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• W tych polach są teraz prawidłowe wartości wyliczeniowe:

  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 tych zasobów do kierowania. Włączono nowe właściwości filter dla metody listy elementów zamówienia, które pozwalają użytkownikowi pobierać tylko te elementy zamówienia, które są powiązane z określonymi kanałami lub listami wykluczających słów kluczowych w kierowaniu.

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  Kanał	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

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

  Metoda	Pola
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30 marca 2021 r.

Dodaliśmy do usługi elementów zamówienia nową metodę generującą element zamówienia z konfiguracjami domyślnymi. Te wartości domyślne zależą od podanego typu elementu zamówienia, a także ustawień i przypisanego kierowania nadrzędnego zamówienia reklamowego.

Możliwość pobierania ustawień kierowania kampanii za pomocą nowej usługi kierowania kampanii i dodatkowej metody przesyłania list zbiorczych.

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

Wprowadziliśmy wiele zmian w usługach advertisers.channels.sites, partners.channels.sites i advertisers.negativeKeywordLists.negativeKeywords, aby ułatwić zarządzanie kanałem i listą wykluczających słów kluczowych. Zmiany te obejmują:

• Dodanie metod replace, które umożliwiają użytkownikowi pełne zastąpienie istniejącej treści kanału lub listy wykluczających słów kluczowych.
• Wycofaliśmy wymóg, aby żadne istniejące elementy nie były uwzględnione w polach createdSites ani createdNegativeKeywords w żądaniach edycji zbiorczej.
• Zwiększenie maksymalnej liczby elementów, które mogą być zwracane na jednej stronie w odpowiedzi na listę witryn lub listę wykluczających słów kluczowych.

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	pobierz list
  advertisers.channels.sites	zastąp
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	zastąp
  partners.channels.sites	zastąp

• Dodano te pola:

  Zasób	Pola
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• 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.

Wprowadziliśmy nową usługę kierowania zamówień reklamowych i dodatkową metodę kierowania na listy zbiorcze, które umożliwiają pobieranie ustawień kierowania przypisanych do zamówień reklamowych. Rozwinięto zasób kreacji, dodając pola kreacji tylko z danymi wyjściowymi do wykorzystania przez kreacje audio firm zewnętrznych. Dodaliśmy nowe typy celów związanych ze skutecznością do wykorzystania przez zasoby zamówień reklamowych i kampanii.

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	pobierz lista

• Dodano te pola:

  Zasób	Pola
  Kreacja	mp3Audio oggAudio

• Dodaliśmy te wartości wyliczeniowe:

  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.

Możliwość pobierania telewizyjnych zamówień reklamowych i elementów zamówienia Over-The-Top oraz zarządzania nimi przez wprowadzenie nowego pola InsertOrderType i nowej wartości wyliczeniowej LineItemType. Dodaliśmy obsługę elementów zamówienia w aplikacjach mobilnych w polu elementu zamówienia mobileApp. Rozszerzyliśmy obsługę Exchange, odbiorców google i SDF przez dodatkowe wartości wyliczeniowe. Dodaliśmy możliwość filtrowania i sortowania wartości advertisers.list według czasu ostatniej aktualizacji.

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  Exchange	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

• Sortowanie i filtrowanie według tych pól jest teraz możliwe w przypadku tych metod:

  Metoda	Pola
  reklamodawców	updateTime

Grudzień 4, 2020

Dodaliśmy możliwość wyszukiwania opcji kierowania na region geograficzny i filtrowania wielu wyników metody z listą zasobów według czasu ostatniej aktualizacji. Wprowadziliśmy nową wiadomość LineItemWarningMessage, która informuje użytkowników o tym, kiedy element zamówienia korzysta z wycofanego kierowania geograficznego.

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  targetingTypes.targetingOptions	wyszukaj

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Sortowanie i filtrowanie według tych pól jest teraz możliwe w przypadku tych metod:

  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 z powiązanych elementów zamówienia. Wprowadziliśmy opcje rozszerzania zasięgu kierowania, które po ustawieniu mogą rozszerzyć kierowanie elementu zamówienia o użytkowników podobnych do tych z docelowych odbiorców. Do obiektów DoubleVerify i Integral Ad Science używanych przy kierowaniu na potrzeby weryfikacji zewnętrznej dołączono pola identyfikatorów niestandardowych segmentów.

Nowe funkcje

• Te usługi zostały dodane:

  Usługa	Metody
  advertisers.manualTriggers	aktywuj utwórz dezaktywuj pobierz lista poprawka

• Dodano te pola:

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

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Te metody można teraz filtrować według tych pól:

  Metoda	Pola
  advertisers.lineItems.list	filter.triggerId

12 października 2020 r.

Dodaliśmy do zasobu elementu zamówienia komunikaty z ostrzeżeniami, które można pobierać, oraz typ docelowej skuteczności współczynnika klikalności (CTR). Dodano warningMessages jako pole możliwe do filtrowania przy wyświetlaniu listy elementów zamówienia.

Oprócz nowych funkcji obowiązują teraz nowe limity. Udostępniliśmy też nową dokumentację na temat korzystania z żądań zbiorczych.

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  LineItem	warningMessages

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Te metody można teraz filtrować według tych pól:

  Metoda	Pola
  advertisers.lineItems.list	warningMessages

28 sierpnia 2020 r.

Dodaliśmy nowe pola do odpowiedzi metody kontroli reklamodawcy i nowe pola możliwe do filtrowania w przypadku różnych metod tworzenia list.

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  Reklamodawcy.Treść odpowiedzi na audyt	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Te metody można teraz filtrować według 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 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	pobierz lista
  partnerzy	bulkEditPartnerAssignedTargetingOptions pobierz lista
  partners.targetingTypes.assignedTargetingOptions	utwórz Usuń pobierz lista
  Użytkownicy	bulkEditAssignedUserRoles utwórz Usuń pobierz lista poprawka

• Dodaliśmy te metody:

  Usługa	Metody
  reklamodawców	kontrola

• Dodano te pola:

  Zasób	Pola
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Sortowanie i filtrowanie według tych pól jest teraz możliwe w przypadku tych metod:

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

• Te zakresy zostały dodane do wykorzystania w tych usługach:

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

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	utwórz
  partners.channels	utwórz

• Dodano te pola:

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

• Dodaliśmy te wartości wyliczeniowe:

  Typ wyliczeniowy	Wartości
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Te metody można teraz filtrować według tych pól:

  Metoda	Pola
  advertisers.creatives.list	creativeId

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:

  Usługa	Metody
  advertisers.channels.sites	bulkEdit utwórz Usuń lista
  advertisers.locationLists.assignedLocations	bulkEdit utwórz Usuń lista
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit utwórz Usuń lista
  advertisers.targetingTypes.assignedTargetingOptions	utwórz Usuń pobierz lista
  inventorySourceGroups.assignedInventorySources	bulkEdit utwórz Usuń lista
  partners.channels.sites	bulkEdit utwórz Usuń lista

• Dodaliśmy te metody:

  Usługa	Metody
  reklamodawców	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	poprawka
  advertisers.locationLists	utwórz poprawka
  advertisers.negativeKeywordLists	utwórz Usuń poprawka
  inventorySourceGroups	utwórz Usuń poprawka
  partners.channels	poprawka

• Dodano te pola:

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

27 kwietnia 2020 r.

Udostępniliśmy duży zestaw funkcji, rozszerzając zakres interfejsu API poza pliki SDF. Dodaliśmy podstawowe zarządzanie 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 możliwości umożliwiają też edytowanie kierowania na poziomie elementu zamówienia.

Nowe funkcje

Te usługi zostały dodane:

Usługa	Metody
reklamodawców	utwórz Usuń pobierz lista poprawka
advertisers.assets	prześlij
advertisers.campaigns	utwórz Usuń pobierz lista poprawka
advertisers.channels	pobierz lista
advertisers.creatives	utwórz Usuń pobierz lista poprawka
advertisers.insertionOrders	utwórz Usuń pobierz lista poprawka
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions utwórz Usuń pobierz lista poprawka
advertisers.lineItems.targetingTypes.assignedTargetingOptions	utwórz Usuń pobierz lista
advertisers.locationLists	pobierz lista
advertisers.negativeKeywordLists	pobierz lista
combinedAudiences	pobierz lista
customLists	pobierz lista
firstAndThirdPartyAudiences	pobierz lista
floodlightGroups	pobierz poprawka
googleAudiences	pobierz lista
inventorySourceGroups	pobierz lista
inventorySources	pobierz lista
partners.channels	pobierz lista
partners.channels	pobierz lista

Marzec 9, 2020

Wprowadzono interfejs Display & Video 360 API w wersji 1. To jest wstępna wersja interfejsu API.

Znane problemy

Brak.