Sürüm Notları

Bu sayfada, Display & Video 360 API'si için sürüm notları sağlanmaktadır.

En son API sürümü: v3

4 Aralık 2024

Yeni Özellikler

Core ve Tubi Exchange değerleri için destek eklendi.

firstAndThirdPartyAudiences.list için izin verilen maksimum sayfa boyutu 200'tan 5000'e çıkarıldı. Kota kullanımınızı daha da optimize etmek için firstAndThirdPartyAudiences.list isteklerinizin pageSize parametresini güncelleyin.

v3

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:

  Yöntem	Yeni Maksimum Sayfa Boyutu
  firstAndThirdPartyAudiences.list	5000

22 Ekim 2024

Yeni Özellikler

Görüntüleme başına maliyet performans hedefi için destek eklendi.

Bağlı cihazların hedeflemesini ayarlama ve alma özelliği eklendi.

Üçüncü taraf doğrulayıcı hedefleme bölümüne yeni Adloox marka güvenliği ayarları eklendi.

Şu anda kapalı beta sürümünde olan v8 yapılandırılmış veri dosyalarını indirme desteği eklendi.

v3

• Aşağıdaki alanlar eklendi:

  Nesne

  Alanlar

  Adloox

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

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

Desteği sonlandırılan değerler

3 Ekim 2024'te kullanımdan kaldırılacağı için SDF 5.5 sürümü desteği kaldırıldı.

v3

• Aşağıdaki enum değerlerinin desteği sonlandırıldı:

  Enum	Değerler
  SdfVersion	SDF_VERSION_5_5

15 Ağustos 2024

Yeni Özellikler

Netflix Exchange türü için destek eklendi.

v3

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_NETFLIX

v2

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_NETFLIX

15 Temmuz 2024

Yeni Özellikler

Satır öğesi ve reklam grubu yapılandırılmış veri dosyalarının 3. sürümde QA biçiminde indirilmesi için destek eklendi.

v3

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  IdFilter	adGroupQaIds lineItemQaIds

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

17 Haziran 2024

Yeni Özellikler

Reklamveren seviyesinde atanan anahtar kelime hedeflemesini yönetme desteği eklendi.

Kampanya siparişi kaynağına yeni optimizationObjective alanı eklendi. optimizationObjective yalnızca izin verilenler listesindeki müşteriler tarafından kullanılabilir.

v3

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  InsertionOrder	optimizationObjective

• Aşağıdaki yöntemler artık aşağıdaki hedefleme türlerini desteklemektedir:

  Hedefleme Türü	Yöntemler
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• Aşağıdaki yöntemler artık aşağıdaki hedefleme türlerini desteklemektedir:

  Hedefleme Türü	Yöntemler
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

30 Mayıs 2024

Yeni Özellikler

Yapılandırılmış Veri Dosyaları (SDF) 7.1 sürümü için destek eklendi.

v3

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  SdfVersion	SDF_VERSION_7_1

v2

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  SdfVersion	SDF_VERSION_7_1

23 Nisan 2024

Yeni Özellikler

Yeni TPG türleri, exchange'ler ve uygulama platformları için destek eklendi.

v3

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  Kpi	kpiAlgorithmId

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	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

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

28 Şubat 2024

Yeni Özellikler

Üyeleri Müşteri Eşleştirme kitlelerinden açıkça kaldırma özelliği eklendi.

Yeni exchange'leri hedefleme desteği eklendi.

v3

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

29 Ocak 2024

Yeni Özellikler

Floodlight etkinliklerini yeni bir floodlightGroups.floodlightActivities hizmeti aracılığıyla alma özelliği eklendi.

Bir YouTube ve İş Ortakları satır öğesinin hedeflemesinde Google TV envanterini içerip içermediğini belirten yeni bir alan eklendi.

Display & Video 360 kullanıcısının son giriş zamanını iletmek için yeni bir alan eklendi.

v3

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  floodlightGroups.floodlightActivities	get list

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  Kullanıcı	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  floodlightGroups.floodlightActivities	get list

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  Kullanıcı	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

14 Kasım 2023

Yeni Özellikler

