Sürüm Notları

v0 (10.11.2025)

Yeni URL Alanları

Aşağıdaki yeni özellikler ekleniyor:

• ad.final_mobile_urls,
• ad.tracking_url_template,
• ad.final_url_suffix,
• ad_group.tracking_url_template,
• ad_group.final_url_suffix,
• ad_group_criterion.final_mobile_urls
• ad_group_criterion.url_custom_parameters
• asset.final_mobile_urls
• asset.url_custom_parameters
• asset.final_url_suffix

UserLocationView için yeni metrikler

user_location_view kaynağı sorgulanırken aşağıdaki metrikler kullanılabilir:

• all_conversions_by_conversion_date
• all_conversions_value_by_conversion_date
• conversions_by_conversion_date
• conversions_value_by_conversion_date
• cross_device_conversions_by_conversion_date
• cross_device_conversions_value_by_conversion_date
• value_per_all_conversions_by_conversion_date
• value_per_conversions_by_conversion_date

Kaynak Adı Düzeltmesi

Aşağıdaki etkili etiket kaynakları için kaynak adı kalıbı, etiketin sahibi olan müşteri kimliğini içermesini sağlamak amacıyla owner_customer_id kullanacak şekilde düzeltildi:

• CampaignEffectiveLabel
• AdGroupEffectiveLabel
• CriterionEffectiveLabel (AdGroupCriterionEffectiveLabel bölgesinde)
• AdGroupAdEffectiveLabel

Örnek: CampaignEffectiveLabel için desen, customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} yerine customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} olarak değiştirildi.

v0 (12.06.2025)

Bu güncelleme, müşteri kaynağı için yeni alanlar içerir. Bu değişikliklerden yararlanmak için istemci kitaplığını güncellediğinizden emin olun.

Yeni alanlar

Aşağıdaki yeni özellikler ekleniyor:

• customer.manager_id,
• customer.manager_descriptive_name,
• customer.sub_manager_id,
• customer.sub_manager_descriptive_name,
• customer.associate_manager_id,
• customer.associate_manager_descriptive_name ve
• customer.account_level

Search Ads 360 hesap hiyerarşisinde gezinmeye yardımcı olmak için

v0 (21.01.2025)

Bu güncelleme, MM genişletmesini yapılandırmak için yeni bir parametre içerir.

MM genişletme

Artık bir bidding_strategy sorgularken PARAMETERS bölümünde bir boole değeri (enable_mcc_expansion) ayarlayabilirsiniz.

Bu parametre etkinleştirildiğinde, customer_id kök dizinli hesap hiyerarşisindeki tüm hesaplardan gelen veriler yanıtta döndürülür.

v0 (08.11.2024)

Bu güncelleme, yeni alanlar ve yeni kaynaklar içerir. Bu değişikliklerden yararlanmak için istemci kitaplığını güncellediğinizden emin olun.

Yeni alanlar

ad_group_ad.effective_labels ve ad_group_criterion.effective_labels ekliyoruz.

Etkili etiketler, devralınan veya doğrudan atanan etiketlerdir.

Yeni kaynaklar

Kullanıcı Konumu Görünümü

Coğrafi segmentlerle birlikte kullanıldığında bölge, metropol ve şehirle ilgili metrikler elde edilebilir.

user_location_view kaynak ayrıntılarına bakın.

Yeni effective_labels alanlarıyla ilgili olarak, geçerli etiketler ile ad_group_ad (ad_group_ad_effective_label) veya ad_group_criterion (ad_group_criterion_effective_label) arasındaki ilişkilendirmeyle ilgili meta verileri tutan 2 yeni kaynak vardır.

v0 (2024-10-07)

Bu güncelleme; yeni metrikler, kaynaklar, alanlar ve bazı yeni eşleme tanımlarını içerir. Bu değişikliklerden yararlanmak için istemci kitaplığını güncellediğinizden emin olun.

