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

Son güncelleme: 31.10.2023

Uygulamanızı taşıma

v2'den v3'e taşıma işlemi için uç nokta URL'lerinizin v3'e ve uygulamanızı güncelleyerek zarar veren değişiklikleri hesaba katabilirsiniz.

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

v2 yerine v3'ü kullanmak için isteklerinizi yeni v3'ü kullanacak şekilde güncellemeniz gerekir uç noktalar.

Örneğin, advertisers.get yöntemini v2 ile çağırmak için aşağıdaki URL'yi kullanın:

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

Gerekli değişiklikleri yapın

v3'te zarar veren bazı değişiklikler yapıyoruz. Aşağıdakileri inceleyin geçerli talimatları ve mevcut Görüntülü Reklam ve Video 360 API.

YouTube kaynaklarını ve ilgili hedeflemelerini alarak aramaları güncelleme

• YoutubeAdGroup ve YoutubeAdGroupAd kaynakları AdGroup ve AdGroupAd kaynakları. Bu yeni kaynaklar v2 kaynaklarıyla neredeyse aynı bilgiler içerir ancak güncellenmiş alan kullanabilir liste türlerini dikkate almalısınız. Entegrasyonunuzda AdGroup ve ile YoutubeAdGroup veya YoutubeAdGroupAd kaynak AdGroupAd kaynakları ve aşağıdaki v2 hizmetlerine yapılan çağrıları güncelleyip ilgili v3 hizmeti:
  • advertisers.youtubeAdGroupAds - advertisers.adGroupAds
  • advertisers.youtubeAdGroups - advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions - advertisers.adGroups.targetingTypes.assignedTargetingOptions
• YoutubeAndPartnersBiddingStrategy nesne referansları yeni bir youtubeAndPartnersBid alanına taşındı BiddingStrategy nesnesinin içinde olmalıdır. İlgili içeriği oluşturmak için kullanılan biddingStrategy alanı YoutubeAndPartnersSettingsnesne. Entegrasyonunuzu şu şekilde güncelleyin: YouTube satır öğeleri veya reklam grupları için teklif stratejisini bidStrategy alanındaki BiddingStrategy nesnesi LineItem veya AdGroup kaynağı.
• thirdPartyMeasurementSettings alanı, şu şekilde yeniden adlandırıldı: thirdPartyMeasurementConfigs YoutubeAndPartnersSettings nesnesi ve YoutubeAndPartnersThirdPartyMeasurementSettings nesnesi şu şekilde yeniden adlandırıldı: ThirdPartyMeasurementConfigs. Entegrasyonunuzu şu şekilde güncelleyin: yeni alanı kullanarak üçüncü taraf ölçüm yapılandırma bilgilerini alma kullanabilirsiniz.

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

billingConfig artık Advertiser kaynak. advertisers.create cihazınızı güncelleyin bu alanın ayarlandığını doğrulama isteğinde bulunur. Varsayılan fatura bilgileri ana iş ortağı için yeni Partner üzerinden alınabilir. kaynak billingConfig alanına giriş yapın.

Optimize hedeflemeyi kontrol etmek için yeni alanı kullanın

Yeni bir boole enableOptimizedTargeting alanı, TargetingExpansionConfig içindeki targetingExpansionLevel alanı nesnesini tanımlayın.

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

performanceGoal alanının yerini yeni bir kpi alanı aldı InsertionOrder kaynağı. Bu yeni alan bir Kpi kullanır nesnesini PerformanceGoal nesnesinin yerine koyar ve yeni alanlar ile enum'lar kullanır.

Kullanımdan kaldırılan hizmetlere ve alanlara verilen referansları kaldırın

Eski özellikle uyumlu hale getirmek için v3'te çeşitli varlıklar kaldırıldı :

• advertisers.manualTriggers hizmeti manuel tetikleyici olarak kaldırıldı kullanımdan kaldırılmıştır.
• billableOutcome alanı InsertionOrder kaynak sonuçlara dayalı satın almanın desteği sonlandırıldı.

Ek değişiklikler

v3, yukarıda listelenen zarar veren değişikliklere ek olarak, özellikleri.

İlk lansmandan sonra v3'e eklenen özellikler sürümümüzde bulunabilir. not ekleyin.

Yakın çevrede konum listesi yönetimi

v3'te yakın çevredeki konum listelerini tümüyle yöneterek şunları yapabilirsiniz: advertisers.locationLists.assignedLocations hizmetini kullanarak TARGETING_LOCATION_TYPE_PROXIMITY adresine atanan konumlar oluştur ve sil LocationList. Konumlar TARGETING_TYPE_POI TargetingOption kaynak Bunlar, targetingTypes.targetingOptions.search kullanılarak alındı.

Kurala dayalı özel teklif verme algoritmaları oluşturabilme

v3'te, kural tabanlı özel teklif verme algoritmaları oluşturmak ve almak için customBiddingAlgorithms, media, customBiddingAlgorithms.rules hizmetleri.

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