Tüm canlı sürümlerde Customer Match kitle üyelerini yüklerken son kullanıcı izninin iletilmesi için destek eklendi.

v3

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  ContactInfoList	consent
  MobileDeviceIdList	consent

v2

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  ContactInfoList	consent
  MobileDeviceIdList	consent

31 Ekim 2023

Yeni Özellikler

3. sürüm, herkese açık beta sürümünden genel kullanıma geçirildi.

İlgili biçimi daha doğru yansıtmak için v3'teki bir AdGroupFormat enum değeri yeniden adlandırıldı.

Sürüm 2 ve 3'te SDF_VERSION_7 enum değeri eklenerek Yapılandırılmış Veri Dosyaları sürüm 7 desteği eklendi.

v3

• Aşağıdaki enum değerleri kaldırıldı:

  Enum	Değerler
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  SdfVersion	SDF_VERSION_7

2 Ekim 2023

Yeni Özellikler

Herkese açık beta sürümünde 3. sürüm yayınlandı. Bu sürümde aşağıdaki değişiklikler yapıldı:

• Yakın çevredeki konum listelerini tamamen yönetme olanağı. Bu özellik, TARGETING_LOCATION_TYPE_PROXIMITY LocationList kaynaklarına atanan konumları oluşturmak ve silmek için advertisers.locationLists.assignedLocations hizmetinin kullanılmasını sağlar.
• TargetingExpansionConfig nesnesinde targetingExpansionLevel alanının yerini alan yeni bir boole enableOptimizedTargeting alanı.
• Advertiser kaynağında billingConfig alanının zorunlu olması (advertisers.create istekleri yapılırken dahil edilmelidir) ve Partner kaynağında yeni bir billingConfig alanının bulunması.
• 2. sürümdeki YoutubeAdGroup ve YoutubeAdGroupAd kaynaklarının yerini alan yeni AdGroup ve AdGroupAd kaynakları.

2. sürümden 3. sürüme geçmek için taşıma kılavuzumuzdaki adımları uygulayın.

Sürüm 2 ve 3'te 3 yeni LineItemType değeri, bir yeni YoutubeAndPartnersBiddingStrategyType ve bir yeni PartnerCostType değeri desteği eklendi.

v3

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	oluşturma get list

• Aşağıdaki yöntemler kaldırıldı:

  Hizmet	Yöntemler
  advertisers.manualTriggers	etkinleştir create devre dışı bırak get list patch
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Aşağıdaki yöntem davranışı değişti:

  Yöntem	Değişiklikler
  advertisers.locationLists.create	Artık TARGETING_LOCATION_TYPE_PROXIMITY LocationList kaynakları oluşturmayı destekler.
  advertisers.locationLists.patch	Artık TARGETING_LOCATION_TYPE_PROXIMITY LocationList kaynaklarını güncellemeyi destekliyor.
  advertisers.locationLists.assignedLocations.bulkEdit	Artık TARGETING_LOCATION_TYPE_PROXIMITY LocationList kaynaklarındaki AssignedLocation kaynaklarının toplu olarak düzenlenmesi desteklenmektedir.
  advertisers.locationLists.assignedLocations.create	Artık TARGETING_LOCATION_TYPE_PROXIMITY LocationList kaynaklarında AssignedLocation kaynakları oluşturmayı destekliyor.

• Aşağıdaki sorgu parametreleri eklenmiştir:

  Yöntem	Parametreler
  inventorySources.get	advertiserId

• Aşağıdaki alanlar zorunlu hale getirilmiştir:

  Kaynak	Alanlar
  Reklamveren	billingConfig

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  İş ortağı	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• Aşağıdaki alanlar kaldırıldı:

  Kaynak	Alanlar
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  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

• Aşağıdaki enum değerleri kaldırıldı:

  Enum	Değerler
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  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 Ağustos 2023

Yeni Özellikler

İki exchange ve iki yeni YouTube ve İş Ortakları teklif stratejisi türü için destek eklendi.

Hem reklamveren hem de satır öğesi düzeyinde atanan değerleri dikkate alırken satır öğesi tarafından kullanılan YoutubeAndPartnersContentCategory değerini göstermek için YouTube ve İş Ortakları satır öğelerine yeni bir effectiveContentCategory alanı eklendi.