Eklenen metrikler

• cross_device_conversions_by_conversion_date: Dönüşüm tarihine göre cihazlar arası dönüşüm sayısı.
• cross_device_conversions_value_by_conversion_date: Dönüşüm tarihine göre cihazlar arası dönüşüm değerlerinin toplamı.
• general_invalid_click_rate: Genel geçersiz tıklamalar olması nedeniyle toplam tıklama sayınızdan (filtrelenmiş + filtrelenmemiş tıklamalar) filtrelenen tıklamaların yüzdesi.
• general_invalid_clicks: Genel geçersiz tıklama sayısı.

cross_device_conversions_by_conversion_date ve cross_device_conversions_value_by_conversion_date şu kaynaklarla uyumludur: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view ve shopping_performance_view.

Alan eşlemeleri yeniden tanımlandı

dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv alanlarının eşlemeleri bazı eski raporlar için değişti.

Alan	Önceden	Yeni Tanım
dfaActions	metrics.all_conversions - metrics.cross_device_conversions	metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv	metrics.all_conversions	metrics.all_conversions_by_conversion_date
dfaRevenue	metrics.all_conversions_value - metrics.cross_device_conversions_value	metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv	metrics.all_conversions_value	metrics.all_conversions_value_by_conversion_date
dfaTransactions	metrics.all_conversions - metrics.cross_device_conversions	metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv	metrics.all_conversions	metrics.all_conversions_by_conversion_date

Alan eşlemeyi değiştiren eski raporların listesi

• Hesap
• Reklam
• AdGroup
• AdGroupTarget
• Reklamveren
• BidStrategy
• Kampanya
• Keyword
• ProductAdvertised

Yeni alanlar

campaign.effective_labels ve ad_group.effective_labels ekliyoruz.

Etkili etiketler, devralınan veya doğrudan atanan etiketlerdir.

Yeni kaynaklar

Yeni effective_labels alanlarıyla ilgili olarak yeni kaynaklar, geçerli etiketler ile kampanya (campaign_effective_label) veya reklam grubu (ad_group_effective_label) arasındaki ilişkilendirmenin meta verilerini saklar.

v0 (2024-08-23)

Bu güncellemede, özel sütun meta verilerine renderType alanı ekleniyor.

CustomColumnRenderType ayrıntılarına bakın.

owner_customer_id alanı, campaign_label, ad_group_label, ad_group_ad_label ve ad_group_criterion_label kaynaklarına eklendi.

Bu yeni alanlardan yararlanmak için istemci kitaplığını güncellediğinizden emin olun.

v0 (2024-08-01)

Bu güncelleme, saatlik segmentasyonu ve birkaç yeni alanı içerir.

Saatlik segmentasyon

Artık sorguda saatlik segmentasyon belirtilebilir. Daha fazla ayrıntı için segments.hour bölümüne bakın.

customer_manager_link kaynağına start_time eklendi

Daha fazla bilgi için customer_manager_link.start_time başlıklı makaleyi inceleyin.

MULTIMEDIA_AD, ad_group_ad.ad.type öğesine eklendi.

Metrikler ve segmentler artık MULTIMEDIA_AD türüyle seçilebilir. Bu sürümde multimedya özelliklerine özgü özellikler sorgulanamaz.

campaign.advertising_channel_type için SOSYAL kampanya türü, campaign.advertising_channel_sub_type için ise SOCIAL_FACEBOOK_TRACKING_ONLY alt türü eklendi.

Metrikler ve segmentler artık SOSYAL kampanya türü ve SOSYAL_FACEBOOK_TRACKING_ONLY alt türüyle seçilebilir. SOSYAL veya SOSYAL_FACEBOOK_TRACKING_ONLY özelliklerine yönelik sorgular bu sürümde desteklenmez.

average_quality_score için destek eklendi

Daha fazla ayrıntı için metrikler bölümüne bakın.

