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 birorderBy
sorgu parametresi eklendi.queries.run
yanıt gövdesinin boş bir nesneden oluşturulanReport
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ı:
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 Metnitür
queries.reports.list
Yanıt Metnitü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 Bildir RunQueryRequest 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.