Değişiklik günlüğü

Resmi Google Analytics API duyuruları için Google Analytics API Notify Group'a abone olun.

14.09.2026 v1 alfa sürümüne sohbet sorgusu desteği eklendi

Doğal dil sorgularını kullanarak Google Analytics verileriyle etkileşim kurma properties.chat yöntemi eklendi.

14.09.2026 Yanıtlara veri kesme nedenleri eklendi

v1 beta ve v1 alfa sürümlerinde ResponseMetaData'ya dataTruncationReasons alanı eklendi. Bir raporun verileri kısaltıldığında bu alan, kısaltma türünü, açıklayıcı bir mesajı ve etkilenen tarihleri içeren DataTruncationReason nesnelerinin listesini içerir.

23.04.2026 v1 alfa sürümünde dönüşüm raporlama desteği eklendi

Veri API'si v1 alfa sürümünde Dönüşüm performansı raporundan veri almak için runReport yöntemi kullanılarak veri alma desteği eklendi. Bu sayede, Google Analytics kullanıcı arayüzünde Reklamcılık > Dönüşüm performansı bölümünde bulunan aynı dönüşüm verilerine erişebilirsiniz.

  • ConversionSpec alanını RunReportRequest'a ekledik. Bu alan, conversionActions (dönüşüm işlemi kimlikleri) kullanılarak dönüşümlerin filtrelenmesine ve AttributionModel (DATA_DRIVEN veya LAST_CLICK) seçilmesine olanak tanır.
  • Raporlardaki verilerin standart raporlamadan (SECTION_REPORT) mı yoksa dönüşüm raporlamadan (SECTION_ADVERTISING) mı geldiğini belirlemek için Section alanı ResponseMetaData'a eklendi.

Dönüşüm raporlama bilgileri sağlamak için Data API v1 alfa sürümündeki getMetadata yöntemi güncellendi:

  • Dönüşüm işlemi kimliklerini görünen adlarla eşleyen ConversionMetadata nesnelerinin listesini döndüren yanıta conversions alanı eklendi.
  • Belirli bir alanın standart raporlama, dönüşüm raporlama veya her ikisiyle de uyumlu olup olmadığını belirlemek için DimensionMetadata ve MetricMetadata'ya sections alanı eklendi.

20.10.2024 EmptyFilter boyut filtresi türü eklendi.

EmptyFilter boyut filtresini kullanarak boş bir değerle karşılaştırma yapmak için filtreleme koşulları oluşturabilirsiniz.

15.10.2024 reportTasks yöntemine örnekleme düzeyi özelliği eklendi

properties.runReportTask yönteminin samplingLevel alanını kullanarak raporun örnekleme düzeyini kontrol edebilirsiniz.

Bu özellik, Google Analytics 360 mülklerine 1 milyar etkinliklik daha yüksek örnekleme sınırlarına erişim imkanı sunar. Ayrıca, büyük etkinlik sayısı içeren örneklenmemiş sonuçlar için örnekleme sınırları UNSAMPLED olarak ayarlanabilir.

18.09.2024 Mülk kotaları anlık görüntü özelliği eklendi

properties.getPropertyQuotasSnapshot yöntemini kullanarak, belirli bir mülk için kota kategorisine göre düzenlenmiş tüm mülk kotalarının mevcut anlık görüntüsünü alabilirsiniz.

28.06.2024 "Mülk başına proje başına istemci hataları" kotası eklendi

Artık 15 dakikalık süre içinde proje ve mülk başına 10.000 API sunucusu hatasına izin veriliyor. Bu, 500 veya 200 dışındaki bir kodla sonuçlanan tüm istekleri içerir. Bu kota kapsamına giren hata örnekleri: Uyumsuz boyut ve metrik kombinasyonlarının kullanılması, tüm kimlik doğrulama hataları.

Bu sınır aşılırsa 15 dakikalık süre sona erene kadar ilgili Google Cloud projesi için bu mülke yönelik diğer API çağrıları geçici olarak engellenir.

14.05.2024 Karşılaştırmalar özelliği eklendi

Karşılaştırmalar'ı kullanarak verilerinizin alt kümelerini yan yana değerlendirebilirsiniz.

Data API v1beta'nın temel raporlama yöntemleri, comparisons alanını destekleyecek şekilde güncellendi. Bu alan, dahil edildiğinde istenen karşılaştırmaların yapılandırmasını belirtir.

İsteklerde, dimensionFilter ifadesini istekle birlikte sağlayarak temel bir karşılaştırma belirtebilir veya karşılaştırmanın kaynak adını comparison alanında sağlayarak kaydedilmiş bir karşılaştırmayı kullanabilirsiniz.

getMetadata yöntemi, bir mülk için kullanılabilen tüm kayıtlı karşılaştırmaları comparisons yanıt alanında listeleyecek şekilde güncellendi.

Bir istekte en az bir karşılaştırma belirtildiğinde yanıtta her karşılaştırmayı tanımlayan comparison sütunu yer alır.

Şu anda kaydedilmiş karşılaştırmalar yalnızca Google Analytics kullanıcı arayüzü kullanılarak oluşturulabilir.

2024-05-08 Veri API'si v1alpha'ya eşzamansız raporlama özelliği olan rapor görevleri eklendi.

Rapor görevlerini kullanarak Google Analytics etkinlik verilerinizin Özel Raporunu oluşturmak için uzun süren bir asenkron istek başlatabilirsiniz.

Aşağıdaki rapor görevi manipülasyonu yöntemleri Data API v1alpha'ya eklendi:

06.05.2024 Önemli etkinlikler için yeni boyutlar

Önemli etkinlikler için boyutlar ve metrikler artık kullanılabilir.

isConversionEvent boyutunu kullanan rapor isteklerinizi, bunun yerine isKeyEvent boyutunu kullanacak şekilde değiştirin.

Aşağıdaki tabloda desteği sonlandırılan bir metriği kullanan tüm rapor isteklerini, bunun yerine önemli etkinlik metriğini kullanacak şekilde değiştirin.

Kullanımdan kaldırılan metrik Önemli Etkinlik Metriği
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

Rapor isteklerinizde tek bir önemli etkinliğe ait önemli etkinlik metriklerinin kullanıldığı yerlerde benzer değişiklikler yapın.

properties/getMetadata yönteminin yanıtı, DimensionMetadata ve MetricMetadata nesnelerinde önemli etkinlik boyutlarının ve metriklerinin kullanıma sunulmasını aşağıdaki şekilde yansıtır:

  • apiName, uiName ve description, önemli etkinlik API'sinin adını, kullanıcı arayüzü adını ve açıklamasını içerir.
  • deprecatedApiNames yinelenen alanında, desteği sonlandırılan dönüşüm API'si adını içeren bir giriş var.

25.03.2024 Birincil kanal grubu, manuel trafik kaynağı ve entegrasyona özgü boyutlar eklendi.

Veri API'si şemasına birincil kanal grubu, manuel trafik kaynağı ve CM360, DV360, SA360 entegrasyonuna özgü boyutlar eklendi.

Kitle boyutları:

  • audienceId Kitle kimliği. Bir kitlenin sayısal tanımlayıcısı.

