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

1 Mart 2025

Yeni özellikler

Bilinen sorunlar

Display & Video 360 yardım merkezinde daha önce duyurulduğu gibi YouTube TrueView envanter kullanılabilirliği raporu ve ilgili boyutlar kullanımdan kaldırılıyor.

v2

• Aşağıdaki enum değerlerinin desteği sonlandırıldı:

  Enum	Değerler
  ReportType	INVENTORY_AVAILABILITY

• Aşağıdaki filtrelerin desteği sonlandırıldı:

  Filtre değerleri

  FILTER_DETAILED_DEMOGRAPHICS FILTER_DETAILED_DEMOGRAPHICS_ID FILTER_HOUSEHOLD_INCOME FILTER_LIFE_EVENT FILTER_REMARKETING_LIST FILTER_TRUEVIEW_IAR_AGE FILTER_TRUEVIEW_IAR_CATEGORY FILTER_TRUEVIEW_IAR_CITY FILTER_TRUEVIEW_IAR_COUNTRY FILTER_TRUEVIEW_IAR_COUNTRY_NAME FILTER_TRUEVIEW_IAR_GENDER FILTER_TRUEVIEW_IAR_INTEREST FILTER_TRUEVIEW_IAR_LANGUAGE FILTER_TRUEVIEW_IAR_PARENTAL_STATUS FILTER_TRUEVIEW_IAR_REGION_NAME FILTER_TRUEVIEW_IAR_REMARKETING_LIST FILTER_TRUEVIEW_IAR_TIME_OF_DAY FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO FILTER_TRUEVIEW_IAR_ZIPCODE FILTER_YOUTUBE_CHANNEL FILTER_YOUTUBE_VIDEO

• Aşağıdaki metriklerin desteği sonlandırıldı:

  Metrik değerleri
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

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 dahil edilmelidir.

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 bu filtreyi içermeyen sorgular varsayılan olarak daha düşük güven puanına sahip verileri içerecek.

v2

• Aşağıdaki filtreler eklendi:

  Filtre Türü	Kullanılabilir değerler
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: Daha düşük güvenilirlik düzeyine sahip verileri dahil edin. (4 Şubat 2025'ten sonra varsayılan) 1: Yalnızca yüksek güven düzeyine sahip 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 kullanımdan kaldırılması

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. Bu, genel bir "iç içe yerleştirilmiş nesne" tanımı yerine adlandırılmış nesneler kullanacak şekilde alan türlerinin değiştirilmesini içerir.

İ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.