Archiwalne informacje o wersjach

Na tej stronie znajdziesz informacje o wersjach Display & Video 360 API, które zostały wycofane.

Wszystkie informacje o wersjach, które zostały udostępnione, znajdziesz na naszej głównej stronie z informacjami o wersji.

4 grudnia 2024 r.

Nowe funkcje

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

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

Wersja 3

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• Zwiększyliśmy maksymalny rozmiar strony 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 kierowanie na weryfikatora zewnętrznego.

Dodaliśmy możliwość pobierania plików uporządkowanych danych w wersji 8, która jest obecnie w zamkniętej wersji beta.

Wersja 3

• Dodano te pola:

  Obiekt

  Pola

  Adloox

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

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

Wycofane wartości

Usunęliśmy obsługę pliku SDF w wersji 5.5, ponieważ 3 października 2024 r. zakończyliśmy jego działanie.

Wersja 3

• Te wartości wyliczenia zostały wycofane:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_5_5

15 sierpnia 2024 r.

Nowe funkcje

Dodaliśmy obsługę typu Netflix Exchange.

Wersja 3

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_NETFLIX

v2

• Dodaliśmy te wartości typu wyliczeniowego:

  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 te pola:

  Zasób	Pola
  IdFilter	adGroupQaIds lineItemQaIds

• Dodaliśmy te wartości typu wyliczeniowego:

  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. optimizationObjective jest dostępna tylko dla klientów z białej listy.

Wersja 3

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

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_7_1

v2

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_7_1

23 kwietnia 2024 r.

Nowe funkcje

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

Wersja 3

• Dodano te pola:

  Zasób	Pola
  Kpi	kpiAlgorithmId

• Dodaliśmy te wartości typu wyliczeniowego:

  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 typu wyliczeniowego:

  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 członków z list odbiorców służących do kierowania na listę klientów.

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

Wersja 3

• Dodano te pola:

  Zasób	Pola
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Dodaliśmy te wartości typu wyliczeniowego:

  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 typu wyliczeniowego:

  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 uwzględnia w kierowaniu zasoby reklamowe Google TV.

Dodaliśmy nowe pole, które przekazuje czas ostatniego logowania użytkownika Display & Video 360.

Wersja 3

• Dodaliśmy te metody:

  Usługa	Metody
  floodlightGroups.floodlightActivities	get list

• Dodano te pola:

  Zasób	Pola
  Użytkownik	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Dodaliśmy te metody:

  Usługa	Metody
  floodlightGroups.floodlightActivities	get 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 członków list klientów w ramach kierowania na listę klientów we wszystkich wersjach na żywo.

Wersja 3

• Dodano te pola:

  Zasób	Pola
  ContactInfoList	zgodę
  MobileDeviceIdList	zgodę

v2

• Dodano te pola:

  Zasób	Pola
  ContactInfoList	zgodę
  MobileDeviceIdList	zgodę

31 października 2023 r.

Nowe funkcje

Wersja 3 została przeniesiona z publicznej wersji beta do ogólnej dostępności.

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

Dodaliśmy obsługę plików danych strukturalnych w wersji 7, a także wartość wyliczeniową 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

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_7

2 października 2023 r.

Nowe funkcje

Wprowadziliśmy wersję 3 w ramach publicznej wersji beta. Zawiera ona te zmiany:

• Możliwość pełnego zarządzania listami lokalizacji zbliż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 logiczne enableOptimizedTargeting, które zastępuje pole targetingExpansionLevel w obiekcie TargetingExpansionConfig.
• Wymaganie dotyczące pola billingConfig w zasobie Advertiser, które musi być uwzględniane 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 opisane w naszym przewodniku po migracji.

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

Wersja 3

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

• Zmieniono działanie tej metody:

  Metoda	Zmiany
  advertisers.locationLists.create	Obsługuje teraz tworzenie zasobów TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.patch	Obsługuje teraz aktualizowanie zasobów TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.bulkEdit	Obsługuje teraz edycję zbiorczą zasobów AssignedLocation w zasobach TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.create	Obecnie obsługuje 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 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 typu wyliczeniowego:

  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

• Dodaliśmy te wartości typu wyliczeniowego:

  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 rodzajów strategii ustalania stawek w przypadku 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ć YoutubeAndPartnersContentCategory używane przez element zamówienia podczas uwzględniania wartości przypisanych na poziomie reklamodawcy 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 typu wyliczeniowego:

  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 plików uporządkowanych danych (SDF) w wersji 6 w wersjach 1 i 2.

v2

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_6

v1

• Dodaliśmy te wartości typu wyliczeniowego:

  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 ma on wycofane pole excludeFirstPartyAudience ustawione na true. Pole excludeFirstPartyAudience zostanie wycofane i po 25 marca 2023 r. będzie miało wartość false.

