v2'den v3'e taşıyın

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 ve YoutubeAdGroupAd kaynakları, AdGroup ve AdGroupAd 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 veya YoutubeAdGroupAd kaynaklarını AdGroup ve AdGroupAd 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, genel BiddingStrategy nesnesindeki yeni bir youtubeAndPartnersBid alanına taşındı. biddingStrategy alanı, YoutubeAndPartnersSettings nesnesinden kaldırıldı. LineItem veya AdGroup kaynağındaki bidStrategy alanında bulunan BiddingStrategy nesnesinden YouTube satır öğeleri veya reklam grupları için teklif stratejisi almak üzere entegrasyonunuzu güncelleyin.
• thirdPartyMeasurementSettings alanı, YoutubeAndPartnersSettings nesnesinde thirdPartyMeasurementConfigs ve YoutubeAndPartnersThirdPartyMeasurementSettings 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çin InsertionOrder 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.