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

Son güncelleme: 31.10.2023

Uygulamanızı taşıma

V2'den v3'e geçiş yapmak 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

3. sürüm 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

3. sürümde bazı önemli değişiklikler 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 ilgili hedeflemelerini alan çağrıları 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ı veya enum türleri kullanabilir. Entegrasyonunuzda YoutubeAdGroup veya YoutubeAdGroupAd kaynaklarınızı 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 nesnesi içindeki yeni bir youtubeAndPartnersBid alanına taşındı. biddingStrategy alanı, YoutubeAndPartnersSettingsnesnesinden kaldırıldı. YouTube satır öğeleri veya reklam grupları için teklif stratejisini LineItem veya AdGroup kaynağındaki bidStrategy alanındaki BiddingStrategy nesnesinden alacak şekilde entegrasyonunuzu güncelleyin.
thirdPartyMeasurementSettings alanı, YoutubeAndPartnersSettings nesnesinde thirdPartyMeasurementConfigs olarak, YoutubeAndPartnersThirdPartyMeasurementSettings nesnesi ise 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ı ekleme

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

Optimize hedeflemeyi kontrol etmek için yeni alanı kullanma

TargetingExpansionConfig nesnesinde targetingExpansionLevel alanının yerini yeni bir boole enableOptimizedTargeting alanı aldı.

Kampanya siparişi entegrasyonunu yeni TPG alanını kullanacak şekilde güncelleme

InsertionOrder kaynağındaki performanceGoal alanının yerini yeni bir kpi alanı aldı. Bu yeni alanda, PerformanceGoal nesnesi yerine Kpi nesnesi ve yeni alanlar ile enum'lar kullanılır.

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

Geçmişte kullanımdan kaldırılan özelliklerle uyumlu olması için çeşitli öğeler v3'ten kaldırıldı:

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

Ek değişiklikler

Yukarıda listelenen önemli değişikliklere ek olarak v3'te yeni özellikler de kullanıma sunulmuştur.

İlk lansmandan sonra v3'e eklenen özellikleri sürüm notlarımızda bulabilirsiniz.

Yakınlık hedefleme listesi yönetimi

3. sürümde yakın çevredeki konum listelerini tamamen 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şturma

3. sürümde customBiddingAlgorithms, media ve customBiddingAlgorithms.rules hizmetlerini kullanarak kurala dayalı özel teklif verme algoritmaları oluşturabilir ve alabilirsiniz.

Bu özellik beta sürümündedir ve yalnızca izin verilenler listesine eklenen iş ortakları tarafından kullanılabilir. İş ortağınız izin verilenler listesinde değilse isteğiniz hata döndürür.