v2

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• Dodaliśmy te wartości typu wyliczeniowego:

  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 kierowania na zasoby grupy reklam w YouTube. Dodaliśmy też nowe typy kierowania, które można pobrać i które są używane na poziomie grup reklam w YouTube. Więcej informacji znajdziesz na naszej nowej stronie przewodnika dotyczącej pobierania zasobów 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	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Dodano te pola:

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

• Dodaliśmy te wartości typu wyliczeniowego:

  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 typu wyliczeniowego:

  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 przeniesiona z publicznej wersji beta do ogólnej dostępności.

Dodaliśmy nowe pole assignedTargetingOptionIdAlias do zasobu AssignedTargetingOption, którego można używać zamiast pola assignedTargetingOptionId podczas pobierania i usuwania kierowania. To pole jest ustawiane tylko w przypadku przypisanych opcji kierowania typów kierowania, które są przypisywane za pomocą wyliczenia. Wartość aliasu to odpowiednia wartość wyliczeniowa w postaci ciągu znaków.

Dodano nowe pole billingConfig do zasobu Advertiser.

Dodaliśmy obsługę pobierania elementów zamówienia typu YouTube i sieć partnerów wideo Google w przypadku treści OTT, 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 te pola:

  Zasób	Pola
  Reklamodawca	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• Dodaliśmy te wartości typu wyliczeniowego:

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

• Zwiększyliśmy maksymalny rozmiar strony 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:

• Nie można było usuwać ani pobierać przypisanych opcji kierowania typów kierowania, które są przypisywane za pomocą wartości enum w wersji 2, za pomocą ich assignedTargetingOptionId. Zamiast tego oczekiwano, że użytkownicy będą używać wartości enum. Dzięki tej aktualizacji przypisane opcje kierowania można usuwać lub pobierać za pomocą wartości assignedTargetingOptionId lub wartości wyliczeniowej zidentyfikowanej przez nowe pole assignedTargetingOptionIdAlias w zasobie AssignedTargetingOption.
• Żądanie elementu zamówienia bulkUpdate nieprawidłowo używało parametru żądania advertisersId, co spowodowało zwrócenie błędu. W ramach tej aktualizacji poprawiliśmy metodę i zmieniliśmy nazwę parametru żądania z advertisersId na advertiserId.

27 października 2022 r.

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

Wprowadziliśmy obsługę zapisu kierowania w przypadku zamówień reklamowych na podzbiór typów kierowania, dodając metody create i delete do usługi advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Nowe funkcje

v2

• Dodaliśmy te metody:

  Usługa	Metody
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create usuń
  advertisers.lineItems	duplikat

v1

W wersji 1 nie dodano żadnych nowych funkcji.

20 września 2022 r.

Wprowadziliśmy wersję 2 w ramach publicznej wersji beta. Zawiera ona 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 kierowania zbiorczego w usłudze advertisers.lineItems, które umożliwiają edytowanie i pobieranie przypisanego kierowania w wielu elementach zamówienia za pomocą 1 żądania.
• Nowa metoda bulkUpdate, która umożliwia użytkownikom aktualizowanie entityStatus wielu elementów zamówienia w ramach jednej prośby.
• Nowa logika kierowania, która wymaga przypisywania i pobierania AssignedTargetingOption zasobów podzbioru typów kierowania za pomocą wartości wyliczeniowych zamiast identyfikatorów opcji kierowania pobieranych za pomocą usługi targetingTypes.targetingOptions.

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

W wersji 1 dodaliśmy obsługę 3 nowych giełd.

Nowe funkcje

v2

Poniżej znajdziesz listę zmian między wersjami 1 i 2:

• W wersji 2 dodano 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 zmieniliśmy 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
  partnerów	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Zasoby AssignedTargetingOption tych typów kierowania używają w wersji 2 wyliczeń do przypisywania kierowania. W przypadku zasobów AssignedTargetingOption tych typów kierowania w wersji 2 zaktualizowaliśmy też pole assignedTargetingOptionId, aby używać wersji tekstowych wartości typu wyliczeniowego:

  Typ kierowania	Typ wyliczeniowy
  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 te pola są wymagane:

  Zasób	Pola
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	środowisko
  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 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 usługi inventorySources i nowej usługi guaranteedOrders.

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

Włączyliśmy nową funkcję parametru zapytania filter w metodzie advertisers.creatives.list, która umożliwia użytkownikowi pobieranie tylko kreacji z parametrem updateTime przed lub po określonej sygnaturze czasowej.

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

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  guaranteedOrders	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

• Dodano te pola:

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

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_5_5

• Te metody listowania 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.

Dodano pole billableOutcome do obiektu InsertionOrder.