Birincil kanal grubu boyutları:

  • firstUserPrimaryChannelGroup İlk kullanıcı birincil kanal grubu

  • primaryChannelGroup Birincil kanal grubu

  • sessionPrimaryChannelGroup Oturumla ilişkilendirilen birincil kanal grubu

Manuel trafik kaynağı boyutları:

  • manualCampaignId Manuel kampanya kimliği

  • manualCampaignName Manuel kampanya adı

  • manualCreativeFormat Manuel reklam öğesi biçimi

  • manualMarketingTactic Kılavuz pazarlama taktiği

  • manualMedium Manuel aracı

  • manualSource Manuel kaynak

  • manualSourceMedium Manuel kaynak / aracı

  • manualSourcePlatform Manuel kaynak platform

  • firstUserManualCampaignId Kullanıcıyla ilk ilişkilendirilen manuel kampanya kimliği

  • firstUserManualCampaignName Kullanıcıyla ilk ilişkilendirilen manuel kampanya adı

  • firstUserManualCreativeFormat İlk kullanıcı kullanım kılavuzu reklam öğesi biçimi

  • firstUserManualMarketingTactic İlk kullanıcı kullanım kılavuzu pazarlama taktiği

  • firstUserManualMedium İlk kullanıcı kullanım kılavuzu

  • firstUserManualSource İlk kullanıcı kılavuzu kaynağı

  • firstUserManualSourceMedium Kullanıcıyla ilk ilişkilendirilen manuel kaynak / aracı

  • firstUserManualSourcePlatform İlk kullanıcı kılavuzu kaynak platformu

  • sessionManualCampaignId Oturumun manuel kampanya kimliği

  • sessionManualCampaignName Oturumla ilişkilendirilen manuel kampanya adı

  • sessionManualCreativeFormat Oturumun manuel reklam öğesi biçimi

  • sessionManualMarketingTactic Oturumla ilişkilendirilen manuel pazarlama taktiği

  • sessionManualMedium Oturumla ilişkilendirilen manuel aracı

  • sessionManualSource Oturumla ilişkilendirilen manuel kaynak

  • sessionManualSourceMedium Oturumla ilişkilendirilen manuel kaynak / aracı

  • sessionManualSourcePlatform Oturumun manuel kaynak platformu

Campaign Manager 360 (CM360) entegrasyon boyutları:

  • cm360AccountId CM360 hesap kimliği

  • cm360AccountName CM360 hesap adı

  • cm360AdvertiserId CM360 reklamveren kimliği

  • cm360AdvertiserName CM360 reklamveren adı

  • cm360CampaignId CM360 kampanya kimliği

  • cm360CampaignName CM360 kampanya adı

  • cm360CreativeFormat CM360 reklam öğesi biçimi

  • cm360CreativeId CM360 reklam öğesi kimliği

  • cm360CreativeName CM360 reklam öğesi adı

  • cm360CreativeType CM360 reklam öğesi türü

  • cm360CreativeTypeId CM360 reklam öğesi türü kimliği

  • cm360CreativeVersion CM360 reklam öğesi sürümü

  • cm360Medium CM360 aracısı

  • cm360PlacementCostStructure CM360 yerleşim maliyeti yapısı

  • cm360PlacementId CM360 yerleşim kimliği

  • cm360PlacementName CM360 yerleşim adı

  • cm360RenderingId CM360 oluşturma kimliği

  • cm360SiteId CM360 site kimliği

  • cm360SiteName CM360 site adı

  • cm360Source CM360 kaynağı

  • cm360SourceMedium CM360 kaynağı / aracısı

  • firstUserCm360AccountId İlk kullanıcıyla ilişkilendirilen CM360 hesap kimliği

  • firstUserCm360AccountName İlk kullanıcıyla ilişkilendirilen CM360 hesap adı

  • firstUserCm360AdvertiserId İlk kullanıcıyla ilişkilendirilen CM360 reklamveren kimliği

  • firstUserCm360AdvertiserName İlk kullanıcıyla ilişkilendirilen CM360 reklamveren adı

  • firstUserCm360CampaignId İlk kullanıcıyla ilişkilendirilen CM360 kampanya kimliği

  • firstUserCm360CampaignName İlk kullanıcıyla ilişkilendirilen CM360 kampanya adı

  • firstUserCm360CreativeFormat İlk kullanıcıyla ilişkilendirilen CM360 reklam öğesi biçimi

  • firstUserCm360CreativeId İlk kullanıcıyla ilişkilendirilen CM360 reklam öğesi kimliği

  • firstUserCm360CreativeName İlk kullanıcıyla ilişkilendirilen CM360 reklam öğesi adı

  • firstUserCm360CreativeType İlk kullanıcıyla ilişkilendirilen CM360 reklam öğesi türü

  • firstUserCm360CreativeTypeId İlk kullanıcıyla ilişkilendirilen CM360 reklam öğesi türü kimliği

  • firstUserCm360CreativeVersion İlk kullanıcıyla ilişkilendirilen CM360 reklam öğesi sürümü

  • firstUserCm360Medium İlk kullanıcıyla ilişkilendirilen CM360 aracısı

  • firstUserCm360PlacementCostStructure İlk kullanıcıyla ilişkilendirilen CM360 yerleşim maliyeti yapısı

  • firstUserCm360PlacementId İlk kullanıcıyla ilişkilendirilen CM360 yerleşim kimliği

  • firstUserCm360PlacementName İlk kullanıcıyla ilişkilendirilen CM360 yerleşim adı

  • firstUserCm360RenderingId İlk kullanıcıyla ilişkilendirilen CM360 oluşturma kimliği

  • firstUserCm360SiteId İlk kullanıcıyla ilişkilendirilen CM360 site kimliği

  • firstUserCm360SiteName İlk kullanıcıyla ilişkilendirilen CM360 site adı

  • firstUserCm360Source İlk kullanıcıyla ilişkilendirilen CM360 kaynağı

  • firstUserCm360SourceMedium İlk kullanıcıyla ilişkilendirilen CM360 kaynağı / aracısı

  • sessionCm360AccountId Oturumla ilişkilendirilen CM360 hesap kimliği

  • sessionCm360AccountName Oturumla ilişkilendirilen CM360 hesap adı

  • sessionCm360AdvertiserId Oturumla ilişkilendirilen CM360 reklamveren kimliği

  • sessionCm360AdvertiserName Oturumla ilişkilendirilen CM360 reklamveren adı

  • sessionCm360CampaignId Oturumla ilişkilendirilen CM360 kampanyası kimliği

  • sessionCm360CampaignName Oturumla ilişkilendirilen CM360 kampanyası adı

  • sessionCm360CreativeFormat Oturumla ilişkilendirilen CM360 reklam öğesi biçimi

  • sessionCm360CreativeId Oturumla ilişkilendirilen CM360 reklam öğesi kimliği

  • sessionCm360CreativeName Oturumla ilişkilendirilen CM360 reklam öğesi adı

  • sessionCm360CreativeType Oturumla ilişkilendirilen CM360 reklam öğesi türü

  • sessionCm360CreativeTypeId Oturumla ilişkilendirilen CM360 reklam öğesi türü kimliği

  • sessionCm360CreativeVersion Oturumla ilişkilendirilen CM360 reklam öğesi sürümü

  • sessionCm360Medium Oturumla ilişkilendirilen CM360 aracısı

  • sessionCm360PlacementCostStructure Oturumla ilişkilendirilen CM360 yerleşim maliyeti yapısı

  • sessionCm360PlacementId Oturumla ilişkilendirilen CM360 yerleşim kimliği

  • sessionCm360PlacementName Oturumla ilişkilendirilen CM360 yerleşim adı

  • sessionCm360RenderingId Oturumla ilişkilendirilen CM360 oluşturma kimliği

  • sessionCm360SiteId Oturumla ilişkilendirilen CM360 site kimliği

  • sessionCm360SiteName Oturumla ilişkilendirilen CM360 site adı

  • sessionCm360Source Oturumla ilişkilendirilen CM360 kaynağı

  • sessionCm360SourceMedium Oturumla ilişkilendirilen CM360 kaynağı / aracısı