v0 (18.04.2024)

Bu güncelleme, erişilebilir teklif stratejisi kaynağını içerir.

Erişilebilir Teklif Stratejisi

Müşteriye ait ve müşteriyle paylaşılan teklif stratejilerinin görünümünü temsil eder. Bu kaynak, BiddingStrategy'nin aksine, bu müşteriye ait stratejilerin yanı sıra müşterinin yöneticilerine ait olan ve bu müşteriyle paylaşılan stratejileri de içerir. Bu kaynak metrik sağlamaz ve yalnızca BiddingStrategy özelliklerinin sınırlı bir alt kümesini kullanıma sunar.

accessible_bidding_strategy kaynak ayrıntılarına bakın.

v0 (12.02.2024)

Bu güncelleme, özel sütunlara ve özel Floodlight değişkenlerine erişimi içerir.

Özel Sütunlar

Özel dönüşüm sütunları ve özel formül sütunları artık bir sorguda belirtilebilir. Daha fazla ayrıntı için Özel Sütunlar dokümanlarına bakın.

Özel Floodlight Değişkenleri

Özel Floodlight değişkenleri artık 2024/01/30 tarihinden sonraki istatistikler için bir sorguda belirtilebilir. Daha fazla bilgiyi Özel Floodlight değişkenleri dokümanında bulabilirsiniz.

v0 (09.11.2023)

Bu güncelleme aşağıdaki kaynakları içerir. Bu kaynaklar için sorgulanabilecek alanları ve bunlarla kullanılabilecek metrikleri ve segmentasyonları görmek için bağlantıları ziyaret edin.

Öğe Grubu

asset_group kaynağıyla ilgili ayrıntıları inceleyin.

Öğe Grubu Öğesi

asset_group_asset kaynağıyla ilgili ayrıntılara bakın.

Öğe grubu listeleme grubu filtresi

asset_group_listing_group_filter kaynak ayrıntılarına bakın.

Öğe grubu sinyali

asset_group_signal kaynağıyla ilgili ayrıntılara bakın.

Öğe Grubu En İyi Kombinasyon Görünümü

asset_group_top_combination_view kaynak ayrıntılarına bakın.

Alışveriş sepeti verileri satış görünümü

cart_data_sales_view kaynağıyla ilgili ayrıntıları inceleyin.

Dönüşüm

Dönüşüm kaynağı ayrıntılarını inceleyin.

Alışveriş Performansı Görünümü

shopping_performance_view kaynak ayrıntılarına bakın.

Ziyaret edin

Ziyaret kaynağı ayrıntılarına bakın.

v0 (15.08.2023)

Bu güncelleme aşağıdaki kaynakları ve metrikler için para birimi dönüşümünü yapılandırmaya yönelik yeni bir parametreyi içerir.

Bu kaynaklar için sorgulanabilecek alanları ve bunlarla kullanılabilecek metrikleri ve segmentasyonları görmek için bağlantıları ziyaret edin.

Reklam grubu öğesi

ad_group_asset kaynağıyla ilgili ayrıntılara bakın.

Reklam grubu öğe grubu

ad_group_asset_set kaynağıyla ilgili ayrıntıları inceleyin.

Öğe

Öğe kaynağı ayrıntılarına bakın.

Öğe grubu

asset_set kaynağıyla ilgili ayrıntılara bakın.

Öğe grubu öğesi

asset_set_asset kaynağıyla ilgili ayrıntılara bakın.

Kampanya öğesi

campaign_asset kaynağıyla ilgili ayrıntılara bakın.

Kampanya öğe grubu

campaign_asset_set kaynağıyla ilgili ayrıntıları inceleyin.

Müşteri öğesi

customer_asset kaynağıyla ilgili ayrıntılara bakın.

Müşteri öğe grubu

customer_asset_set kaynağıyla ilgili ayrıntıları inceleyin.

