Son güncelleme: 31.10.2023
Uygulamanızı taşıyın
v2'den v3'e geçiş yapmak için uç nokta URL'lerinizin v3'ü çağıracak şekilde güncellenmesi ve uygulamanızı zarar veren değişiklikleri hesaba katacak şekilde güncellemeniz gerekir.
API çağrılarınızı v2'den v3'e güncelleyin
v2 yerine v3'ü kullanmak için isteklerinizi yeni v3 uç noktalarını kullanacak şekilde güncellemeniz gerekir.
Örneğin, advertisers.get
yöntemini v2 ile çağırmak için aşağıdaki URL'yi kullanırsınız:
GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId
v3 için URL'yi aşağıdaki şekilde güncelleyin:
GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId
API'ye istek göndermek için bir istemci kitaplığı kullanıyorsanız istemci kitaplığının en yeni sürümünü kullanın ve yapılandırmanızı v3'ü kullanacak şekilde güncelleyin.
Gerekli değişiklikleri yapın
Sürüm 3'te bazı zarar veren değişiklikler yapıyoruz. Aşağıdaki talimatları inceleyin ve Display & Video 360 API'yi mevcut kullanımınızla ilgili olarak gerekli değişiklikleri yapın.
YouTube kaynaklarını ve ilgili hedeflemelerini alan aramaları güncelleme
YoutubeAdGroup
veYoutubeAdGroupAd
kaynakları,AdGroup
veAdGroupAd
kaynaklarıyla değiştirildi. Bu yeni kaynaklar, v2 kaynaklarıyla neredeyse aynı bilgileri sağlar ancak güncellenmiş alan adlarını veya enum türlerini kullanabilir. Entegrasyonunuzda,YoutubeAdGroup
veyaYoutubeAdGroupAd
kaynaklarınıAdGroup
veAdGroupAd
kaynaklarıyla değiştirin ve aşağıdaki v2 hizmetlerine yapılan çağrıları ilgili v3 hizmetiyle güncelleyin:advertisers.youtubeAdGroupAds
-advertisers.adGroupAds
advertisers.youtubeAdGroups
-advertisers.adGroups
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
-advertisers.adGroups.targetingTypes.assignedTargetingOptions
YoutubeAndPartnersBiddingStrategy
nesnelerine yapılan referanslar, genelBiddingStrategy
nesnesindeki yeni biryoutubeAndPartnersBid
alanına taşındı.biddingStrategy
alanı,YoutubeAndPartnersSettings
nesnesinden kaldırıldı.LineItem
veyaAdGroup
kaynağındakibidStrategy
alanında bulunanBiddingStrategy
nesnesinden YouTube satır öğeleri veya reklam grupları için teklif stratejisi almak üzere entegrasyonunuzu güncelleyin.thirdPartyMeasurementSettings
alanı,YoutubeAndPartnersSettings
nesnesindethirdPartyMeasurementConfigs
veYoutubeAndPartnersThirdPartyMeasurementSettings
nesnesi,ThirdPartyMeasurementConfigs
olarak yeniden adlandırıldı. Yeni alanı ve nesneyi kullanarak üçüncü taraf ölçüm yapılandırma bilgileri almak için entegrasyonunuzu güncelleyin.
Reklamveren oluştururken gerekli faturalandırma yapılandırmalarını dahil edin
billingConfig
artık Advertiser
kaynağında zorunlu bir alan. Bu alanın ayarlandığını doğrulamak için advertisers.create
isteklerinizi güncelleyin. Ana iş ortağı için varsayılan faturalandırma bilgileri, yeni Partner
kaynak billingConfig
alanı aracılığıyla alınabilir.
Optimize hedeflemeyi kontrol etmek için yeni alan kullan
TargetingExpansionConfig
nesnesindeki targetingExpansionLevel
alanının yerini yeni bir boole enableOptimizedTargeting
alanı aldı.
Yeni TPG alanını kullanmak için kampanya siparişi entegrasyonunu güncelleyin
InsertionOrder
kaynağındaki performanceGoal
alanı, yeni bir kpi
alanı ile değiştirilmiştir. Bu yeni alan, PerformanceGoal
nesnesi yerine bir Kpi
nesnesi kullanır ve yeni alanlar ile enum'lar kullanır.
Kullanımdan kaldırılan hizmetlere ve alanlara yönelik referansları kaldırın
Geçmiş özelliklerin kullanımdan kaldırılmasıyla uyumlu olması için v3'te çeşitli varlıklar kaldırılmıştır:
- Manuel tetikleyiciler kullanımdan kaldırıldığı için
advertisers.manualTriggers
hizmeti kaldırılmıştır. billableOutcome
alanı, sonuca dayalı satın alma kullanımdan kaldırıldığı içinInsertionOrder
kaynağından kaldırıldı.
Ek değişiklikler
Yukarıda listelenen zarar veren değişikliklerin yanı sıra v3 yeni özellikler de sunar.
İlk lansmandan sonra v3'e eklenen özellikleri sürüm notlarımızda bulabilirsiniz.
Yakın çevredeki konum listesi yönetimi
v3'te yakın çevredeki konum listelerini tümüyle yönetebilirsiniz. Böylece, TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
kaynaklarına atanan konumları oluşturmak ve silmek için advertisers.locationLists.assignedLocations
hizmetini kullanabilirsiniz. Konumlar, TARGETING_TYPE_POI
TargetingOption
kaynaklarının kimliği kullanılarak tanımlanır. Bunlar targetingTypes.targetingOptions.search
kullanılarak alınabilir.
Kurala dayalı özel teklif verme algoritmaları oluşturabilme
v3'te customBiddingAlgorithms
, media
ve customBiddingAlgorithms.rules
hizmetlerini kullanarak kurala dayalı özel teklif verme algoritmaları oluşturup alabilirsiniz.
Bu özellik beta sürümündedir ve yalnızca izin verilenler listesindeki iş ortakları tarafından kullanılabilir. İş ortağınız izin verilenler listesinde değilse isteğiniz hata döndürür.