Google Display & Video 360 (DV360) entegrasyon boyutları:

  • dv360AdvertiserId DV360 reklamveren kimliği

  • dv360AdvertiserName DV360 reklamveren adı

  • dv360CampaignId DV360 kampanya kimliği

  • dv360CampaignName DV360 kampanyası adı

  • dv360CreativeFormat DV360 reklam öğesi biçimi

  • dv360CreativeId DV360 reklam öğesi kimliği

  • dv360CreativeName DV360 reklam öğesi adı

  • dv360ExchangeId DV360 exchange kimliği

  • dv360ExchangeName DV360 exchange adı

  • dv360InsertionOrderId DV360 kampanya siparişi kimliği

  • dv360InsertionOrderName DV360 kampanya siparişi adı

  • dv360LineItemId DV360 satır öğesi kimliği

  • dv360LineItemName DV360 satır öğesi adı

  • dv360Medium DV360 aracısı

  • dv360PartnerId DV360 iş ortağı kimliği

  • dv360PartnerName DV360 iş ortağı adı

  • dv360Source DV360 kaynağı

  • dv360SourceMedium DV360 kaynağı / aracısı

  • firstUserDv360AdvertiserId İlk kullanıcı DV360 reklamveren kimliği

  • firstUserDv360AdvertiserName İlk kullanıcı DV360 reklamveren adı

  • firstUserDv360CampaignId İlk kullanıcı DV360 kampanya kimliği

  • firstUserDv360CampaignName İlk kullanıcı DV360 kampanya adı

  • firstUserDv360CreativeFormat İlk kullanıcı DV360 reklam öğesi biçimi

  • firstUserDv360CreativeId İlk kullanıcı DV360 reklam öğesi kimliği

  • firstUserDv360CreativeName İlk kullanıcı DV360 reklam öğesi adı

  • firstUserDv360ExchangeId İlk kullanıcı DV360 exchange kimliği

  • firstUserDv360ExchangeName İlk kullanıcı DV360 exchange adı

  • firstUserDv360InsertionOrderId İlk kullanıcı DV360 kampanya siparişi kimliği

  • firstUserDv360InsertionOrderName İlk kullanıcı DV360 kampanya siparişi adı

  • firstUserDv360LineItemId İlk kullanıcı DV360 satır öğesi kimliği

  • firstUserDv360LinteItemName İlk kullanıcı DV360 satır öğesi adı

  • firstUserDv360Medium İlk kullanıcı DV360 aracısı

  • firstUserDv360PartnerId İlk kullanıcı DV360 iş ortağı kimliği

  • firstUserDv360PartnerName İlk kullanıcı DV360 iş ortağı adı

  • firstUserDv360Source İlk kullanıcı DV360 kaynağı

  • firstUserDv360SourceMedium İlk kullanıcı DV360 kaynağı / aracısı

  • sessionDv360AdvertiserId Oturumla ilişkilendirilen DV360 reklamveren kimliği

  • sessionDv360AdvertiserName Oturumla ilişkilendirilen DV360 reklamveren adı

  • sessionDv360CampaignId Oturumla ilişkilendirilen DV360 kampanya kimliği

  • sessionDv360CampaignName Oturumla ilişkilendirilen DV360 kampanyası adı

  • sessionDv360CreativeFormat Oturumla ilişkilendirilen DV360 reklam öğesi biçimi

  • sessionDv360CreativeId Oturumla ilişkilendirilen DV360 reklam öğesi kimliği

  • sessionDv360CreativeName Oturumla ilişkilendirilen DV360 reklam öğesi adı

  • sessionDv360ExchangeId Oturumla ilişkilendirilen DV360 exchange kimliği

  • sessionDv360ExchangeName Oturumla ilişkilendirilen DV360 exchange adı

  • sessionDv360InsertionOrderId Oturumla ilişkilendirilen DV360 kampanya siparişi kimliği

  • sessionDv360InsertionOrderName Oturumla ilişkilendirilen DV360 kampanya siparişi adı

  • sessionDv360LineItemId Oturumla ilişkilendirilen DV360 satır öğesi kimliği

  • sessionDv360LineItemName Oturumla ilişkilendirilen DV360 satır öğesi adı

  • sessionDv360Medium Oturumla ilişkilendirilen DV360 aracısı

  • sessionDv360PartnerId Oturumla ilişkilendirilen DV360 iş ortağı kimliği

  • sessionDv360PartnerName Oturumla ilişkilendirilen DV360 iş ortağı adı

  • sessionDv360Source Oturumla ilişkilendirilen DV360 kaynağı

  • sessionDv360SourceMedium Oturumla ilişkilendirilen DV360 kaynağı / aracısı