v2

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  YoutubeAndPartnersSettings	effectiveContentCategory

• Aşağıdaki alanlar kaldırıldı:

  Kaynak	Alanlar
  InventorySource	subSitePropertyId

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

5 Haziran 2023

Yeni Özellikler

Yapılandırılmış Veri Dosyaları (SDF) sürüm 6 için sürüm 1 ve 2'ye yeni bir SdfVersion değeri eklendi.

v2

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  SdfVersion	SDF_VERSION_6

v1

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  SdfVersion	SDF_VERSION_6

9 Mart 2023

Yeni Özellikler

Desteği sonlandırılan excludeFirstPartyAudience alanı true olarak ayarlanmışsa satır öğesinin warningMessages alanına atanacak yeni bir LineItemWarningMessage değeri eklendi. excludeFirstPartyAudience alanı, 25 Mart 2023'ten sonra kullanımdan kaldırılacak ve false olarak ayarlanacak.

v2

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 Şubat 2023

Yeni Özellikler

YouTubeAdGroup ve YouTubeAdGroupAd kaynaklarının yanı sıra YouTube reklam grubu kaynak hedefleme özelliği eklendi. Ayrıca, YouTube reklam grupları düzeyinde kullanılan yeni, alınabilir hedefleme türleri de ekledik. Daha fazla bilgi için YouTube ve İş Ortakları kaynaklarını alma hakkındaki yeni rehber sayfamızı okuyun.

Sürüm 1 ve 2'de dört ek exchange için destek eklendi.

v2

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Aşağıdaki alanlar eklendi:

  Hizmet	Yöntemler
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	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

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

6 Aralık 2022

Yeni Özellikler

2. sürüm, herkese açık beta sürümünden genel kullanıma geçirildi.

AssignedTargetingOption kaynağına, hedeflemeyi alırken ve silerken assignedTargetingOptionId yerine kullanılabilecek yeni bir assignedTargetingOptionIdAlias alanı eklendi. Bu alan yalnızca enum aracılığıyla atanan hedefleme türlerinin atanmış hedefleme seçenekleri için ayarlanır. Takma ad değeri, ilgili enum değeridir ve dize olarak gösterilir.

Advertiser kaynağına yeni bir billingConfig alanı eklendi.

Üç yeni LineItemType değeriyle tanımlanan YouTube ve İş Ortakları yayın içi satır öğelerini alma desteği eklendi.

1. ve 2. sürümdeki birçok list yöntemi için maksimum sayfa boyutu 200'e çıkarıldı. Varsayılan sayfa boyutu değişmez.

v2

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  Reklamveren	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  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

• Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:

  Yöntem	Yeni Maksimum Sayfa Boyutu
  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

• Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:

  Yöntem	Yeni Maksimum Sayfa Boyutu
  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

Bilinen sorunlar

Bu güncelleme, v2'deki aşağıdaki bilinen sorunları giderir:

• v2'de enum değerleri kullanılarak atanan hedefleme türlerinin atanan hedefleme seçenekleri, assignedTargetingOptionId değerleri kullanılarak kaldırılamıyor veya alınamıyordu. Bunun yerine, kullanıcıların enum değerini kullanması bekleniyordu. Bu güncellemeyle, atanmış bu hedefleme seçenekleri assignedTargetingOptionId veya AssignedTargetingOption kaynağındaki yeni assignedTargetingOptionIdAlias alanıyla tanımlanan enum değeri kullanılarak kaldırılabilir ya da alınabilir.
• Satır öğesi bulkUpdate isteği, advertisersId istek parametresini doğru şekilde kullanmıyordu ve hata döndürüyordu. Bu güncellemeyle birlikte yöntem düzeltildi ve istek parametresi advertisersId yerine advertiserId olarak yeniden adlandırıldı.

27 Ekim 2022

Üst öğe InsertionOrder içinde mevcut bir satır öğesini kopyalama özelliği eklendi.