Wprowadziliśmy pole raiseBidForDeals w obiekcie MaximizeSpendBidStrategy, które umożliwia użytkownikom określenie, czy strategia określania stawek ma stosować 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 typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 lutego 2022 r.

Dodaliśmy obsługę tworzenia, aktualizowania i edytowania członków niektórych zasobów kierowania na listę klientówFirstAndThirdPartyAudience. Na stronie Prześlij listy odbiorców z kierowania na listę klientów w naszym nowym przewodniku Korzystanie z list odbiorców znajdziesz szczegółowe informacje o tym, jak korzystać z tych nowych funkcji.

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

Dodaliśmy możliwość pobierania i ustawiania, 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.

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  firstAndThirdPartyAudiences	create editCustomerMatchMembers patch

• 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 sekcji typu kierowania TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 listopada 2021 r.

Dodano pełną obsługę zarządzania algorytmami ustalania stawek niestandardowych i ich skryptami. 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 SDF, v5.4, przez dodanie wartości wyliczeniowej SdfVersion.

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	upload

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  SdfVersion	SDF_VERSION_5_4

14 września 2021 r.

Dodaliśmy obsługę kierowania na zbliżony obszar w sekcji typów kierowania TARGETING_TYPE_BUSINESS_CHAIN i TARGETING_TYPE_POI.

Dodaliśmy możliwość wyszukiwania dostępnych opcji kierowania TARGETING_TYPE_BUSINESS_CHAIN i TARGETING_TYPE_POI 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 zasobie Algorytm ustalania stawek niestandardowych oraz dodaliśmy obsługę typu algorytmu ustalania stawek niestandardowych GOAL_BUILDER_BASED.

Dodaliśmy 2 nowe wartości do wyliczenia Exchange.

Nowe funkcje

• Dodano te pola:

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

• Dodaliśmy te wartości typu wyliczeniowego:

  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 listowania 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 na zasoby reklamowe z włączonym Open Measurement w sekcji typu kierowaniaTARGETING_TYPE_OMID.

Zwiększyliśmy maksymalną liczbę przypisanych opcji kierowania, które mogą być zwracane na jednej stronie różnych metod list przypisanych opcji kierowania reklamodawcy, kampanii, zamówienia reklamowego i elementu zamówienia za pomocą parametru metody pageSize.

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  TargetingType	TARGETING_TYPE_OMID

• Zwiększyliśmy maksymalny rozmiar strony 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.

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

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

Dodano pole campaignBudgets do zasobu kampanii. 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ę treści natywnych w ramach nowego typu kierowania TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Wprowadziliśmy nowe pole prismaEnabled w zasobie reklamodawcy, które umożliwia użytkownikom włączenie integracji z narzędziem Prisma od 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 typu wyliczeniowego:

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

• W przypadku tych pól są teraz dostępne te wartości wyliczenia:

  Zasób	Pole	Wartości
  Reklamodawca	entityStatus	ENTITY_STATUS_PAUSED

29 kwietnia 2021 r.

Dodaliśmy nowe pola do zasobów Kanał i Lista wykluczających słów kluczowych, które zwracają liczbę elementów zamówienia korzystających z zasobu na potrzeby kierowania. Włączyliśmy nowe właściwości filter metody listy elementów zamówienia, które umożliwiają użytkownikowi pobieranie tylko tych elementów zamówienia, które w swoim kierowaniu używają określonych kanałów lub list wykluczających słów kluczowych.

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  Kanał	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

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

  Metoda	Pola
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30 marca 2021 r.

Dodano nową metodę do usługi elementu zamówienia, która generuje element zamówienia z konfiguracjami domyślnymi. Te wartości domyślne są oparte na danym typie produktu, a także na ustawieniach i przypisanym kierowaniu zamówienia reklamowego nadrzędnego.

Umożliwiliśmy pobieranie kierowania kampanii za pomocą nowej usługi kierowania kampanii i dodatkowej metody 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 treściami na kanale i listami wykluczających słów kluczowych. Zmiany te obejmują:

• Dodanie metod replace, które umożliwiają użytkownikowi całkowite zastąpienie istniejącej zawartości kanału lub listy wykluczających słów kluczowych.
• Usunięcie wymagania, aby w polach createdSites lub createdNegativeKeywords żądań edycji zbiorczej nie było istniejących elementów.
• Zwiększenie maksymalnej liczby elementów, które mogą być zwracane na pojedynczej stronie odpowiedzi listSites lub listNegativeKeywords.

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get 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 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 wyliczeniowych:

  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ę list zbiorczych, która umożliwia pobieranie kierowania przypisanego do zamówień reklamowych. Rozszerzyliśmy zasób kreacji, dodając pola kreacji tylko do danych wyjściowych, które mogą być używane przez kreacje audio innych firm. Dodano nowe typy celów skuteczności, które mogą być używane przez zasoby zamówienia reklamowego i kampanii.