Google Search Ads 360 (SA360) entegrasyonu boyutları:

  • firstUserSa360AdGroupId İlk kullanıcı SA360 reklam grubu kimliği

  • firstUserSa360AdGroupName İlk kullanıcı SA360 reklam grubu adı

  • firstUserSa360CampaignId İlk kullanıcı SA360 kampanya kimliği

  • firstUserSa360CampaignName İlk kullanıcı SA360 kampanyası

  • firstUserSa360CreativeFormat İlk kullanıcı SA360 reklam öğesi biçimi

  • firstUserSa360EngineAccountId İlk kullanıcı SA360 arama motoru hesabı kimliği

  • firstUserSa360EngineAccountName İlk kullanıcı SA360 arama motoru hesabı adı

  • firstUserSa360EngineAccountType İlk kullanıcı SA360 arama motoru hesabı türü

  • firstUserSa360KeywordText İlk kullanıcı SA360 anahtar kelime metni

  • firstUserSa360ManagerAccountId İlk kullanıcı SA360 yönetici hesabı kimliği

  • firstUserSa360ManagerAccountName İlk kullanıcı SA360 yönetici hesabı adı

  • firstUserSa360Medium İlk kullanıcı SA360 aracısı

  • firstUserSa360Query İlk kullanıcı SA360 sorgusu

  • firstUserSa360Source İlk kullanıcı SA360 kaynağı

  • firstUserSa360SourceMedium İlk kullanıcı SA360 kaynağı / aracısı

  • sa360AdGroupId SA360 reklam grubu kimliği

  • sa360CampaignId SA360 kampanya kimliği

  • sa360AdGroupName SA360 reklam grubu adı

  • sa360CampaignName SA360 kampanyası

  • sa360CreativeFormat SA360 reklam öğesi biçimi

  • sa360EngineAccountId SA360 arama motoru hesabı kimliği

  • sa360EngineAccountName SA360 arama motoru hesabı adı

  • sa360EngineAccountType SA360 arama motoru hesabı türü

  • sa360KeywordText SA360 anahtar kelime metni

  • sa360ManagerAccountId SA360 yönetici hesabı kimliği

  • sa360ManagerAccountName SA360 yönetici hesabı adı

  • sa360Medium SA360 aracısı

  • sa360Query SA360 sorgusu

  • sa360Source SA360 kaynağı

  • sa360SourceMedium SA360 kaynağı / aracısı

  • sessionSa360AdGroupId Oturumla ilişkilendirilen SA360 reklam grubu kimliği

  • sessionSa360CampaignId Oturumla ilişkilendirilen SA360 kampanya kimliği

  • sessionSa360ManagerAccountId Oturumla ilişkilendirilen SA360 yönetici hesabı kimliği

  • sessionSa360ManagerAccountName Oturumla ilişkilendirilen SA360 yönetici hesabı adı

  • sessionSa360SourceMedium Oturumla ilişkilendirilen SA360 kaynağı / aracısı

06.03.2024 Kitle dışa aktarma işlemlerinde etkin olmayan kullanıcı kitleleri desteği.

Kitle dışa aktarma özelliği, etkin olmayan kullanıcı kitlelerinin dışa aktarılmasını daha iyi destekler. Kullanıcılar bu kitlelere uygun bir etkinlik olmadan girer. Örneğin, kullanıcı web sitenizi yedi gün boyunca ziyaret etmeyerek kitleye girebilir. Etkin olmayan kullanıcı kitlelerine örnek olarak "7 gündür etkin olmayan alıcılar", "7 gündür etkin olmayan kullanıcılar" ve "7 gündür bildirim almayan kullanıcılar" verilebilir. Bu önerilen kitleler hakkında daha fazla bilgi edinmek için Önerilen kitleler başlıklı makaleyi inceleyin.

28.02.2024 Kitle dışa aktarma işlemleri, etiketlemede belirtilen kullanıcı kimliğini döndürür.

Kitle dışa aktarma işlemleri artık, mülkünüzde kullanıcı tarafından sağlanan veriler etkinleştirilmiş olsa bile etiketlemede belirtilen kullanıcı kimliğini döndürüyor. Kullanıcı tarafından sağlanan verilerin toplanması özelliği etkinleştirilirse ölçümü iyileştirmek için etiketlemede kullanıcı tarafından sağlanan veriler User-ID ile birlikte Google Analytics'e gönderilebilir. Daha fazla bilgi edinmek için Kullanıcı tarafından sağlanan verileri toplama başlıklı makaleyi inceleyin.

30.01.2024 Data API v1 alfa sürümünde kitle listeleri ve yinelenen kitle listeleri için webhook bildirimleri desteği.

AudienceList.webhookNotification ve RecurringAudienceList.webhookNotification alanları, Kitle Listesi (properties.audienceLists.create kullanılarak) veya Yinelenen Kitle Listesi (properties.recurringAudienceLists.create kullanılarak) oluşturulurken belirtilebilir.

Bu işlev, bir kitle listesi kullanıma sunulduğunda Webhook bildirimlerini eşzamansız olarak almanıza olanak tanır.

18.01.2024 Sorgu dizesini veya dakika bileşenini içeren boyutlar için uyumluluk iyileştirildi.

Sorgu dizesini içeren boyutlar artık çoğu alanla uyumludur. pagePathPlusQueryString, unifiedPageScreen, pageLocation ve fullPageUrl gibi boyutlar artık sessionSource, browser, city ve landingPage gibi birçok ek alanla uyumlu.

Dakika bileşenini içeren boyutlar artık çoğu alanla uyumlu. minute, nthMinute ve dateHourMinute gibi boyutlar artık benzer bir ek alan grubuyla uyumludur.

Kapsamlı uyumluluk bilgileri için GA4 Boyut ve Metrik Gezgini'ne bakın.

13.12.2023 Öğe kapsamlı özel parametreler

Öğe kapsamlı özel boyutlar artık Analytics Veri API'si sorgularına aşağıdaki söz dizimi kullanılarak eklenebilir:

Genel API Adı Açıklama
customItem:parameter_name parameter_name için öğe kapsamlı özel boyut

Daha fazla bilgi için API Boyutları ve Metrikleri bölümünü inceleyin.

2023-12-05 Kitle Listeleri, Veri API'si v1 beta sürümünde Kitle Dışa Aktarma İşlemleri olarak kullanılabilir

Kitle Listeleri özelliği, Kitle Dışa Aktarma İşlemleri olarak yeniden adlandırıldı ve Data API v1 beta sürümüne eklendi.

Data API v1 beta sürümüne aşağıdaki yöntemler eklendi:

28.11.2023 Rapor yanıtına samplingMetadatas eklendi

samplingMetadatas öğesi ResponseMetaData öğesine eklendi. Bu koleksiyonda, sonuçların örneklenmiş olduğu istekteki her tarih aralığı için bir SampleMetadata bulunur. Google Analytics, yalnızca kardinalite sınırlarının veri kalitesini düşüreceğini tahmin ettiğinde örnekleme uygular.

28.11.2023 Veri API'si v1 alfa sürümüne yinelenen kitle listesi dışa aktarma işlevi eklendi.

Data API v1 alfa sürümüne properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list yöntemleri eklendi.

Bu işlev, kitle üyelikleri değiştikçe günlük olarak kitle listeleri oluşturmanıza olanak tanır. Yinelenen kitle listeleri, en yeni kitle üyeliği sonuçlarıyla çalıştığınızdan emin olmanızı sağlar.

13.10.2023 1 günlük üyelik sürelerine sahip kitleler için destek eklendi.

1 günlük üyelik sürelerine sahip kitleler artık kitle listelerini dışa aktarma işlevi tarafından desteklenmektedir.

12.09.2023 AudienceList varsayılan sıralama kuralları

Kitle listeleri dışa aktarma işlevi kullanılarak oluşturulan raporlar varsayılan olarak, Data API'nin diğer raporlama yöntemleriyle aynı sıralama kurallarına uyar: Sıralama önce ilk sütuna göre azalan, ardından ikinci sütuna göre azalan şekilde yapılır.

Bu değişiklikten önce aşağıdaki raporu almış olabilirsiniz:

deviceId isAdsPersonalizationAllowed
ABC doğru
DAC yanlış
ABC yanlış
AAA doğru

Bu değişiklikten sonra aşağıdaki raporu alırsınız:

deviceId isAdsPersonalizationAllowed
AAA doğru
ABC yanlış
ABC doğru
DAC yanlış