Para Birimi Dönüştürme

PARAMETRELER bölümünde metrics_currency kullanarak metrik hesaplaması için para birimini belirleyebilirsiniz.

Erişilebilir Müşterileri Listeleme

ListAccessibleCustomers yöntemini kullanarak erişilebilen tüm hesapları listeleyin.

v0 (15.05.2023)

Bu güncelleme aşağıdaki kaynağı içerir. Bu kaynak için sorgulanabilecek alanları ve bu kaynakla kullanılabilecek metrikleri ve segmentasyonları görmek için bağlantıları ziyaret edin.

Reklam Grubu Reklamı

ad_group_ad kaynağıyla ilgili ayrıntılara bakın.

v0 (2023-06-04)

Bu güncelleme aşağıdaki kaynakları içerir. Her kaynak için sorgulanabilecek alanları ve bu kaynakla kullanılabilecek metrikleri ve segmentasyonları görmek için bağlantıları ziyaret edin.

Reklam grubu kitle görünümü

ad_group_audience_view kaynağıyla ilgili ayrıntılara bakın.

Reklam grubu ölçütü etiketi

ad_group_criterion_label kaynağıyla ilgili ayrıntılara bakın.

Reklam grubu etiketi

ad_group_label kaynağıyla ilgili ayrıntılara bakın.

Yaş Aralığı Görünümü

age_range_view kaynağıyla ilgili ayrıntılara bakın.

Kampanya Ölçütü

campaign_criterion kaynağıyla ilgili ayrıntılara bakın.

Kampanya etiketi

campaign_label kaynağıyla ilgili ayrıntıları inceleyin.

Dinamik Arama Ağı Reklamları arama terimi görünümü

dynamic_search_ads_search_term_view kaynak ayrıntılarına bakın.

Web Sayfası Görüntüleme

webpage_view kaynak ayrıntılarına bakın.

Şirket

Etiket kaynağı ayrıntılarına bakın.

v0 (2022-12-05)

v0 sürümü aşağıdaki kaynakları ve hizmetleri içerir. Her kaynak için sorgulanabilecek alanları ve bu kaynakla kullanılabilecek metrikleri ve segmentasyonları görmek için bağlantıları ziyaret edin.

Reklam Grubu

ad_group kaynağıyla ilgili ayrıntıları inceleyin.

Teklif verme

bidding_strategy kaynağıyla ilgili ayrıntılara bakın.

Kampanyalar

Kampanya kaynağı ayrıntılarını inceleyin.

Dönüşüm İşlemi

conversion_action kaynağıyla ilgili ayrıntıları inceleyin.

Müşteri

Müşteri kaynağı ayrıntılarına bakın.

Keyword

keyword_view kaynağıyla ilgili ayrıntıları inceleyin.

Ürün Grubu

product_group_view kaynağıyla ilgili ayrıntılara bakın.

SearchAds360FieldService

• SearchAds360FieldService, sorgulanabilir tüm alanların kataloğunu sağlar. Bu alanlardaki meta veriler arasında açıklamalar, türler ve diğer alanlarla uyumluluk yer alır. Daha fazla bilgi edinin.

SearchAds360Service

• SearchAds360Service, tek bir sorguda birden fazla kaynağı almak için kullanılır. Sorgulanabilir kaynaklar şunlardır:

  • AdGroup
  • BiddingStrategy
  • Campaign
  • ConversionAction
  • Customer
  • Keyword
  • ProductGroup

• Gösterim ve tıklama gibi metrikler, aşağıdaki kaynaklar için SearchAds360Service kullanılarak da alınabilir:

  • AdGroup
  • BiddingStrategy
  • Campaign
  • ConversionAction
  • Customer
  • Keyword
  • ProductGroup

• SearchAds360Service Tarih alanları gibi alanlara göre segmentasyon yapılmasına olanak tanır. Daha fazla bilgi edinin.