advertisers.insertionOrders.targetingTypes.assignedTargetingOptions hizmetine create ve delete yöntemlerinin eklenmesi ile hedefleme türlerinin bir alt kümesi için kısmi kampanya siparişi hedefleme yazma desteği kullanıma sunuldu.

Yeni Özellikler

v2

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	oluşturma sil
  advertisers.lineItems	duplicate

v1

1. sürüme yeni özellik eklenmemiştir.

20 Eylül 2022

2. sürüm, herkese açık beta sürümünde kullanıma sunuldu. Bu sürümde aşağıdaki değişiklikler yapıldı:

• advertisers.lineItems ve advertisers.lineItems.targetingTypes.assignedTargetingOptions hizmetlerinde get ve list yöntemlerini kullanarak YouTube ve iş ortakları satır öğelerini ve hedefleme ayarlarını alma olanağı.
• advertisers.lineItems hizmetinde, tek bir istekle birden fazla satır öğesinde atanmış hedeflemeyi düzenleme ve alma olanağı sunan iki yeni toplu hedefleme yöntemi.
• Kullanıcıların tek bir istekle birden fazla satır öğesinin entityStatus güncellemesine olanak tanıyan yeni bir bulkUpdate yöntemi.
• Hedefleme türlerinin alt kümesinin AssignedTargetingOption kaynaklarının, targetingTypes.targetingOptions hizmeti kullanılarak alınan hedefleme seçeneği kimlikleri yerine enum değerleri kullanılarak atanmasını ve alınmasını gerektiren yeni hedefleme mantığı.

1. sürümden 2. sürüme geçmek için taşıma kılavuzumuzdaki adımları uygulayın.

Sürüm 1'de üç yeni exchange için destek eklendi.

Yeni Özellikler

v2

Aşağıda, v1 ile v2 arasındaki değişikliklerin listesi verilmiştir:

• 2. sürüme aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• Aşağıdaki yöntemler v2'de kaldırılmıştır:

  Hizmet	Yöntemler
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• Aşağıdaki yöntemler 2. sürümde yeniden adlandırıldı:

  Hizmet	Eski Yöntem Adı	Yeni Yöntem Adı
  reklamverenler	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Aşağıdaki hedefleme türlerinin AssignedTargetingOption kaynakları, v2'de hedefleme ataması için enums kullanır. Bu hedefleme türlerinin AssignedTargetingOption kaynakları için assignedTargetingOptionId alanı da v2'de, enum değerlerinin dize sürümlerini kullanacak şekilde güncellendi:

  Hedefleme Türü	Enum Türü
  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	Ortam
  TARGETING_TYPE_EXCHANGE	Exchange
  TARGETING_TYPE_GENDER	Cinsiyet
  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	Görüntülenebilirlik

• V2'ye aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	exchange
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• Aşağıdaki alanlar v2'de kaldırılmıştır:

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

• Aşağıdaki alanlar 2. sürümde zorunlu hale getirilmiştir:

  Kaynak	Alanlar
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	environment
  ExchangeAssignedTargetingOptionDetails	exchange
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	viewability

• Aşağıdaki enum değerleri v2'ye eklendi:

  Enum	Değerler
  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
  Exchange	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

• Aşağıdaki enum değerleri v2'de kaldırılmıştır:

  Enum	Değerler
  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

• 1. sürüme aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26 Mayıs 2022

Yeni inventorySources hizmet yazma yöntemleri ve yeni bir guaranteedOrders hizmeti aracılığıyla InventorySource kaynakları oluşturma ve GuaranteedOrder kaynaklarını yönetme özelliği eklendi.

CustomBiddingAlgorithm kaynağında modelReadiness alanı kullanıma sunuldu. Bu alanda, algoritmanın modelinin erişebilen her reklamveren için hazırlık durumu listelenir.

advertisers.creatives.list yöntemi için yeni filter sorgu parametresi işlevi etkinleştirildi. Bu işlev, kullanıcının yalnızca belirli bir zaman damgasından önce veya sonra updateTime içeren reklam öğelerini almasına olanak tanır.

SdfVersion enum değeri eklenerek en yeni SDF sürümü olan v5.5 için destek eklendi.