15.08.2023 Kitle listesi dışa aktarma şemasına isLimitedAdTracking boyutu eklendi

  • isLimitedAdTracking Cihazın "Reklam İzlemeyi Sınırla" ayarı. Olası değerler arasında true, false ve (not set) yer alır.

    Daha fazla bilgi için Kitle Listesi Boyutları bölümünü inceleyin.

15.08.2023 currencyCode boyutu ve itemDiscountAmount metriği eklendi.

  • currencyCode E-ticaret etkinliğinin yerel para birimi kodu (ISO 4217 standardına göre). Örneğin, "USD" veya "GBP".

  • itemDiscountAmount E-ticaret etkinliklerindeki öğe indirimlerinin maddi değeri. Bu metrik, etiketlemede "discount" öğe parametresiyle doldurulur.

Daha fazla bilgi için Data API raporlama şeması başlıklı makaleyi inceleyin.

10.08.2023 Kitle listesi dışa aktarma şemasına isAdsPersonalizationAllowed boyutu eklendi

  • isAdsPersonalizationAllowed Reklam kişiselleştirmeye izin verilir. Bir kullanıcı reklam kişiselleştirme için uygunsa isAdsPersonalizationAllowed true değerini döndürür. Bir kullanıcı reklam kişiselleştirme için uygun değilse isAdsPersonalizationAllowed değerini döndürür false.

    Daha fazla bilgi için Kitle Listesi Boyutları bölümünü inceleyin.

10.07.2023 Kitle Listeleri

Veri API'si v1 alfa sürümüne kitle listeleri desteği eklendi. Kitle listeleri, kitle listesi oluşturulurken kitlenin kullanıcılarının anlık görüntüsünü içerir.

Data API v1 alfa sürümüne aşağıdaki yöntemler eklendi:

19.05.2023 Özel Kanal Grupları

Veri API'sine özel kanal grupları desteği eklendi.

11.05.2023: Jeton kotası değişiklikleri.

Veri API'sinin kota sistemi, daha hassas ücretlendirmeye olanak tanıyacak şekilde güncellendi.

Her istek için alınan jeton sayısı, kota değişikliğine uygun olarak güncellendi ve yeniden dengelendi. Bu sayede, büyük tarihli raporlar için önemli ölçüde daha fazla kota jetonu alınırken daha fazla sayıda basit raporlama sorgusuna izin verilecek.

Bu değişiklikten sonra bazı isteklerin ücreti aynı kalırken daha karmaşık sorguların ücretlerinde belirgin bir artış olacaktır. Örneğin, 6 aydan uzun süreli veriler için yapılan istekler 1.000 veya daha fazla kota jetonu kullanabilir.

Standart Özellikler

Kota Adı Eski Sınır Yeni sınır
Mülk başına günlük temel jeton sayısı 25.000 200.000
Mülk başına saatlik çekirdek jeton sayısı 5.000 40.000
Proje başına, mülk başına saatlik çekirdek jeton sayısı 1.750 14.000
Mülk başına günlük gerçek zamanlı jeton sayısı 25.000 200.000
Mülk başına saatlik gerçek zamanlı jeton sayısı 5.000 40.000
Proje başına, mülk başına, saatlik gerçek zamanlı jeton sayısı 1.750 14.000
Mülk başına günlük dönüşüm hunisi jetonları 25.000 200.000
Mülk başına saatlik dönüşüm hunisi jetonu sayısı 5.000 40.000
Dönüşüm Hunisi Jetonları (Proje Başına, Mülk Başına, Saatlik) 1.750 14.000

Analytics 360 mülkleri

Kota Adı Eski Sınır Yeni sınır
Mülk başına günlük temel jeton sayısı 250.000 2.000.000
Mülk başına saatlik çekirdek jeton sayısı 50.000 400.000
Proje başına, mülk başına saatlik çekirdek jeton sayısı 17.500 140.000
Mülk başına günlük gerçek zamanlı jeton sayısı 250.000 2.000.000
Mülk başına saatlik gerçek zamanlı jeton sayısı 50.000 400.000
Proje başına, mülk başına, saatlik gerçek zamanlı jeton sayısı 17.500 140.000
Mülk başına günlük dönüşüm hunisi jetonları 250.000 2.000.000
Mülk başına saatlik dönüşüm hunisi jetonu sayısı 50.000 400.000
Dönüşüm Hunisi Jetonları (Proje Başına, Mülk Başına, Saatlik) 17.500 140.000

2023-03-02 Tarih boyutları eklendi.

  • dayOfWeekName Haftanın gününün adı. Haftanın günü (İngilizce). Bu boyutun değerleri Sunday, Monday vb. şeklindedir.

  • isoWeek ISO yılın haftası. Her haftanın pazartesi günü başladığı ISO hafta numarası. Ayrıntılar için https://en.wikipedia.org/wiki/ISO_week_date adresini ziyaret edin. Örnek değerler arasında 01, 02 ve 53 yer alır.

  • isoYear ISO yılı. Etkinliğin ISO yılı. Ayrıntılar için https://en.wikipedia.org/wiki/ISO_week_date adresini ziyaret edin. Örnek değerler arasında 2022 ve 2023 yer alır.

  • isoYearIsoWeek ISO yılının ISO haftası. isoWeek ve isoYear değerlerinin birleşimi. Örnek değerler arasında 201652 ve 201701 yer alır.

  • yearMonth Yıl ay. year ve month değerlerinin birleşimi. Örnek değerler arasında 202212 veya 202301 yer alır.

  • yearWeek Yılın haftası. year ve week değerlerinin birleşimi. Örnek değerler arasında 202253 veya 202301 yer alır.

27.02.2023 E-ticaret boyutları eklendi.

  • itemListPosition Öğe listesi konumu. Bir öğenin (ör. sattığınız bir ürün) listedeki konumu. Bu boyut, etiketlemede items dizisindeki "index" parametresiyle doldurulur.

  • itemLocationID Öğe yer kodu. Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google yer kimliğini kullanmanız önerilir. Özel bir yer kodu da kullanılabilir. Bu alan, etiketlemede items dizisindeki "location_id" parametresiyle doldurulur.

  • itemPromotionCreativeSlot Öğe promosyonu reklam öğesi alanı. Öğeyle ilişkili promosyon reklam öğesi alanının adı. Bu boyut, etkinlik veya öğe düzeyinde creative_slot parametresiyle etiketlemede belirtilebilir. Parametre hem etkinlik hem de öğe düzeyinde belirtilmişse öğe düzeyindeki parametre kullanılır.

21.02.2023 "Açılış sayfası + sorgu dizesi" boyutu eklendi.

  • landingPagePlusQueryString Açılış sayfası ve sorgu dizesi. Bir oturumdaki ilk sayfa görüntülemeyle ilişkilendirilmiş sayfa yolu + sorgu dizesi.

Bu alan, kullanımdan kaldırılan landingPage boyutunun yerini almıştır ve 14 Mayıs 2023'te sorgu dizesi döndürmeyecek şekilde güncellenecektir.

