Sürüm notları

Bu sayfada, Google Bid Manager API'si için sürüm notları sağlanmaktadır.

En son API sürümü: v2

20 Kasım 2024

Yeni özellikler

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID başlatılır. Bu sayede, aşağıdaki ön eklerle başlayan metrikler için daha düşük güvene sahip verilerin dahil edilmesi sağlanır:

• METRIC_UNIQUE_REACH_
• METRIC_VIRTUAL_PEOPLE_DUPLICATE_
• METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
• METRIC_VIRTUAL_PEOPLE_OVERLAP_

Bu filtre kullanılırken ilgili metriklerden biri eklenmelidir.

Bu filtreyi içermeyen sorgular, kullanıma sunulduktan sonra varsayılan olarak yalnızca yüksek güven puanına sahip verileri içeren önceki varsayılan davranışa dönecektir. 4 Şubat 2025'ten itibaren ve bu tarihten sonra bu filtreyi içermeyen sorgular varsayılan olarak daha düşük güvenilirlikteki verileri içerecek.

v2

• Aşağıdaki filtreler eklendi:

  Filtre Türü	Kullanılabilir değerler
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: Güvenilirliği düşük verileri dahil edin. (4 Şubat 2025'ten sonra varsayılan) 1: Yalnızca yüksek güvenilirlikli verileri dahil edin. (4 Şubat 2025'ten önceki varsayılan ayar)

1 Ekim 2024

Yeni özellikler

Yok.

Bilinen sorunlar

v2

Anonim envanter modelleme (AIM) raporlama boyutunun kullanımdan kaldırılması

FILTER_ANONYMOUS_INVENTORY_MODELING boyutu gün batımıdır.

params.groupBy bölümünde kullanımdan kaldırılan değerleri kullanarak Query kaynağı oluşturmak veya çalıştırmak 400 hatası döndürür.

DHV/ROC (Yasal İşletim Maliyetleri) ve Toplam Medya Maliyeti metrikleri, YOUTUBE raporlarıyla uyumlu hale getirildi.

Aşağıdaki metrik değerleri artık YOUTUBE raporlarında kullanılamaz:

• METRIC_TOTAL_MEDIACOST_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPC_USD
• METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPV_USD
• METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPA_USD
• METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPCV_USD
• METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPC_USD
• METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPM_USD
• METRIC_TOTAL_MEDIACOST_PARTNER
• METRIC_TOTAL_MEDIACOST_USD
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
• METRIC_FEE32_ADVERTISER
• METRIC_FEE32_PARTNER
• METRIC_FEE32_USD

YOUTUBE params.type değerine sahip ve params.metrics içinde alakalı bir metrik değerine sahip Query kaynakları oluşturmak veya çalıştırmak 400 hatası döndürür.

1 Mayıs 2024

Yeni özellikler

Yok.

Bilinen sorunlar

v2

Tam Yol ve Yol İlişkilendirme Raporları'nın desteği sonlandırılıyor

Tam Yol ve Yol İlişkilendirme raporları kullanımdan kaldırıldı. Bu tür Query ve Report kaynaklarını almak veya oluşturmak hatayla sonuçlanır.

Aşağıdaki ReportType değerleri kullanımdan kaldırıldı:

• FULL_PATH
• PATH_ATTRIBUTION

Options nesnesinin pathQueryOptions alanı da kullanımdan kaldırıldı.

28 Şubat 2024

Yeni özellikler

Yok.

Bilinen sorunlar

v2

Cihazlar arası dönüşüm metriği değerlerinin kullanımdan kaldırılması

Cihazlar arası dönüşüm metrikleri kullanımdan kaldırıldı. Aşağıdaki Bid Manager API metrik değerleri dahildir:

• METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
• METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
• METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 Temmuz 2022

Yeni özellikler

Bid Manager API v2 yayınlandı.

Hizmet uç noktasını güncelleme ve hizmetleri ile yöntemleri yeniden adlandırma da dahil olmak üzere API'de yapısal değişiklikler yapıldı.

Gereksiz alanları kaldırarak, mevcut alanları yeniden düzenleyerek ve alan türlerini değiştirerek Sorgu ve Rapor kaynaklarını önemli ölçüde güncelledik. Genel bir "iç içe yerleştirilmiş nesne" tanımı yerine adlandırılmış nesneler kullanacak şekilde alan türlerinin değiştirilmesi de buna dahildir.

İsteğe bağlı sorguların, oluşturulduktan sonra otomatik olarak çalıştırılmak yerine queries.run yöntemi kullanılarak çalıştırılması gerekir.

queries.run sorgu parametresi asynchronous, synchronous ile değiştirildi.

Aşağıdaki değişikliklerle rapor alma işlemi basitleştirildi:

• queries.reports.get yönteminin eklenmesi.
• queries.reports.list'e bir orderBy sorgu parametresi eklendi.
• queries.run yanıt gövdesinin boş bir nesneden oluşturulan Report kaynağının bir örneğine güncellenmesi.

API tarafından döndürülen hata mesajları daha spesifik olacak ve daha fazla çözüm önerisi sunacak şekilde güncellendi.

v1.1'den v2'ye geçmek için v2 Taşıma Rehberi'ndeki talimatları uygulayın.

v2

• Hizmet uç noktası değiştirildi:

  v1 hizmet uç noktası	v2 hizmet uç noktası
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• Hizmetler aşağıdaki şekilde yeniden adlandırıldı:

  v1 hizmeti	v2 hizmeti
  Sorgular	queries
  Raporlar	queries.reports

• Yöntemler aşağıdaki gibi yeniden adlandırıldı:

  v1 yöntemi	v2 yöntemi
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

• Aşağıdaki yöntemler eklendi:

  Hizmet	Yöntemler
  queries.reports	get

• Aşağıdaki yöntemler yeni bir yanıt gövdesine sahiptir:

  Yöntem	Yeni yanıt gövdesi nesnesi
  queries.run	Bildir

• Aşağıdaki alanlar kaldırıldı:

  Kaynak	Alanlar
  queries.list Yanıt Metni	tür
  queries.reports.list Yanıt Metni	tür
  Sorgu	tür reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• Aşağıdaki alanların nesne türü aşağıdaki şekilde değiştirildi:

  Kaynak	Alanlar	Nesne Türü
  Sorgu	metadata params schedule	QueryMetadata Parametreler QuerySchedule
  Bildir	key metadata params	ReportKey ReportMetadata Parametreler
  RunQueryRequest	dataRange	DataRange

• Aşağıdaki yöntem sorgu parametreleri eklendi:

  Yöntem	Sorgu parametreleri
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	synchronous

• Aşağıdaki yöntem sorgu parametreleri kaldırıldı:

  Yöntem	Sorgu parametreleri
  queries.create	eşzamansız
  queries.run	eşzamansız

• Aşağıdaki filtre değerleri eklendi:

  Filtre değeri
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• Aşağıdaki filtre değerleri kaldırıldı:

  Filtre değeri
  FILTER_TRUEVIEW_IAR_REGION

• Aşağıdaki metrik değerleri eklendi:

  Metrik değeri
  METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS
  METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT
  METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH

Bilinen sorunlar

Yok.

Önceki sürümler

Kullanımdan kaldırılan sürümler için önceki Bid Manager API sürümleri hakkında bilgi edinmek üzere arşivlenmiş sürüm notlarımıza göz atın.