Yeni Özellikler

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  guaranteedOrders	oluşturma editGuaranteedOrderReadAccessors get list yama
  inventorySources	oluşturma editInventorySourceReadWriteAccessors yama

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  SdfVersion	SDF_VERSION_5_5

• Aşağıdaki liste yöntemleri artık aşağıdaki özelliklere göre filtrelenebilir:

  Yöntem	Alanlar
  advertisers.creatives.list	updateTime

31 Mart 2022

İçerik süresi, yayın türü ve tür için hedefleme alma ve ayarlama desteği eklendi.

InsertionOrder nesnesine billableOutcome alanı eklendi.

MaximizeSpendBidStrategy nesnesine raiseBidForDeals alanını ekleyerek kullanıcıların, teklif stratejisinin hedeflenen anlaşmalar için reklamveren taban fiyatlarını uygulayıp uygulamayacağını ayarlamalarına olanak tanıdık.

Yeni Özellikler

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 Şubat 2022

Belirli Müşteri Eşleştirme FirstAndThirdPartyAudience kaynakları için kaynak oluşturma, kaynağı güncelleme ve kaynak üyelerini düzenleme desteği eklendi. Yeni Kitleleri Kullanma kılavuzumuzun Müşteri Eşleştirme Kitlelerini Yükleme sayfasında bu yeni özelliklerin nasıl kullanılacağı ayrıntılı olarak açıklanmıştır.

InsertionOrder ve LineItem kaynaklarında, bir kaynağın Etiket Garantili, Programatik Garantili veya garantili olmadığını tanımlayan yeni bir reservationType alanı kullanıma sunuldu.

Bir satır öğesinin yeni exchange'leri otomatik olarak hedefleyip hedeflemediğini yeni bir excludeNewExchanges alanından alıp ayarlama özelliği eklendi.

Yeni özelliklere ek olarak varsayılan kota sınırları iki katına çıkarıldı.

Yeni Özellikler

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  firstAndThirdPartyAudiences	oluşturma editCustomerMatchMembers yama

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

8 Aralık 2021

Hedefleme türü TARGETING_TYPE_AUDIO_CONTENT_TYPE altında işitsel içerik türü hedefleme desteği eklendi.

Yeni Özellikler

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 Kasım 2021

Özel teklif verme algoritmalarını ve komut dosyalarını yönetmek için tam destek eklendi. Bunlardan bazıları:

• Yeni customBiddingAlgorithms oluşturma ve mevcut customBiddingAlgorithms'i güncelleme işlevleri.
• Kullanılabilir bir kaynak konumu alma ve ardından dosyayı bu konuma yükleme işlemiyle komut dosyaları yükleme olanağı.
• customBiddingScripts öğesini almak ve oluşturmak için yeni bir customBiddingAlgorithms.scripts hizmeti.

Satır Öğelerini Yönetme rehberimize, özel teklif verme algoritması oluşturma, komut dosyası yükleme ve özel teklif verme algoritmasını satır öğesinin teklif stratejisi olarak atama sürecini açıklayan yeni bir Özel Teklif Verme'yi Uygulama sayfası eklendi.

SdfVersion enum değeri eklenerek en yeni SDF sürümü olan v5.4 için destek eklendi.

Yeni Özellikler

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  customBiddingAlgorithms	oluşturma yama uploadScript
  customBiddingAlgorithms.scripts	oluşturma get list
  media	upload

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  SdfVersion	SDF_VERSION_5_4

14 Eylül 2021

TARGETING_TYPE_BUSINESS_CHAIN ve TARGETING_TYPE_POI hedefleme türleri altında yakın çevredeki hedef için destek eklendi.

targetingTypes.targetingOptions.get veya targetingTypes.targetingOptions.list yöntemleriyle alınamadıkları için targetingTypes.targetingOptions.search kullanılarak mevcut TARGETING_TYPE_BUSINESS_CHAIN ve TARGETING_TYPE_POI hedefleme seçeneklerini arama özelliği eklendi.

Özel Teklif Verme Algoritması kaynağına yeni sharedAdvertiserIds ve customBiddingAlgorithmState alanları eklendi ve GOAL_BUILDER_BASED özel teklif verme algoritması türü için destek sağlandı.