2023-01-28 "Kullanıcı başına görüntüleme sayısı" ve "Kaydırma yapan kullanıcılar" metrikleri eklendi.

  • screenPageViewsPerUser kullanıcı başına görüntüleme sayısı. Kullanıcılarınızın etkin kullanıcı başına görüntülediği uygulama ekranı veya web sayfası sayısı. Tek bir sayfanın veya ekranın yinelenen gösterimleri de sayılır. (screen_view + page_view events) / active users.

  • scrolledUsers Sayfayı kaydıran kullanıcılar. Sayfanın en az% 90'ını aşağı kaydıran tekil kullanıcıların sayısı.

23.01.2023 "Kıta", "Kıta Kimliği" boyutları eklendi.

  • continent Kıta. Kullanıcı etkinliğinin gerçekleştiği kıta. Örneğin, Americas veya Asia

  • continentId Kıta kimliği. Kullanıcı etkinliğinin gerçekleştiği kıtanın coğrafi kimliği. Kullanıcının IP adresinden türetilir.

23.01.2023 "Test verileri filtre kimliği" boyutu eklendi.

  • testDataFilterId Test verileri filtre kimliği. Test durumundaki bir veri filtresinin sayısal tanımlayıcısı. Etkinlik parametre değerlerini temel alarak etkinlik verilerini rapor kapsamına eklemek veya hariç tutmak için veri filtrelerini kullanabilirsiniz. Daha fazla bilgi edinmek için https://support.google.com/analytics/answer/10108813 adresini ziyaret edin.

18.10.2022 Reklam metrikleri eklendi.

  • advertiserAdClicks Reklam tıklamaları Kullanıcıların mülke erişmek için bir reklamı toplam tıklama sayısı.
  • advertiserAdCost Reklam maliyeti. Reklamlarınız için ödediğiniz toplam tutar.
  • advertiserAdCostPerClick Tıklama başına maliyet. Tıklama başına maliyet, reklam maliyetinin reklam tıklamalarına bölünmesiyle elde edilir ve genellikle TBM olarak kısaltılır.
  • advertiserAdCostPerConversion Dönüşüm başına maliyet. Dönüşüm başına maliyet, reklam maliyetinin dönüşüm sayısına bölünmesiyle hesaplanır.
  • advertiserAdImpressions reklam gösterimi. Toplam gösterim sayısı.
  • returnOnAdSpend Reklam harcamalarından elde edilen gelir. Reklam harcamalarından elde edilen gelir (ROAS), toplam gelirin reklamverenin reklam maliyetine bölünmesiyle elde edilen değerdir.

17.10.2022 Öğe kapsamlı metrikler eklendi.

  • itemsAddedToCart Alışveriş sepetine eklenen öğe sayısı. Tek bir öğe için alışveriş sepetine eklenen birim sayısı.
  • itemsCheckedOut öğenin ödemesi yapıldı. Tek bir öğe için ödemesi yapılan birim sayısı.
  • itemsClickedInList Listede tıklanan ürün sayısı. Tek bir öğe için listede tıklanan birim sayısı.
  • itemsClickedInPromotion Promosyonda tıklanan öğe sayısı. Tek bir öğe için promosyonda tıklanan birim sayısı.
  • itemsViewed öğe görüntülendi. Tek bir öğe için görüntülenen birim sayısı.
  • itemsViewedInList Listede görüntülenen öğe sayısı. Tek bir öğe için listede görüntülenen birim sayısı.
  • itemsViewedInPromotion Promosyonda görüntülenen öğe sayısı. Tek bir öğe için promosyonda görüntülenen birim sayısı.

13.09.2022 Şema uyumluluğu değişiklikleri duyurusu.

1 Aralık 2022'de aşağıdaki zarar veren değişiklikler yapılacak:

  1. itemName gibi öğe kapsamlı boyutlar, eventCount gibi etkinlik kapsamlı metriklerle uyumsuz hale geliyor. Öğe kapsamlı boyutlar, itemRevenue gibi öğe kapsamlı metrikler, activeUsers gibi kullanıcı tabanlı metrikler ve sessions gibi oturum tabanlı metriklerle uyumlu olmaya devam edecektir.

  2. source gibi ilişkilendirme boyutları, eventCount gibi bazı etkinlik kapsamlı metriklerle uyumsuz hale geliyor. İlişkilendirme boyutları, conversions gibi ilişkilendirilebilir metrikler, activeUsers gibi kullanıcı tabanlı metrikler ve sessions gibi oturum tabanlı metriklerle uyumlu olmaya devam edecektir.

  3. pagePathPlusQueryString gibi sorgu dizesini içeren boyutlar yalnızca sınırlı bir boyut ve metrik grubuyla uyumlu olacaktır.

2022-09-01 Kota değişiklikleri.

  • Requests per day , Requests Per Minute, Requests Per Minute Per User kotaları Data API'den kaldırıldı.

  • API'ye Tokens Per Project Per Property Per Hour kotası eklendi.

  • Her istek hem Tokens Per Property Per Hour hem de Tokens Per Project Per Property Per Hour için kota tüketir.

    Yeni kotalarla ilgili ayrıntılı bilgi için Kotalar dokümanlarına bakın.

03.08.2022 Oturum kapsamlı SA360 boyutları eklendi.

  • sessionSa360AdGroupName Oturumla ilişkilendirilen SA360 reklam grubu adı. Bu oturumla sonuçlanan Search Ads 360 reklam grubu adı.

  • sessionSa360CampaignName Oturumla ilişkilendirilen SA360 kampanyası. Bu oturumla sonuçlanan Search Ads 360 kampanyasının adı.

  • sessionSa360CreativeFormat Oturumla ilişkilendirilen SA360 reklam öğesi biçimi. Bu oturuma yol açan reklam öğesinin Search Ads 360'taki türü. Örneğin, "Duyarlı arama ağı reklamı" veya "Genişletilmiş metin reklam".

  • sessionSa360EngineAccountId Oturumla ilişkilendirilen SA360 arama motoru hesabı kimliği. Bu oturumla sonuçlanan SA360'taki arama motoru hesabının kimliği.

  • sessionSa360EngineAccountName Oturumla ilişkilendirilen SA360 arama motoru hesabı adı. Bu oturumla sonuçlanan SA360'taki arama motoru hesabının adı.

  • sessionSa360EngineAccountType Oturumla ilişkilendirilen SA360 arama motoru hesabı türü. Bu oturumla sonuçlanan Search Ads 360'taki arama motoru hesabının türü. Örneğin, "google ads", "bing" veya "baidu".

  • sessionSa360Keyword Oturumla ilişkilendirilen SA360 anahtar kelime metni. Bu oturumla sonuçlanan Search Ads 360'taki arama motoru anahtar kelimesi.

  • sessionSa360Medium Oturumla ilişkilendirilen SA360 aracısı. Bu oturumla sonuçlanan Search Ads 360'taki arama motoru anahtar kelimesi. Örneğin, "tbm".

  • sessionSa360Query Oturumla ilişkilendirilen SA360 sorgusu. Bu oturumla sonuçlanan Search Ads 360 arama sorgusu.

  • sessionSa360Source Oturumla ilişkilendirilen SA360 kaynağı. Bu oturumla sonuçlanan Search Ads 360 trafiğinin kaynağı. Örneğin, "example.com" veya "google".

  • sessionCampaignId, sessionCampaignName boyutları artık Search Ads 360 kampanyalarını destekliyor.