Nowe funkcje

• Dodaliśmy te metody:

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

• Dodano te pola:

  Zasób	Pola
  Kreacja	mp3Audio oggAudio

• Dodaliśmy te wartości typu wyliczeniowego:

  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 zamówień reklamowych typu Telewizja i zarządzanie nimi oraz elementami zamówienia typu Over-The-Top dzięki wprowadzeniu nowego pola InsertionOrderType i nowej wartości wyliczeniowej LineItemType. Dodaliśmy obsługę elementów zamówienia promujących aplikacje mobilne za pomocą pola elementu zamówienia mobileApp. Rozszerzona obsługa pakietu wymiany, odbiorców (zdefiniowanych przez) Google i SDF dzięki dodatkowym wartościom typu wyliczeniowego. Wprowadziliś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 typu wyliczeniowego:

  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

• Poniższe metody listowania można teraz sortować i filtrować według tych pól:

  Metoda	Pola
  reklamodawców	updateTime

4 grudnia 2020 r.

Dodaliśmy możliwość wyszukiwania opcji kierowania na region geograficzny i filtrowania wyników metody listowania wielu zasobów według czasu ostatniej aktualizacji. Wprowadziliśmy nowy komunikat LineItemWarningMessage, który informuje użytkowników, kiedy element zamówienia korzysta z wycofanego kierowania geograficznego.

Nowe funkcje

• Dodaliśmy te metody:

  Usługa	Metody
  targetingTypes.targetingOptions	wyszukiwanie

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Poniższe metody listowania 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 ustawieniu mogą rozszerzać kierowanie elementu zamówienia, aby obejmowało użytkowników podobnych do tych z grup odbiorców, na które kierowane są reklamy. Dodano pola identyfikatora segmentu niestandardowego 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	aktywować create dezaktywować get list patch

• Dodano te pola:

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

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Te metody list są teraz filtrowane według tych pól:

  Metoda	Pola
  advertisers.lineItems.list	filter.triggerId

12 października 2020 r.

Wprowadziliśmy w zasobie elementu zamówienia komunikaty ostrzegawcze, które można pobrać, oraz typ celu skuteczności współczynnika klikalności (CTR). Dodano pole Added warningMessages jako pole, według którego można filtrować listę elementów zamówienia.

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

Nowe funkcje

• Dodano te pola:

  Zasób	Pola
  LineItem	warningMessages

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Te metody list są teraz filtrowane według tych pól:

  Metoda	Pola
  advertisers.lineItems.list	warningMessages

28 sierpnia 2020 r.

Dodaliśmy nowe pola do odpowiedzi metody kontroli reklamodawcy oraz nowe pola, które można filtrować, do różnych metod list.

Nowe funkcje

• Dodano te pola:

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

• Te metody list są teraz filtrowane 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, partnerami i kierowania na partnerów. Wprowadziliśmy narzędzia, które pomagają użytkownikom aktywnie unikać osiągania limitów jednostek na koncie. Dodaliśmy obsługę elementów zamówienia audio i używania algorytmów ustalania stawek niestandardowych w elementach zamówienia i zamówieniach reklamowych.

Nowe funkcje

• Dodano te usługi:

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

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

  Typ wyliczeniowy	Wartości
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Poniższe metody listowania można teraz sortować i filtrować według tych pól:

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

• Dodaliśmy te zakresy do korzystania z tych usług:

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

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 wyliczeniowe exchange.

Nowe funkcje

• Dodano te usługi:

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

• Dodano te pola:

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

• Dodaliśmy te wartości typu wyliczeniowego:

  Typ wyliczeniowy	Wartości
  Giełda	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Te metody list są teraz filtrowane według tych pól:

  Metoda	Pola
  advertisers.creatives.list	creativeId

2 czerwca 2020 r.

Wprowadziliśmy możliwość tworzenia, modyfikowania i wypełniania podzbioru podmiotów, na które można kierować reklamy, oraz możliwość modyfikowania kierowania na poziomie reklamodawcy w przypadku 3 typów kierowania: kanału, wykluczenia etykiety treści cyfrowych i wykluczenia kategorii kontrowersyjnych.

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

• Dodaliśmy te metody:

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

• Dodano te 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 podstawowe zarządzanie zasobami, które umożliwia tworzenie, pobieranie, aktualizowanie i usuwanie takich encji 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 patch
advertisers.assets	upload
advertisers.campaigns	create usuń get list patch
advertisers.channels	get list
advertisers.creatives	create usuń get list patch
advertisers.insertionOrders	create usuń get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create usuń get list patch
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 patch
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

9 marca 2020 r.

Udostępniliśmy interfejs Display & Video 360 API w wersji 1. To jest pierwsza wersja interfejsu API.

Znane problemy

Brak.