Exchange dizine iki yeni değer eklendi.

Yeni Özellikler

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search İstek Metni	businessChainSearchTerms poiSearchTerms

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• Aşağıdaki liste yöntemleri artık aşağıdaki özelliklere göre filtrelenebilir:

  Yöntem	Alanlar
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4 Ağustos 2021

TARGETING_TYPE_OMID hedefleme türü altında Open Measurement etkin envanter hedefleme desteği eklendi.

pageSize yöntem parametresi kullanılarak çeşitli reklamveren, kampanya, kampanya siparişi ve satır öğesi atanmış hedefleme seçeneği listesi yöntemlerinin tek bir sayfada döndürülebilecek maksimum atanmış hedefleme seçeneği sayısı artırıldı.

Yeni Özellikler

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  TargetingType	TARGETING_TYPE_OMID

• Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:

  Yöntem	Yeni Maksimum Sayfa Boyutu
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

26 Mayıs 2021

Kullanıcıların aşağıdakileri yapmasına olanak tanıyan advertisers.invoices hizmetini kullanıma sundu:

• Belirli bir ay içinde bir reklamverene düzenlenen faturaları alabilir.
• Belirli bir ay içinde bir reklamveren tarafından kullanılan para birimi kodunu arayın.

Kampanya kaynağına campaignBudgets alanı eklendi. Kampanya siparişi bütçe segmentleri, kampanya bütçesine bağlanabilir. Bu durumda, ilişkili segmentlerin toplam bütçesi, toplam kampanya bütçesi tutarıyla sınırlandırılır.

Yeni hedefleme türü TARGETING_TYPE_NATIVE_CONTENT_POSITION altında yerel içerik konum hedefleme desteği eklendi.

Reklamveren kaynağına yeni bir prismaEnabled alanı eklendi. Bu alan, kullanıcıların Mediaocean'un Prisma aracıyla entegrasyonu etkinleştirmesine olanak tanır.

Reklamverenin entityStatus alanında ENTITY_STATUS_PAUSED enum değeri desteği etkinleştirildi.

Yeni Özellikler

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  advertisers.invoices	list lookupInvoiceCurrency

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  Reklamveren	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Kampanya	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• Aşağıdaki enum değerleri artık aşağıdaki alanlar için geçerlidir:

  Kaynak	Alan	Değerler
  Reklamveren	entityStatus	ENTITY_STATUS_PAUSED

29 Nisan 2021

Kanal ve Negatif Anahtar Kelime Listesi kaynaklarına, hedefleme için kaynağı kullanan satır öğelerinin sayısını döndüren yeni alanlar eklendi. Satır öğesi listesi yöntemi için kullanıcının hedeflemesinde yalnızca belirli kanalları veya negatif anahtar kelime listelerini kullanan satır öğelerini almasına olanak tanıyan yeni filter özellikleri etkinleştirildi.

Yeni Özellikler

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  Channel	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• Aşağıdaki liste yöntemleri artık aşağıdaki özelliklere göre filtrelenebilir:

  Yöntem	Alanlar
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30 Mart 2021

Satır öğesi hizmetine varsayılan yapılandırmalara sahip bir satır öğesi oluşturan yeni bir yöntem eklendi. Bu varsayılan değerler, belirli satır öğesi türüne ve üst kampanya siparişinin ayarlarına ve atanmış hedeflemesine bağlıdır.

Yeni bir kampanya hedefleme hizmeti ve ek toplu liste yöntemi aracılığıyla kampanya hedeflemesinin alınmasını etkinleştirdi.

Daha fazla platformda uygulama hedeflemesine izin vermek için uygulama hedeflemeyi genişlettik.

Kanal ve negatif anahtar kelime listesi içeriğinin daha kolay yönetilebilmesi için advertisers.channels.sites, partners.channels.sites ve advertisers.negativeKeywordLists.negativeKeywords hizmetlerinde birden fazla değişiklik yapıldı. Bu değişiklikler şunları içerir:

• Kullanıcıların bir kanalın veya negatif anahtar kelime listesinin mevcut içeriklerinin tamamını replace yöntemleriyle tamamen üzerine yazmasına olanak tanınması.
• Toplu düzenleme isteklerinin createdSites veya createdNegativeKeywords alanlarına mevcut öğelerin dahil edilmemesi şartının kaldırılması.
• Siteleri listele veya negatif anahtar kelimeleri listele yanıtının tek bir sayfasında döndürülebilecek maksimum öğe sayısının artması.

Yeni Özellikler

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:

  Yöntem	Eski Maksimum Sayfa Boyutu	Yeni Maksimum Sayfa Boyutu
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

Kullanımdan kaldırmalar

• Aşağıdaki numaralandırma değerleri artık yeni veya mevcut kaynaklara atanamaz:

  Enum	Değerler
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24 Şubat 2021

Kampanya siparişlerine atanan hedeflemenin alınmasını sağlayan yeni bir kampanya siparişi hedefleme hizmeti ve ek toplu liste yöntemi kullanıma sunuldu. Üçüncü taraf ses reklam öğeleri tarafından kullanılmak üzere yalnızca çıkış reklam öğesi alanları ekleyerek reklam öğesi kaynağını genişlettik. Kampanya siparişi ve kampanya kaynaklarının kullanabileceği yeni performans hedefi türleri eklendi.

Yeni Özellikler

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  Reklam öğesi	mp3Audio oggAudio

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  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 Ocak 2021

Yeni bir InsertionOrderType alanı ve yeni bir LineItemType enum değeri kullanıma sunuldu. Bu sayede TV kampanya siparişlerinin ve baypas satır öğelerinin alınması ve yönetilmesi etkinleştirildi. mobileApp satır öğesi alanı aracılığıyla mobil uygulama satır öğeleri için destek eklendi. Ek enum değerleri aracılığıyla genişletilmiş exchange, google audience ve SDF desteği. advertisers.list değerlerini son güncellenme zamanına göre filtreleme ve sıralama özelliği kullanıma sunuldu.

Yeni Özellikler

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  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

• Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre sıralanabilir ve filtrelenebilir:

  Yöntem	Alanlar
  reklamverenler	updateTime

4 Aralık 2020

Coğrafi Bölge hedefleme seçeneklerini arama ve birden fazla kaynak listesi yöntemi sonucunu son güncellenme zamanlarına göre filtreleme özelliği eklendi. Kullanıcıları, bir satır öğesinin desteği sonlandırılmış coğrafi hedeflemeyi ne zaman kullandığı konusunda bilgilendirmek için yeni bir LineItemWarningMessage özelliği kullanıma sunuldu.

Yeni Özellikler

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  targetingTypes.targetingOptions	search

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre sıralanabilir ve filtrelenebilir:

  Yöntem	Alanlar
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

5 Kasım 2020

İlişkili satır öğelerinin harcamasını başlatan manuel tetikleyiciler oluşturma, atama ve etkinleştirme özelliği eklendi. Ayarlandığında bir satır öğesinin hedeflemesini, hedeflenen kitlelerdeki kullanıcılara benzer kullanıcıları içerecek şekilde genişletebilen hedefleme genişletme seçenekleri kullanıma sunuldu. Üçüncü taraf doğrulama hedeflemesinde kullanılan DoubleVerify ve Integral Ad Science nesnelerine özel segment kimliği alanları eklendi.

Yeni Özellikler

• Aşağıdaki hizmetler eklendi:

  Hizmet	Yöntemler
  advertisers.manualTriggers	etkinleştir create deactivate get list patch

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre filtrelenebilir:

  Yöntem	Alanlar
  advertisers.lineItems.list	filter.triggerId

12 Ekim 2020

Satır öğesi kaynağına alınabilir uyarı mesajları ve tıklama oranı (TO) performans hedefi türü eklendi. Satır öğeleri listelenirken filtrelenebilir bir alan olarak warningMessages eklendi.

Yeni özelliklere ek olarak yeni kota sınırları geçerli oldu ve toplu isteklerin kullanımı ile ilgili yeni dokümanlar kullanıma sunuldu.

Yeni Özellikler

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  LineItem	warningMessages

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre filtrelenebilir:

  Yöntem	Alanlar
  advertisers.lineItems.list	warningMessages