11.07.2022 Dönüşüm oranı metrikleri eklendi.

Dönüşüm oranı

  • sessionConversionRate Dönüşüm etkinliklerinden herhangi birinin tetiklendiği oturumların yüzdesi.

  • userConversionRate Dönüşüm etkinliklerinden herhangi birini tetikleyen kullanıcıların yüzdesi.

Tek Dönüşüm İçin Dönüşüm Oranı Metrikleri

  • sessionConversionRate:event_name Belirli bir dönüşüm etkinliğinin tetiklendiği oturumların yüzdesi.

  • userConversionRate:event_name Belirli bir dönüşüm etkinliğini tetikleyen kullanıcıların yüzdesi.

2022-05-05 Alfa kanalına dönüşüm hunisi raporlama işlevi eklendi.

  • API'nin v1alpha sürümüne runFunnelReport yöntemi eklendi. Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir dönüşüm hunisi raporunu döndürür.

  • Bu yöntem, beta sürüme geçmeden önce söz dizimi ve özelliklerle ilgili geri bildirim toplamak amacıyla alfa kararlılığında kullanıma sunulmuştur. Bu API hakkında geri bildirimde bulunmak için lütfen Google Analytics Data API Dönüşüm Hunisi Raporlama Geri Bildirimi formunu doldurun.

16.02.2022 Yeni boyutlar eklendi.

Manuel terim ve içerik

  • firstUserManualAdContent İlk kullanım kılavuzu reklam içeriği. Kullanıcıyı ilk kez kazandıran reklam içeriği. utm_content parametresi tarafından doldurulur.

  • firstUserManualTerm İlk kullanım kılavuzu terimi. Kullanıcıyı ilk kez kazandıran terim. utm_term parametresi tarafından doldurulur.

  • manualAdContent Manuel reklam içeriği. Dönüşüm etkinliğiyle ilişkilendirilen reklam içeriği. utm_content parametresi tarafından doldurulur.

  • manualTerm Manuel terim. Dönüşüm etkinliğiyle ilişkilendirilen terim. utm_term parametresi tarafından doldurulur.

  • sessionManualAdContent Oturumla ilişkilendirilen manuel reklam içeriği. Oturumla sonuçlanan reklam içeriği. utm_content parametresi tarafından doldurulur.

  • sessionManualTerm Oturumla ilişkilendirilen manuel terim. Oturumla sonuçlanan terim. utm_term parametresi tarafından doldurulur.

Kilitlenme analizi

  • crashAffectedUsers Kilitlenmeden etkilenen kullanıcılar. Raporun bu satırında kilitlenme kaydeden kullanıcı sayısı.

  • crashFreeUsersRate Kilitlenme sorunu yaşamayan kullanıcı oranı.

Uygulama/Web

  • averageSessionDuration Kullanıcı oturumlarının ortalama süresi (saniye cinsinden).

  • newVsReturning Yeni / geri gelen kullanıcılar.

  • screenPageViewsPerSession Oturum başına görüntüleme sayısı.

  • landingPage Açılış sayfası. Bir oturumdaki ilk sayfa görüntülemeyle ilişkilendirilmiş sayfa yolu + sorgu dizesi.

  • platformDeviceCategory Web sitenizin veya mobil uygulamanızın çalıştığı platform ve cihaz türü.

Mobil Uygulama

  • averagePurchaseRevenuePerUser Kullanıcı başına ortalama satın alma geliri.

  • firstTimePurchaserConversionRate İlk kez satın alma işlemi gerçekleştiren etkin kullanıcıların yüzdesi.

  • firstTimePurchasersPerNewUser Yeni kullanıcı başına ilk kez satın alım gerçekleştiren ortalama kullanıcı sayısı.

  • dauPerMau DAU / MAU. Aynı zamanda 1 günlük etkin kullanıcılar olan 30 günlük etkin kullanıcıların hareketli yüzdesi.

  • dauPerWau DAU / WAU. Aynı zamanda 1 günlük etkin kullanıcılar olan 7 günlük etkin kullanıcıların hareketli yüzdesi.

  • wauPerMau WAU / MAU. Aynı zamanda 7 günlük etkin kullanıcılar olan 30 günlük etkin kullanıcıların hareketli yüzdesi.

  • purchaserConversionRate 1 veya daha fazla satın alma işlemi gerçekleştiren etkin kullanıcıların yüzdesi.

  • transactionsPerPurchaser Alıcı başına işlem sayısı.

Google Ads kampanyası

  • firstUserGoogleAdsCampaignType Kullanıcıyı ilk kazandıran Google Ads kampanyasının kampanya türü.

  • googleAdsCampaignType Dönüşüm etkinliğiyle ilişkilendirilen Google Ads kampanyasının kampanya türü.

  • sessionGoogleAdsCampaignType Bu oturumla sonuçlanan Google Ads kampanyasının kampanya türü.

2021-09-07 Yeni tarih/saat boyutları eklendi.

  • dateHourMinute Tarih, saat ve dakika değerlerinin YYYYAAGGSSDD biçiminde birleştirilmiş hali.

  • minute Etkinliğin günlüğe kaydedildiği saatteki iki basamaklı dakika.

  • nthMinute Tarih aralığının başlangıcından itibaren geçen dakika sayısı.

07.09.2021 Etkinlik parametreleriyle doldurulan yeni boyutlar eklendi.

  • achievementId Bir etkinlik için oyundaki başarı kimliği.

  • character Bir etkinlik için oyundaki oyuncu karakteri.

  • fileExtension İndirilen dosyanın uzantısı.

  • fileName İndirilen dosyanın sayfa yolu.

  • groupId Bir etkinlik için oyundaki oyuncu grubu kimliği.

  • linkClasses Giden bir bağlantının HTML sınıfı özelliği.

  • linkDomain Giden bağlantının hedef alanı.

  • linkId Giden bir bağlantının veya indirilen bir dosyanın HTML kimliği özelliği.

  • linkText İndirilen dosyanın bağlantı metni.

  • linkUrl Giden bir bağlantının veya indirilen bir dosyanın tam URL'si.

  • method Etkinliğin tetiklenme yöntemi.

  • outbound Bağlantı, mülkün alanının parçası olmayan bir siteye yönlendiriyorsa "true" değerini döndürür.

  • pageLocation Ziyaret edilen web sayfalarının protokolü, ana makine adı, sayfa yolu ve sorgu dizesi.

  • pageReferrer Ana makine adı ve yol dahil olmak üzere yönlendiren URL'nin tamamı.

  • percentScrolled Kullanıcının sayfayı aşağı kaydırdığı bölümün tüm sayfaya kıyasla yüzdesi (örneğin, "90").

  • searchTerm Kullanıcının aradığı terim.

  • videoProvider Videonun kaynağı (ör. "youtube").

  • videoTitle Videonun başlığı.

  • videoUrl Videonun URL'si.

  • visible İçerik görünürse "true" değerini döndürür.

  • unifiedPagePathScreen Etkinliğin günlüğe kaydedildiği sayfa yolu (web) veya ekran sınıfı (uygulama).

