Bu sayfada, Display & Video 360 API'si için sürüm notları sunulmaktadır.
En son API sürümü: v3
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
Yeni bir floodlightGroups.floodlightActivities
hizmeti aracılığıyla Floodlight etkinliklerini alma özelliği eklendi.
YouTube ve İş Ortakları satır öğesinin, hedeflemesinde Google TV envanteri olup olmadığını belirten yeni bir alan eklendi.
Display & Video 360 kullanıcısı için son giriş zamanını aktarmak amacıyla 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 kitlesi üyelerini yüklerken son kullanıcı rızasını 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 beta sürümünden çıkarılıp genel kullanıma sunuldu.
İlgili biçimi daha doğru yansıtmak için v3'te bir AdGroupFormat
enum değeri yeniden adlandırıldı.
v2 ve v3'te SDF_VERSION_7
sıralama değerinin eklenmesiyle birlikte 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 sürümünde yayınlanmıştır:
- Yakın çevredeki konum listelerini tümüyle yönetme özelliği,
TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarına atanan konumları oluşturmak ve silmek içinadvertisers.locationLists.assignedLocations
hizmetinin kullanılmasına olanak tanır. TargetingExpansionConfig
nesnesindekitargetingExpansionLevel
alanının yerini alan yeni bir booleenableOptimizedTargeting
alanı.Advertiser
kaynağında bulunan veadvertisers.create
istekleri yapılırken eklenmesi gerekenbillingConfig
alanı vePartner
kaynakta yeni birbillingConfig
alanı gereksinimi.- v2'de
YoutubeAdGroup
veYoutubeAdGroupAd
kaynaklarının yerini alan yeniAdGroup
veAdGroupAd
kaynakları.
v2'den v3'e geçiş yapmak için taşıma kılavuzumuzdaki adımları uygulayın.
v2 ve v3'e 3 yeni LineItemType
değeri, bir yeni YoutubeAndPartnersBiddingStrategyType
ve bir yeni PartnerCostType
değeri 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ındaAssignedLocation
kaynaklarının toplu olarak düzenlenmesini destekliyor.advertisers.locationLists.assignedLocations.create Artık TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarındaAssignedLocation
kaynakları oluşturulmasını destekliyor.Aşağıdaki sorgu parametreleri eklendi:
Yöntem Parametreler inventorySources.get Aşağıdaki alanlar zorunlu hâle 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ğerleri göz önünde bulundururken satır öğesi tarafından kullanılan YoutubeAndPartnersContentCategory
alanını göstermek 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ı true
olarak ayarlanmışsa satır öğesinin warningMessages
alanına atanacak yeni bir LineItemWarningMessage
değeri eklendi. 25 Mart 2023'ten sonra excludeFirstPartyAudience
alanı 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 geri alınabilir hedefleme türleri de ekledik. Daha fazla bilgi için YouTube ve İş Ortakları kaynaklarını almayla ilgili 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 beta sürümünden çıkarılıp genel kullanıma sunuldu.
AssignedTargetingOption
kaynağına yeni bir assignedTargetingOptionIdAlias
alanı eklendi. Bu alan, hedefleme alınırken ve silinirken assignedTargetingOptionId
yerine kullanılabilir.
Bu alan, yalnızca numaralandırma aracılığıyla atanan hedefleme türlerinin atanan 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.
YouTube ve İş Ortakları'na üç yeni LineItemType
değeriyle tanımlanan baypas satır öğelerini alma desteği eklendi.
v1 ve v2'de çeşitli list
yöntemleri için maksimum sayfa boyutu 200'e yükseltildi. Varsayılan sayfa boyutu değiştirilmez.
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üncellemeyle v2'de aşağıdaki bilinen sorunlar giderilmiştir:
- v2'deki numaralandırma değerleri kullanılarak atanan hedefleme türlerinin atanan hedefleme seçenekleri,
assignedTargetingOptionId
kullanılarak kaldırılamamış veya alınamadı ve bunun yerine kullanıcıların enum değerini kullanmaları bekleniyordu. Bu güncellemeyle, atanan bu hedefleme seçenekleriassignedTargetingOptionId
veyaAssignedTargetingOption
kaynağındaki yeniassignedTargetingOptionIdAlias
alanı tarafından tanımlanan enum değeri kullanılarak kaldırılabilir veya alınabilir. - Satır öğesi
bulkUpdate
isteği,advertisersId
istek parametresini kullanarak doğru bir şekilde kullanılmadığı için hata döndürdü. Bu güncellemeyle birlikte yöntem düzeltildi ve istek parametresiadvertisersId
yerineadvertiserId
olarak yeniden adlandırıldı.
27 Ekim 2022
Üst InsertionOrder
içinde mevcut bir satır öğesini kopyalama özelliği eklendi.
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
hizmetine create
ve delete
yöntemlerinin eklenmesiyle birlikte bir hedefleme türlerinin alt grubu için kısmi kampanya siparişi hedefleme yazma desteği sunulmaya başlandı.
Yeni Özellikler
v2
Aşağıdaki yöntemler eklendi:
Hizmet Yöntemler advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
Sürüm 1'e yeni özellik eklenmedi.
20 Eylül 2022
Aşağıdaki değişiklikleri içeren v2 herkese açık beta sürümünde yayınlanmıştır:
advertisers.lineItems
veadvertisers.lineItems.targetingTypes.assignedTargetingOptions
hizmetlerindeget
velist
yöntemlerini kullanarak YouTube ve İş Ortakları satır öğelerini ve hedefleme ayarlarını alma.advertisers.lineItems
hizmetinde, tek bir istekle birden fazla satır öğesinde atanmış 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
öğesini güncellemesine olanak tanıyan yeni birbulkUpdate
yöntemi. AssignedTargetingOption
hedefleme türleri alt kümesine ait kaynakların atanmasını vetargetingTypes.targetingOptions
hizmeti kullanılarak alınan hedefleme seçeneği kimlikleri yerine enum değerleri kullanılarak alınmasını gerektiren yeni hedefleme mantığı.
v1'den v2'ye geçiş yapmak için taşıma kılavuzumuzdaki adımları uygulayın.
v1'e üç yeni exchange için destek eklendi.
Yeni Özellikler
v2
Aşağıda, v1 ile v2 arasındaki değişikliklerin bir listesi bulunmaktadır:
Aşağıdaki yöntemler v2'ye eklendi:
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ıldı:
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'de hedefleme ataması için enum'ları kullanır. Bu hedefleme türlerininAssignedTargetingOption
kaynakları içinassignedTargetingOptionId
alanı, enum değerlerinin dize sürümlerini kullanmak üzere v2'de de güncellenmiştir:Hedefleme Türü Sıralama 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 Aşağıdaki alanlar v2'de eklenmiştir:
Aşağıdaki alanlar v2'de kaldırıldı:
v2'de aşağıdaki alanlar zorunlu hâle getirildi:
v2'ye aşağıdaki enum 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 enum 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 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, algoritmaya erişebilen her reklamveren için algoritma modelinin hazır olma durumu listelenir.
advertisers.creatives.list
yöntemi için kullanıcının yalnızca belirli bir zaman damgasından önce veya sonra updateTime
olan reklam öğelerini almasına izin veren yeni filter
sorgu parametresi işlevi etkinleştirildi.
SdfVersion
enum değerinin eklenmesiyle 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öntemlerine artık aşağıdaki özelliklere göre filtre uygulanabilir:
Yöntem Alanlar advertisers.creatives.list
31 Mart 2022
İçerik süresi, akış türü ve tür için hedefleme alma ve ayarlama desteği eklendi.
billableOutcome
alanı InsertionOrder
nesnesine eklendi.
MaximizeSpendBidStrategy
nesnesine raiseBidForDeals
alanı kullanılmaya başlandı ve kullanıcıların, teklif stratejisinin hedeflenen anlaşmalar için reklamveren taban fiyatları uygulanıp uygulanmayacağını ayarlamasına olanak sağlandı.
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 desteği eklendi. Yeni Kitleleri Kullanma kılavuzumuzdaki Müşteri Eşleştirme Kitlelerini Yükleme sayfasında, bu yeni özelliklerin nasıl kullanılacağı açıklanmaktadır.
InsertionOrder
ve LineItem
kaynaklarında, bir kaynağın Etiket Garantili, Programatik Garantili veya garantili olup olmadığını belirleyen 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 özelliklere ek olarak, varsayılan kota sınırları da 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ünün altında ses içeriği türü hedefleme için destek 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 hizmet ve özellikler arasında aşağıdakiler bulunmaktadır:
- Yeni
customBiddingAlgorithms
oluşturma ve güncelleme işlevleri. - Kullanılabilir bir kaynak konumu alma ve ardından dosyayı bu konuma yükleme işlemiyle komut dosyası yükleyebilme özelliği.
customBiddingScripts
Alma ve oluşturma işlemleri için yeni bircustomBiddingAlgorithms.scripts
hizmeti.
Satır Öğelerini Yönetme rehberimize, özel teklif verme algoritması oluşturma, komut dosyası yükleme ve özel teklif verme algoritmasını bir satır öğesinin teklif stratejisi olarak atama işlemlerini açıklayan yeni bir Özel Teklif Verme Uygula sayfası eklendi.
SdfVersion
sıralama değerinin eklenmesiyle 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
kullanarak 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 eklendi.
Exchange
sıralamasına iki yeni değer eklendi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar AssignedTargetingOption CustomBiddingAlgorithm TargetingOption TargetingOptions.search İstek Gövdesi Aşağıdaki enum değerleri eklendi:
Enum Değerler CustomBiddingAlgorithmType Exchange TargetingType Aşağıdaki liste yöntemlerine artık aşağıdaki özelliklere göre filtre uygulanabilir:
Yöntem Alanlar customBiddingAlgorithms.list
4 Ağustos 2021
TARGETING_TYPE_OMID
hedefleme türünün altında Open Measurement'ın etkin olduğu envanter hedefleme için destek 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 aşağıdaki işlemleri yapmasına olanak tanıyan advertisers.invoices
hizmeti kullanıma sunuldu:
- Belirli bir ay içinde bir reklamverene düzenlenen faturaları almak.
- belirli bir ayda reklamverenin kullandığı para birimi kodunu arayabilir.
Kampanya kaynağına campaignBudgets
alanı eklendi. Kampanya siparişi bütçe segmentleri bir kampanya bütçesine bağlanabilir. Bu sayede, 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 konumu hedefleme için destek eklendi.
Reklamveren kaynağına, kullanıcıların Mediaocean'ın Prisma aracıyla entegrasyonu etkinleştirmesine olanak tanıyan yeni bir prismaEnabled
alanı eklendi.
Reklamverenin entityStatus
alanında ENTITY_STATUS_PAUSED
sıralama değeri için destek 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 kaynağını 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 yalnızca hedeflemesinde belirli kanalları veya negatif anahtar kelime listelerini kullanan satır öğelerini almasına izin veren yeni filter
mülkleri etkinleştirildi.
Yeni Özellikler
Aşağıdaki alanlar eklendi:
Kaynak Alanlar Kanal Aşağıdaki liste yöntemlerine artık aşağıdaki özelliklere göre filtre uygulanabilir:
Yöntem Alanlar advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 Mart 2021
Varsayılan yapılandırmalara sahip bir satır öğesi oluşturan satır öğesi hizmetine yeni bir yöntem eklendi. Bu varsayılan değerler, belirtilen satır öğesi türünün yanı sıra üst kampanya siparişinin ayarları ve atanan hedeflemesini temel alır.
Yeni bir kampanya hedefleme hizmeti ve ek toplu liste yöntemi aracılığıyla kampanya hedefleme alındı.
Uygulamaların daha fazla platformda hedeflenebilmesi için genişletilmiş uygulama hedefleme.
Kanal ve negatif anahtar kelime listesi içeriğinin daha kolay yönetilmesini sağlamak için advertisers.channels.sites
, partners.channels.sites
ve advertisers.negativeKeywordLists.negativeKeywords
hizmetlerinde birden fazla değişiklik yapıldı. Bu değişiklikler arasında şunlar yer alır:
- Kullanıcının bir kanalın veya negatif anahtar kelime listesinin mevcut içeriğinin üzerine tamamen yazmasını sağlayan
replace
yöntemlerinin eklenmesi. - Toplu düzenleme isteklerinin
createdSites
veyacreatedNegativeKeywords
alanlarına mevcut öğelerin eklenmemesi şartının kaldırılması. - Bir site listeleme veya negatif anahtar kelime 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 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 hizmetinin ve ek toplu listeleme yönteminin kullanıma sunulması. Reklam öğesi kaynağı genişletildi ve üçüncü taraf işitsel reklam öğelerinin kullanımı için yalnızca çıkış sağlayan reklam öğesi alanları eklendi. Kampanya siparişi ve kampanya kaynakları tarafından kullanılmak üzere 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
Kullanıma sunulan yeni InsertOrderType alanının ve yeni LineItemType enum değerinin kullanıma sunulmasıyla TV kampanya siparişlerinin ve baypas satır öğelerinin alınıp yönetilmesini sağladık. mobileApp
satır öğesi alanı ile mobil uygulama satır öğeleri için destek eklendi.
Ek enum değerleri ile exchange, google audience ve SDF desteği genişletildi. 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çenekleri için arama ve birden fazla kaynak listesi yöntemi sonucunu son güncellenme zamanına göre filtreleme özelliği eklendi. Bir satır öğesinin desteği sonlandırılmış coğrafi hedeflemeyi kullandığı durumları kullanıcılara bildirmek için yeni bir LineItemWarningMessage kullanıma sunuldu.
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. Özel segment kimliği alanları, üçüncü taraf doğrulama hedeflemesinde kullanılan DoubleVerify ve Integral Ad Science nesnelerine 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öntemlerine artık aşağıdaki alanlara göre filtre uygulanabilir:
Yöntem Alanlar advertisers.lineItems.list
12 Ekim 2020
Satır öğesi kaynağına alınabilir uyarı mesajları ve bir tıklama oranı (TO) performans hedefi türü kullanıma sunuldu. Satır öğeleri listelenirken filtrelenebilir alan olarak warningMessages
eklendi.
Yeni özelliklerin yanı sıra artık yeni kota sınırları da uygulanmaya başladı ve toplu isteklerin kullanımıyla ilgili yeni belgeler kullanıma sunuldu.
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öntemlerine artık aşağıdaki alanlara göre filtre uygulanabilir:
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.Denetleme Yanıtı Gövdesi Aşağıdaki liste yöntemlerine artık aşağıdaki alanlara göre filtre uygulanabilir:
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. Sesli satır öğeleri için destek ve satır öğeleri ile kampanya siparişi teklif stratejilerinde özel teklif verme algoritmalarının 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 hizmetlerde 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 enum değerleri için 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öntemlerine artık aşağıdaki alanlara göre filtre uygulanabilir:
Yöntem Alanlar advertisers.creatives.list
2 Haziran 2020
Hedeflenebilir öğelerin bir 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 kullanıma sunuldu: 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
API'nin kapsamını SDF'nin de ötesine taşıyarak büyük bir özellik grubunu kullanıma sundu. 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, satır öğesi seviyesinde hedeflemenin 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.