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ı:

    EnumDeğ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:

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

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.