2021-09-07 API şeması değişiklikleri.

Mevcut boyutlardaki değişiklikler:

  • unifiedPageScreen Web'de oluşturulan etkinlikler için bu boyut artık etkinliğin kaydedildiği sayfa yolunu ve sorgu dizesini döndürüyor.

Yapılacak değişikliklerle ilgili duyuru:

  • firstUserTrafficOrigin Kullanıcıyı ilk edinen trafik kaynağı. Lütfen UTM'lerin kullanıldığı trafik için bu alanın "Manual" değerini döndürmesine güvenmeyin. Bu alan, yakında kullanıma sunulacak bir özellik için "Manual" değerini döndürmekten "(not set)" değerini döndürmeye güncellenecektir.

  • sessionTrafficOrigin Oturumun kampanyasının trafik kaynağı. Lütfen UTM'lerin kullanıldığı trafik için bu alanın "Manuel" değerini döndürmesine güvenmeyin. Bu alan, yakında kullanıma sunulacak bir özellik için "Manuel" değerini döndürmekten "(not set)" değerini döndürmeye geçecek.

  • trafficOrigin Dönüşüm etkinliğinin kampanyasının trafik kaynağı. Lütfen UTM'lerin kullanıldığı trafik için bu alanın "Manual" değerini döndürmesine güvenmeyin. Bu alan, yakında kullanıma sunulacak bir özellik için "Manual" değerini döndürmekten "(not set)" değerini döndürmeye güncellenecektir.

2021-09-07: API'ye checkCompatibility yöntemi eklendi.

checkCompatibility yöntemi, bir rapor isteğine eklenebilecek ve uyumluluğu koruyabilecek boyutları ve metrikleri listeler.

21.07.2021 Anlık raporlama değişiklikleri.

Artık minuteRanges parametresini kullanarak okunacak etkinlik verilerinin dakika aralıklarını belirlemek mümkündür. runRealtimeReport yöntemi.

21.07.2021 Yeni kanal gruplaması boyutları.

Veri API'si raporlama şemasına eklenen yeni kanal gruplaması boyutları:

  • firstUserDefaultChannelGrouping İlk kullanıcı varsayılan kanal gruplaması.

  • defaultChannelGrouping Varsayılan kanal gruplaması.

10.06.2021 API şeması değişiklikleri.

  • minutesAgo boyutu, Data API gerçek zamanlı şemasına eklendi ve runRealtimeReport yöntemine yönelik sorgularda kullanılabilir. Bu boyut, bir etkinliğin kaç dakika önce toplandığını içerir. 00, geçerli dakikayı, 01 ise önceki dakikayı ifade eder.

  • googleAdsCreativeId boyutu, Data API şemasına eklendi. Bu boyut, dönüşüm etkinliğiyle ilişkilendirilen Google Ads reklam öğesinin kimliğini içerir.

  • sessionGoogleAdsCreativeId boyutu, Data API şemasına eklendi. Bu boyut, web sitenizde veya uygulamanızda oturumla sonuçlanan Google Ads reklam öğesinin kimliğini içerir.

  • firstUserCreativeId boyutu, Data API şemasında firstUserGoogleAdsCreativeId olarak yeniden adlandırıldı. Bu boyut, kullanıcıyı ilk kazandıran Google Ads reklam öğesinin kimliğini içerir.

2021-04-09 Google Analytics Data API v1 beta sürümü yayınlandı.

  • API uç noktası https://analyticsdata.googleapis.com/v1beta olarak güncellendi.

  • runReport, runPivotReport, batchRunReports, batchRunPivotReports yöntemleri artık istek gövdesinin entity alanı yerine URL yolunun property parametresinde Google Analytics 4 mülkünün kimliğini kabul ediyor:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • API istemci kitaplıkları, yeni API uç noktasını kullanacak şekilde güncellendi.

19.02.2021 Sayfalandırma değişiklikleri.

  • Varsayılan rapor yanıtı boyutu,10 satır etkinlik verisinden 10.000 satır etkinlik verisine yükseltildi.

  • Tüm satırları almaya yönelik bir girişimi belirtmek için kullanılan "limit" : -1 değeri artık RunReportRequest'te desteklenmiyor.

  • limit alanının maksimum değeri 100000 olarak ayarlanır. 100.000'den fazla satır içeren raporları almak için sayfalandırmayı kullanın.

08.02.2021 Yeni e-ticaret boyutları ve metrikleri.

API şemasına yeni e-ticaret boyutları ve metrikleri eklendi:

Boyutlar: adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5 itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

Metrikler: adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

08.02.2021 Yeni kampanya boyutları eklendi.

API şemasına yeni kampanya boyutları eklendi: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

2021-02-08 dayOfWeek, week boyut değişiklikleri.

  • dayOfWeek boyutunun değeri artık 1 yerine 0 ile başlıyor.

  • week boyutunun değeri artık 01 ile başlıyor ve 01 ile 53 arasında iki basamaklı bir sayı döndürüyor. Haftalar Pazar günü başlar. 1 Ocak her zaman 01. haftada yer alır.

28.01.2021 Özel metrikler için toplama varyantları eklendi.

Bir mülkün kaydettiği her özel metrik üç API metrik varyantı oluşturur: toplam, ortalama ve sayı.

2021-01-28 Yeni tarih/saat boyutları eklendi.

API şemasına şu yeni boyutlar eklendi: hour, nthHour, nthYear, dateHour.

28.01.2021 Veri API'si, sorgu başına alınan kota jetonlarını azalttı.

Veri API'si, sorgu başına alınan kota jetonlarını azalttı. Saatlik ve günlük mülk kotası jetonları için kota sınırları değiştirilmedi.

2020-11-09 getUniversalMetadata yöntemi silindi.

getUniversalMetadata yöntemi silindi. Lütfen getMetadata'yı kullanın. API isteği başına bir yıllık maksimum tarih aralığı kaldırıldı.

2020-11-02 Anlık raporlama yöntemi eklendi.

Örnekler için Gerçek Zamanlı Rapor Oluşturma, REST referans dokümanları için ise runRealtimeReport bölümüne bakın.

2020-10-19 İstemci kitaplığı yapıları güncellendi.

Kullanım talimatları ve kod örnekleriyle birlikte istemci kitaplığı yapıları güncellendi.

2020-10-13 Uygulama + Web mülklerinin adı Google Analytics 4 (GA4) olarak değiştirildi.

2020-10-08 getMetadata yöntemi API'ye eklendi.

getMetadata yöntemi, belirtilen GA4 mülk kimliği için kullanılabilen özel boyutları ve metrikleri, ayrıca Universal meta verilerini döndürür.

2020-10-08 Özel boyutlar ve metrikler raporlarda kullanılabilir.

Özel boyutlar ve metriklerle ilgili dokümanlar için API şema belgelerine bakın. Bu güncelleme, etkinlik kapsamlı özel boyutları ve metriklerin yanı sıra kullanıcı kapsamlı özel boyutları da içerir.