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

Son güncelleme: 2023-10-31

Uygulamanızı taşıma

v2'den v3'e geçiş için uç nokta URL'lerinizi v3'ü çağıracak şekilde güncellemeniz ve uygulamanızı, önemli değişiklikleri hesaba katacak şekilde güncellemeniz gerekir.

API çağrılarınızı v2'den v3'e güncelleme

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 son sürümünü kullanın ve yapılandırmanızı v3'ü kullanacak şekilde güncelleyin.

Gerekli değişiklikleri yapın

v3'te bir dizi zarar veren değişiklik yapıyoruz. Aşağıdaki talimatları inceleyin ve Display & Video 360 API'yi mevcut kullanımınızla ilgili gerekli değişiklikleri yapın.

YouTube kaynaklarını ve bunlarla ilgili hedeflemeyi alan güncelleme çağrıları

• YoutubeAdGroup ve YoutubeAdGroupAd kaynaklarının yerini AdGroup ve AdGroupAd kaynakları aldı. 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ın kullanımlarını AdGroup ve AdGroupAd kaynaklarıyla değiştirin ve aşağıdaki v2 hizmetlerine yapılan çağrıları ilgili v3 hizmetine yönlendirecek şekilde 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ı. YouTube satır öğeleri veya reklam grupları için teklif stratejisini LineItem veya AdGroup kaynağındaki bidStrategy alanındaki BiddingStrategy nesnesinden almak için entegrasyonunuzu güncelleyin.
• thirdPartyMeasurementSettings alanı, YoutubeAndPartnersSettings nesnesinde thirdPartyMeasurementConfigs olarak yeniden adlandırıldı ve YoutubeAndPartnersThirdPartyMeasurementSettings nesnesi ThirdPartyMeasurementConfigs olarak yeniden adlandırıldı. Yeni alanı ve nesneyi kullanarak üçüncü taraf ölçüm yapılandırma bilgilerini almak için entegrasyonunuzu güncelleyin.

Reklamveren oluştururken gerekli faturalandırma yapılandırmalarını ekleyin

billingConfig alanı artık Advertiser kaynağında zorunlu bir alandır. Bu alanın ayarlandığını doğrulamak için advertisers.create isteklerinizi güncelleyin. Varsayılan faturalandırma bilgileri, yeni Partner kaynağı billingConfig alanı aracılığıyla üst iş ortağı için alınabilir.

Optimize hedeflemeyi kontrol etmek için yeni alanı kullanma

TargetingExpansionConfig nesnesindeki targetingExpansionLevel alanı, yeni bir boolean enableOptimizedTargeting alanı ile değiştirildi.

Yeni TPG alanını kullanmak için kampanya siparişi entegrasyonunu güncelleme

InsertionOrder kaynağında performanceGoal alanının yerini yeni bir kpi alanı aldı. Bu yeni alan, PerformanceGoal nesnesi yerine Kpi nesnesini kullanır ve yeni alanlar ile enums kullanır.

Desteği sonlandırılan hizmetlere ve alanlara yapılan referansları kaldırma

Geçmiş özellik desteği sonlandırmalarıyla uyumlu olması için v3'te çeşitli öğeler kaldırıldı:

• advertisers.manualTriggers hizmeti, manuel tetikleyiciler kullanımdan kaldırıldığından kaldırıldı.
• Sonuca dayalı satın alma için destek sonlandırıldığından billableOutcome alanı, InsertionOrder kaynağında kaldırıldı.

Ek değişiklikler

V3, yukarıda listelenen uyumluluğu bozan değişikliklere ek olarak yeni özellikler de sunar.

İlk kullanıma sunulmasından sonra v3'e eklenen özellikler sürüm notlarımızda yer almaktadır.

Yakınlık hedefleme konum listesi yönetimi

v3'te yakınlık konum listelerini tam olarak yönetebilir, advertisers.locationLists.assignedLocations hizmetini kullanarak TARGETING_LOCATION_TYPE_PROXIMITY LocationList kaynaklarına atanan konumları oluşturup silebilirsiniz. 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şturma

v3'te customBiddingAlgorithms, media, customBiddingAlgorithms.rules hizmetlerini kullanarak kural tabanlı özel teklif verme algoritmaları oluşturabilir ve 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.