Bu sayfada Display & Video 360 API'si için sürüm notları sağlanmaktadır.
En son API sürümü: v3
17 Haziran 2024
Yeni Özellikler
Reklamveren düzeyinde atanan anahtar kelime hedeflemeyi 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 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
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
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 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 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 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.
YouTube ve İş Ortakları satır öğesinin, hedeflemesine Google TV envanterini dahil edip etmediğini bildiren yeni bir alan eklendi.
Bir Display & Video 360 kullanıcısının son giriş zamanını geçirmek için yeni bir alan eklendi.
v3
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler floodlightGroups.floodlightActivities Aşağıdaki alanlar eklendi:
Kaynak Alanlar Kullanıcı YoutubeAndPartnersInventorySourceConfig
v2
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler floodlightGroups.floodlightActivities Aşağıdaki alanlar eklendi:
Kaynak Alanlar Kullanıcı YoutubeAndPartnersInventorySourceConfig
14 Kasım 2023
Yeni Özellikler
Tüm canlı sürümlerde Müşteri Eşleştirme kitle üyelerini yüklerken son kullanıcı iznini iletme desteği eklendi.
v3
Aşağıdaki alanlar eklendi:
Kaynak Alanlar ContactInfoList MobileDeviceIdList
v2
Aşağıdaki alanlar eklendi:
Kaynak Alanlar ContactInfoList MobileDeviceIdList
31 Ekim 2023
Yeni Özellikler
v3 herkese açık betadan çıkarılıp genel kullanıma sunuldu.
v3'teki bir AdGroupFormat
sıralama değeri, ilgili biçimi daha doğru şekilde yansıtmak için yeniden adlandırıldı.
v2 ve v3'te SDF_VERSION_7
sıralama değerinin eklenmesiyle Yapılandırılmış Veri Dosyaları v7 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
Aşağıdaki değişiklikleri içeren v3 herkese açık beta olarak yayınlandı:
- Yakın çevredeki konum listelerini tümüyle yöneterek
TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarına atanmış konumları oluşturmak ve silmek içinadvertisers.locationLists.assignedLocations
hizmetinin kullanılmasını sağlama. TargetingExpansionConfig
nesnesindekitargetingExpansionLevel
alanının yerini alan yeni booleenableOptimizedTargeting
alanı.Advertiser
kaynağındakibillingConfig
alanının gerekliliği.advertisers.create
istekleri yapılırken bu alanın eklenmesi vePartner
kaynakta yenibillingConfig
alanının eklenmesi gerekir.- Sürüm 2'deki
YoutubeAdGroup
veYoutubeAdGroupAd
kaynaklarının yerini alan yeniAdGroup
veAdGroupAd
kaynakları.
v2'den v3'e geçiş yapmak için taşıma rehberimizdeki adımları uygulayın.
v2 ve v3'te 3 yeni LineItemType
değeri, bir yeni YoutubeAndPartnersBiddingStrategyType
ve bir yeni PartnerCostType
için destek eklendi.
v3
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 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ının oluşturulmasını destekliyor.advertisers.locationLists.patch Artık TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarının güncellenmesini destekliyor.advertisers.locationLists.assignedLocations.bulkEdit Artık TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarındakiAssignedLocation
kaynaklarının toplu olarak düzenlenmesini destekliyor.advertisers.locationLists.assignedLocations.create Artık TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarındaAssignedLocation
kaynaklarının oluşturulmasını destekliyor.Aşağıdaki sorgu parametreleri eklendi:
Yöntem Parametreler inventorySources.get Aşağıdaki alanlar zorunlu hale getirildi:
Kaynak Alanlar Reklamveren Aşağıdaki alanlar eklendi:
Kaynak Alanlar BiddingStrategy InsertionOrder İş Ortağı TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig 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 seviyesinde atanan değerler göz önünde bulundurulduğunda satır öğesi tarafından kullanılan YoutubeAndPartnersContentCategory
'in gösterilmesi için YouTube ve İş Ortakları satır öğelerine yeni bir effectiveContentCategory
alanı eklendi.
v2
Aşağıdaki alanlar eklendi:
Kaynak Alanlar YoutubeAndPartnersSettings 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
v1 ve v2'de Yapılandırılmış Veri Dosyaları (SDF) v6 için 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
Kullanımdan kaldırılan excludeFirstPartyAudience
alanının true
olarak ayarlanması durumunda 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ı alma özelliğinin yanı sıra YouTube Reklam Grubu kaynak hedefleme özelliği eklendi. Ayrıca YouTube Reklam Grupları düzeyinde kullanılan yeni uygulanabilir hedefleme türleri de ekledik. Daha fazla bilgi için YouTube ve İş Ortakları kaynaklarına ulaşma konulu yeni kılavuz sayfamızı okuyun.
v1 ve v2'de dört ek exchange için destek eklendi.
v2
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Aşağıdaki alanlar eklendi:
Hizmet Yöntemler AssignedTargetingOption YoutubeAndPartnersSettings 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
v2 herkese açık betadan çıkarılıp genel kullanıma sunuldu.
AssignedTargetingOption
kaynağına, hedefleme alınırken ve silinirken assignedTargetingOptionId
öğesinin yerine kullanılabilecek yeni bir assignedTargetingOptionIdAlias
alanı eklendi.
Bu alan, yalnızca sıralama aracılığıyla atanan hedefleme türlerinin atanmış hedefleme seçenekleri için ayarlanır. Takma ad değeri, dize olarak ilgili enum değeridir.
Advertiser
kaynağına yeni bir billingConfig
alanı eklendi.
Üç yeni LineItemType
değeriyle tanımlanan YouTube ve İş Ortakları baypas satır öğelerini alma desteği eklendi.
v1 ve v2'de çok sayıda list
yöntemi için maksimum sayfa boyutu 200'e yükseltildi. Varsayılan sayfa boyutu değişmez.
v2
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Reklamveren AssignedTargetingOption 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ı:
v1
Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:
Bilinen sorunlar
Bu güncelleme, v2'de bilinen aşağıdaki bilinen sorunları düzeltir:
- v2'deki numaralandırma değerleri kullanılarak atanan hedefleme türlerinin atanmış hedefleme seçenekleri,
assignedTargetingOptionId
kullanılarak kaldırılamamıştır veya alınamamıştır. Bunun yerine, kullanıcıların enum değerini kullanması bekleniyordu. Bu güncellemeyle birlikte, atanan bu hedefleme seçenekleriassignedTargetingOptionId
veyaAssignedTargetingOption
kaynağındaki yeniassignedTargetingOptionIdAlias
alanıyla tanımlanan enum değeri kullanılarak kaldırılabilir veya alınabilir. bulkUpdate
satır öğesi isteği,advertisersId
istek parametresini doğru şekilde kullanmıyordu ve bir hata döndürdü. Bu güncellemeyle birlikte yöntem düzeltildi ve istek parametresiadvertisersId
ikenadvertiserId
olarak yeniden adlandırıldı.
27 Ekim 2022
Üst InsertionOrder
içindeki mevcut bir satır öğesini kopyalama özelliği eklendi.
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
hizmetine create
ve delete
yöntemlerinin eklenmesiyle birlikte 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 advertisers.lineItems
v1
v1'e yeni özellik eklenmedi.
20 Eylül 2022
Aşağıdaki değişiklikleri içeren v2 herkese açık beta olarak yayınlandı:
advertisers.lineItems
veadvertisers.lineItems.targetingTypes.assignedTargetingOptions
hizmetlerindeget
velist
yöntemlerini kullanarak YouTube ve İş Ortakları satır öğelerini ve bunların hedefleme ayarlarını alma özelliği.advertisers.lineItems
hizmetinde, tek bir istekle birden fazla satır öğesinde atanan hedeflemeyi düzenlemeyi ve almayı sağlayan iki yeni toplu hedefleme yöntemi.- Kullanıcıların tek bir istekte birden fazla satır öğesinin
entityStatus
değerini güncellemesine olanak tanıyan yeni birbulkUpdate
yöntemi. AssignedTargetingOption
Hedefleme türleri alt kümesi kaynaklarının,targetingTypes.targetingOptions
hizmeti kullanılarak alınan hedefleme seçeneği kimlikleri yerine numaralandırma değerleri kullanılarak atanmasını ve alınmasını gerektiren yeni hedefleme mantığı.
v1'den v2'ye geçiş yapmak için taşıma rehberimizdeki adımları uygulayın.
v1'de üç yeni exchange için destek eklendi.
Yeni Özellikler
v2
Aşağıda, v1 ve v2 arasındaki değişikliklerin bir listesi verilmiştir:
Aşağıdaki yöntemler v2'ye eklenmiştir:
Hizmet Yöntemler advertisers.lineItems bulkEditAssignedTargetingOptions
Aşağıdaki yöntemler v2'de kaldırılmıştır:
Hizmet Yöntemler advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Aşağıdaki yöntemler v2'de yeniden adlandırılmıştır:
Hizmet Eski Yöntem Adı Yeni Yöntem Adı reklamverenler bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Aşağıdaki hedefleme türlerinin
AssignedTargetingOption
kaynakları, v2'deki hedefleme ataması için enum'ları kullanır. Bu hedefleme türlerininAssignedTargetingOption
kaynaklarınınassignedTargetingOptionId
alanı, enum değerlerinin dize sürümlerini kullanmak için v2'de de 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:
Aşağıdaki alanlar v2'de kaldırıldı:
v2'de aşağıdaki alanlar zorunlu hale getirildi:
v2'de aşağıdaki sıralama değerleri 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 sıralama değerleri v2'de kaldırıldı:
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
v1'e aşağıdaki sıralama değerleri eklendi:
Enum Değerler Exchange EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 Mayıs 2022
Yeni inventorySources
hizmeti yazma yöntemleri ve yeni guaranteedOrders
hizmetiyle 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 modeline erişebilen her reklamveren için modelin hazırlık durumu listelenir.
advertisers.creatives.list
yöntemi için kullanıcının yalnızca belirli bir zaman damgasından önce veya sonra updateTime
içeren reklam öğelerini almasına olanak tanıyan yeni filter
sorgu parametresi işlevi etkinleştirildi.
SdfVersion
sıralama değeri eklenerek en yeni SDF sürümü v5.5 için destek eklendi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler guaranteedOrders inventorySources Aşağıdaki alanlar eklendi:
Kaynak Alanlar CustomBiddingAlgorithm InventorySource Aşağıdaki enum değerleri eklendi:
Enum Değerler SdfVersion Aşağıdaki liste yöntemleri artık aşağıdaki özellikler tarafından filtrelenebilir:
Yöntem Alanlar advertisers.creatives.list
31 Mart 2022
İçerik süresi, akış türü ve tür ile ilgili hedeflemeyi alma ve ayarlama desteği eklendi.
billableOutcome
alanı InsertionOrder
nesnesine eklendi.
raiseBidForDeals
alanı MaximizeSpendBidStrategy
nesnesine eklendi. Böylece kullanıcılar, teklif verme stratejisinin hedeflenen anlaşmalar için reklamveren taban fiyatları uygulayıp uygulamayacağını ayarlayabilir.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler TargetingType
2 Şubat 2022
Belirli Müşteri Eşleştirme FirstAndThirdPartyAudience
kaynaklarının üyelerini oluşturma, güncelleme ve düzenleme için destek eklendi. Yeni Kitleleri kullanma kılavuzumuzdaki Müşteri Eşleştirme kitlelerini yükleme sayfasında bu yeni özelliklerin nasıl kullanılacağı ayrıntılı olarak açıklanmaktadı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 bir excludeNewExchanges
alanı aracılığıyla yeni exchange'leri otomatik olarak hedefleyip hedeflemeyeceğini alma ve ayarlama özelliği eklendi.
Yeni özelliklerin yanı sıra varsayılan kota sınırları iki katına çıkarılmıştır.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler firstAndThirdPartyAudiences Aşağıdaki alanlar eklendi:
Kaynak Alanlar FirstAndThirdPartyAudience InsertionOrder LineItem
8 Aralık 2021
TARGETING_TYPE_AUDIO_CONTENT_TYPE
hedefleme türü altına işitsel içerik türü hedefleme desteği eklendi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption TargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler TargetingType
8 Kasım 2021
Özel teklif verme algoritmalarını ve komut dosyalarını yönetmek için tam destek eklendi. Bu tür içerikler aşağıdakileri kapsar:
- Yeni oluşturma ve mevcut güncelleme işlevleri
customBiddingAlgorithms
. - Kullanılabilir bir kaynak konumu alma ve ardından dosyayı bu konuma yükleme işlemiyle komut dosyaları yükleme olanağı.
- Alma ve oluşturma
customBiddingScripts
için yeni bircustomBiddingAlgorithms.scripts
hizmeti.
Satır Öğelerini Yönetme kılavuzumuza Özel Teklif Vermeyi Uygulama sayfası eklendi. Bu sayfa; özel teklif verme algoritması oluşturma, komut dosyası yükleme ve özel teklif verme algoritmasını satır öğesinin teklif stratejisi olarak atama süreçlerini açıklar.
SdfVersion
sıralama değeri eklenerek en yeni SDF sürümü v5.4 için destek eklendi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler customBiddingAlgorithms customBiddingAlgorithms.scripts medya Aşağıdaki enum değerleri eklendi:
Enum Değerler SdfVersion
14 Eylül 2021
TARGETING_TYPE_BUSINESS_CHAIN
ve TARGETING_TYPE_POI
hedefleme türlerinin altına yakın çevredeki hedef için destek eklendi.
targetingTypes.targetingOptions.get
veya targetingTypes.targetingOptions.list
yöntemleriyle alınamadığı için targetingTypes.targetingOptions.search
ile 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 algoritma türü için destek eklendi.
Exchange
sıralamasına iki yeni değer eklendi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption CustomBiddingAlgorithm TargetingOption HedeflemeOptions.search İstek Gövdesi Aşağıdaki enum değerleri eklendi:
Enum Değerler CustomBiddingAlgorithmType Exchange TargetingType Aşağıdaki liste yöntemleri artık aşağıdaki özellikler tarafından filtrelenebilir:
Yöntem Alanlar customBiddingAlgorithms.list
4 Ağustos 2021
TARGETING_TYPE_OMID
hedefleme türü altına Open Measurement'ın 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 sayfasında döndürülebilecek atanmış hedefleme seçeneklerinin maksimum sayısı artırıldı.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption TargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler TargetingType Aşağıdaki liste yöntemleri için maksimum sayfa boyutu artırıldı:
26 Mayıs 2021
Kullanıcıların şunları yapmasına olanak tanıyan advertisers.invoices
hizmeti kullanıma sunuldu:
- Belirli bir ay boyunca bir reklamverene düzenlenen faturaları alma.
- belirli bir ay boyunca reklamveren tarafından kullanılan para birimi kodunu arama.
campaignBudgets
alanı kampanya kaynağına eklendi. Kampanya siparişi bütçe segmentleri bir kampanya bütçesine bağlanabilir. Bu durum, ilişkili segmentlerin toplam bütçesini toplam kampanya bütçe tutarıyla kısıtlar.
Yeni hedefleme türü TARGETING_TYPE_NATIVE_CONTENT_POSITION
altına yerel içerik konumu hedefleme desteği eklendi.
Reklamveren kaynağına yeni bir prismaEnabled
alanı eklendi. Bu sayede kullanıcılar, Mediaocean'ın Prisma aracıyla entegrasyonu etkinleştirdi.
Reklamverenin entityStatus
alanı için ENTITY_STATUS_PAUSED
sıralama değeri desteği etkinleştirildi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.invoices Aşağıdaki alanlar eklendi:
Kaynak Alanlar Reklamveren AssignedTargetingOption TargetingOption Aşağıdaki enum değerleri eklendi:
Enum Değerler AssignedTargetingOption.Recency Exchange TargetingType Aşağıdaki enum değerleri artık şu 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ıların hedeflemelerinde 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 Kanal Aşağıdaki liste yöntemleri artık aşağıdaki özellikler tarafından filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 Mart 2021
Satır öğesi hizmetine, varsayılan yapılandırmalarla satır öğesi oluşturan yeni bir yöntem eklendi. Bu varsayılan değerler belirtilen satır öğesi türüne ve üst kampanya siparişinin ayarlarına ve atanan hedeflemesine dayanır.
Yeni bir kampanya hedefleme hizmeti ve ek toplu liste yöntemi aracılığıyla kampanya hedeflemenin alınmasını etkinleştirmiş olmanız gerekir.
Uygulamaların daha fazla platformda hedeflenmesine olanak tanımak için uygulama hedefleme genişletildi.
Kanal ve negatif anahtar kelime listesi içeriklerinin daha kolay yönetilmesini sağlamak için advertisers.channels.sites
, partners.channels.sites
ve advertisers.negativeKeywordLists.negativeKeywords
hizmetlerinde birden çok değişiklik yapıldı. Bu değişiklikler şunlardır:
- Kullanıcının bir kanal veya negatif anahtar kelime listesinin mevcut içeriklerinin üzerine tamamen yazmasını sağlayan
replace
yöntemlerinin eklenmesi. - Toplu düzenleme isteklerinin
createdSites
veyacreatedNegativeKeywords
alanlarına mevcut hiçbir öğenin dahil edilmeme şartının kaldırılması. - Bir siteleri listeleme veya negatif anahtar kelimeleri listeleme yanıtının tek bir sayfasında döndürülebilecek maksimum öğe sayısındaki artış.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption.AppAssignedTargetingOptionDetails 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 1.000 partners.channels.sites.list 100 10000
Kullanımdan kaldırmalar
Aşağıdaki enum 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 işitsel reklam öğeleri tarafından kullanılacak yalnızca çıkışla ilgili reklam öğesi alanları ekleyerek reklam öğesi kaynağı genişletildi. Kampanya siparişi ve kampanya kaynakları tarafından kullanılacak yeni performans hedefi türleri eklendi.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Aşağıdaki alanlar eklendi:
Kaynak Alanlar Reklam öğesi Aşağıdaki enum değerleri eklendi:
Enum Değerler ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 Ocak 2021
Yeni Campaign OrderType alanı ve yeni LineItemType sıralama değerinin kullanıma sunulmasıyla TV kampanya siparişlerinin ve baypas satır öğelerinin alınmasını ve yönetilmesini sağladı. mobileApp
satır öğesi alanı aracılığıyla mobil uygulama satır öğeleri için destek eklendi.
Ek enum değerleriyle genişletilmiş exchange, google Audience ve SDF desteği. advertisers.list
değerlerini son güncelleme zamanına göre filtreleme ve sıralama özelliği kullanıma sunuldu.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar InsertionOrder LineItem Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange GoogleAudienceType LineItemType SdfVersion Aşağıdaki liste yöntemleri artık şu alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar reklamverenler
4 Aralık 2020
Coğrafi Bölge hedefleme seçeneklerini arama ve birden fazla kaynak listesi yöntemi sonucunu son güncelleme zamanına göre filtreleme özelliği eklendi. Bir satır öğesinin desteği sonlandırılmış coğrafi hedefleme kullandığında kullanıcıları bilgilendirmek amacıyla yeni bir LineItemAlertMessage öğesini kullanıma sunduk.
Yeni Özellikler
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler targetingTypes.targetingOptions Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange LineItemWarningMessage Aşağıdaki liste yöntemleri artık şu alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 Kasım 2020
İlişkili satır öğelerinin harcamalarını başlatan manuel tetikleyiciler oluşturma, atama ve etkinleştirme özelliği eklendi. Ayarlandığında satır öğesinin hedeflemesini, hedeflenen kitlelerdekilere 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 Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Aşağıdaki enum değerleri eklendi:
Enum Değerler LineItemFlightDateType Aşağıdaki liste yöntemleri artık şu alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list
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 alan olarak warningMessages
eklendi.
Yeni özelliklere ek olarak, yeni kota sınırları artık uygulanmaktadır ve toplu isteklerin kullanımı ile ilgili yeni belgeler mevcuttur.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar LineItem Aşağıdaki enum değerleri eklendi:
Enum Değerler PerformanceGoalType Aşağıdaki liste yöntemleri artık şu alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list
28 Ağustos 2020
Reklamveren denetim yönteminin yanıtına yeni alanlar ve çeşitli liste yöntemlerine yeni filtrelenebilir alanlar eklendi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Reklamverenler.Denetim Yanıtı Gövdesi Aşağıdaki liste yöntemleri artık şu alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 Ağustos 2020
Yeni kullanıcı yönetimi, iş ortağı ve iş ortağı hedefleme hizmetleri kullanıma sunuldu. Kullanıcıların hesap varlık sınırlarına ulaşmaktan proaktif olarak kaçınmasına yardımcı olacak araçlar kullanıma sunuldu. İşitsel satır öğeleri için destek eklendi. Ayrıca, satır öğeleri ve kampanya siparişi teklif stratejilerinde özel teklif verme algoritmaları kullanımı eklendi.
Yeni Özellikler
Aşağıdaki hizmetler eklendi:
Hizmet Yöntemler customBiddingAlgorithms iş ortakları partners.targetingTypes.assignedTargetingOptions kullanıcı Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler reklamverenler Aşağıdaki alanlar eklendi:
Kaynak Alanlar MaximizeSpendBidStrategy PerformanceGoalBidStrategy Aşağıdaki enum değerleri eklendi:
Enum Değerler BiddingStrategyPerformanceGoalType LineItemType Aşağıdaki liste yöntemleri artık şu alanlara göre sıralanabilir ve filtrelenebilir:
Yöntem Alanlar advertisers.lineItems.list Aşağıdaki kapsamlar, şu hizmetler için kullanılmak üzere eklendi:
Kapsam Hizmetler https://www.googleapis.com/auth/display-video-user-management
24 Haziran 2020
İş ortağı ve reklamveren kanalları için oluşturma yöntemi, yeni FirstAndThirdPartyAudience alanları ve ek exchange sıralama değerleri ekleyerek küçük bir güncelleme kullanıma sunuldu.
Yeni Özellikler
Aşağıdaki hizmetler eklendi:
Hizmet Yöntemler advertisers.channels partners.channels Aşağıdaki alanlar eklendi:
Kaynak Alanlar FirstAndThirdPartyAudience Aşağıdaki enum değerleri eklendi:
Enum Değerler Exchange Aşağıdaki liste yöntemleri artık şu alanlara göre filtrelenebilir:
Yöntem Alanlar advertisers.creatives.list
2 Haziran 2020
Hedeflenebilir varlıkların alt kümesini oluşturma, yama uygulama ve doldurma özelliği kullanıma sunuldu. Ayrıca üç hedefleme türü için reklamveren düzeyinde hedeflemeyi değiştirme özelliği eklendi: kanal, dijital içerik etiketi hariç tutma ve hassas kategori hariç tutma.
Yeni Özellikler
Aşağıdaki hizmetler eklendi:
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler reklamverenler advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Aşağıdaki alanlar eklendi:
Kaynak Alanlar reklamveren reklam öğesi insertionOrder.insertionOrderBudgetSegment
27 Nisan 2020
Bir dizi yeni özelliği kullanıma sunarak API'nin kapsamını SDF'nin ötesine taşıdık. Reklamverenler, kampanyalar, kampanya siparişleri, satır öğeleri ve reklam öğeleri gibi varlıkları oluşturmanıza, almanıza, 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:
9 Mart 2020
Display & Video 360 API v1 kullanıma sunuldu. Bu, API'nin ilk sürümüdür.
Bilinen sorunlar
Yok.