28 Ağustos 2020

Reklamveren denetim yönteminin yanıtına yeni alanlar ve çeşitli liste yöntemlerine filtrelenebilir yeni alanlar eklendi.

Yeni Özellikler

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre filtrelenebilir:

  Yöntem	Alanlar
  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 Ağustos 2020

Yeni kullanıcı yönetimi, iş ortağı ve iş ortağı hedefleme hizmetleri kullanıma sunuldu. Kullanıcıların hesap öğesi sınırlarına ulaşmasını proaktif olarak önlemesine yardımcı olacak araçlar kullanıma sunuldu. İşitsel satır öğeleri ve satır öğeleri ile kampanya siparişi teklif stratejilerinde özel teklif verme algoritmalarının kullanılması için destek eklendi.

Yeni Özellikler

• Aşağıdaki hizmetler eklendi:

  Hizmet	Yöntemler
  customBiddingAlgorithms	get list
  iş ortakları	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create delete get list
  users	bulkEditAssignedUserRoles create delete get list patch

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  reklamverenler	denetim

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre sıralanabilir ve filtrelenebilir:

  Yöntem	Alanlar
  advertisers.lineItems.list	flight.dateRange.endDate

• Aşağıdaki hizmetler için aşağıdaki kapsamlar eklendi:

  Kapsam	Hizmetler
  https://www.googleapis.com/auth/display-video-user-management	users

24 Haziran 2020

İş ortağı ve reklamveren kanalları için bir oluşturma yöntemi, yeni FirstAndThirdPartyAudience alanları ve ek exchange enum değerleri ekleyen küçük bir güncelleme kullanıma sunuldu.

Yeni Özellikler

• Aşağıdaki hizmetler eklendi:

  Hizmet	Yöntemler
  advertisers.channels	create
  partners.channels	create

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType description displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• Aşağıdaki enum değerleri eklendi:

  Enum	Değerler
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Aşağıdaki liste yöntemleri artık aşağıdaki alanlara göre filtrelenebilir:

  Yöntem	Alanlar
  advertisers.creatives.list	creativeId

2 Haziran 2020

Hedeflenebilir öğelerin alt kümesini oluşturma, yamalar uygulama ve doldurma özelliği kullanıma sunuldu. Ayrıca üç hedefleme türü (kanal, dijital içerik etiketi hariç tutma ve hassas kategori hariç tutma) için reklamveren düzeyinde hedeflemeyi değiştirme özelliği eklendi.

Yeni Özellikler

• Aşağıdaki hizmetler eklendi:

  Hizmet	Yöntemler
  advertisers.channels.sites	bulkEdit create delete list
  advertisers.locationLists.assignedLocations	bulkEdit create delete list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create delete list
  advertisers.targetingTypes.assignedTargetingOptions	create delete get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create delete list
  partners.channels.sites	bulkEdit create delete list

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  reklamverenler	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create delete patch
  inventorySourceGroups	create delete patch
  partners.channels	patch

• Aşağıdaki alanlar eklendi:

  Kaynak	Alanlar
  reklamveren	servingConfig
  creative	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27 Nisan 2020

API'nin kapsamını SDF'nin ötesine genişleten büyük bir özellik grubu kullanıma sunuldu. Reklamverenler, kampanyalar, kampanya siparişleri, satır öğeleri ve reklam öğeleri gibi öğeleri oluşturmanıza, almanız, güncellemenize ve silmenize olanak tanıyan temel kaynak yönetimi eklendi. Yeni özellikler, hedeflemenin satır öğesi düzeyinde düzenlenmesine de olanak tanır.

Yeni Özellikler

Aşağıdaki hizmetler eklendi:

Hizmet	Yöntemler
reklamverenler	create delete get list patch
advertisers.assets	upload
advertisers.campaigns	create delete get list patch
advertisers.channels	get list
advertisers.creatives	create delete get list patch
advertisers.insertionOrders	create delete get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create delete get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create delete 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 Mart 2020

Display & Video 360 API v1 kullanıma sunuldu. Bu, API'nin ilk sürümüdür.

Bilinen sorunlar

Yok.