Değişiklik günlüğü

Resmi Google Analytics API duyuruları için Google Analytics API Bildirim Grubu'na abone olun.

2026-09-14 v1 alfa sürümüne etkileşimli sorgu desteği eklendi.

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

14.09.2026 Rapor yanıtlarına veri kesme nedenleri eklendi.

v1 beta ve v1 alfa sürümlerinde ResponseMetaData öğesine dataTruncationReasons alanı eklendi. Bir raporun verileri kesildiğinde bu alan, kesme türünü, açıklayıcı bir mesajı ve etkilenen tarihleri içeren DataTruncationReason nesnelerinin bir listesini içerir.

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

Data API v1 alfa sürümündeki runReport yöntemi kullanılarak Dönüşüm performansı raporundan 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 dönüşüm verilerine erişebilirsiniz.

  • RunReportRequest hizmetine ConversionSpec alanı eklendi. Bu alan, conversionActions (dönüşüm işlemi kimlikleri) kullanarak dönüşümleri filtrelemenize ve bir AttributionModel (DATA_DRIVEN veya LAST_CLICK) seçmenize olanak tanır.
  • Rapordaki verilerin standart raporlamadan (SECTION_REPORT) mı yoksa dönüşüm raporlamadan (SECTION_ADVERTISING) mı olduğunu belirlemek için ResponseMetaData'na Section alanı eklendi.

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

  • Yanıta, dönüşüm işlemi kimliklerini görünen adlarla eşleyen ConversionMetadata nesnelerinin listesini döndüren conversions alanı eklendi.
  • Belirli bir alanın standart raporlama, dönüşüm raporlama veya her ikisiyle uyumlu olup olmadığını belirlemek için DimensionMetadata ve MetricMetadata alanlarına 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ülklerinin 1 milyar etkinliklik daha yüksek örnekleme sınırlarına erişmesini sağlar. Ayrıca, örneklenmemiş sonuçlarda yüksek etkinlik sayısı için örnekleme sınırları UNSAMPLED olarak ayarlanabilir.

18.09.2024 Mülk kotalarının anlık görüntüsü ö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 güncel bir anlık görüntüsünü alabilirsiniz.

28.06.2024 "Proje ve mülk başına istemci hataları" kotası eklendi.

Artık 15 dakikalık bir zaman aralığında proje ve mülk başına en fazla 10.000 API sunucu hatasına izin verilir. 500 veya 200 dışında bir kodla yanıt veren tüm istekler buna dahildir. Bu kotaya 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 ilgili Google Cloud projesi için söz konusu mülke yönelik diğer API çağrıları, 15 dakikalık süre sona erene kadar geçici olarak engellenir.

2024-05-14 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, dahil edildiğinde istenen karşılaştırmaların yapılandırmasını belirten comparisons alanını destekleyecek şekilde güncellendi.

Bir istekte, istekle birlikte dimensionFilter ifadesini sağlayarak temel bir karşılaştırma belirtebilir veya comparison alanında karşılaştırmanın kaynak adını sağlayarak kayıtlı 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 kaydedilen karşılaştırmalar yalnızca Google Analytics kullanıcı arayüzü kullanılarak oluşturulabilir.

2024-05-08 Eşzamansız bir raporlama özelliği olan rapor görevleri, Data API v1alpha'ya eklendi.

Rapor görevlerini kullanarak Google Analytics etkinlik verilerinizin özelleştirilmiş bir raporunu oluşturmak için uzun süreli bir asenkron istek başlatabilirsiniz.

Data API v1alpha'ya aşağıdaki rapor görevi işleme yöntemleri eklenmiştir:

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 Metrik kullanan tüm rapor isteklerini, Önemli Etkinlik Metriği'ni 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 etkinlik için önemli etkinlik metriklerinin kullanımında benzer değişiklikler yapın.

properties/getMetadata yönteminin yanıtı, DimensionMetadata ve MetricMetadata nesnelerinde önemli etkinlik boyutlarının ve metriklerinin tanıtımını aşağıdaki gibi yansıtır:

  • apiName, uiName ve description, önemli etkinlik API 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 özel boyutlar eklendi.

Data API ş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 Kullanıcıyla manuel olarak ilk ilişkilendirilen reklam öğesi biçimi

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

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

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

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

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

  • sessionManualCampaignId Oturumla ilişkilendirilen manuel kampanya kimliği

  • sessionManualCampaignName Oturumla ilişkilendirilen manuel kampanya adı

  • sessionManualCreativeFormat Oturumla ilişkilendirilen manuel reklam öğesi biçimi

  • sessionManualMarketingTactic Oturum kılavuzu pazarlama taktiği

  • sessionManualMedium Oturumla ilişkilendirilen manuel aracı

  • sessionManualSource Oturumla ilişkilendirilen manuel kaynak

  • sessionManualSourceMedium Oturumla ilişkilendirilen manuel kaynak/aracı

  • sessionManualSourcePlatform Oturumla ilişkilendirilen manuel kaynak platform

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 kampanya 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 kampanya 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ıyla ilişkilendirilen 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) entegrasyon 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ıyla ilişkilendirilen SA360 arama motoru hesabı türü

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

  • firstUserSa360ManagerAccountId İlk kullanıcıyla ilişkilendirilen 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ıyla ilişkilendirilen SA360 sorgusu

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

  • firstUserSa360SourceMedium İlk kullanıcıyla ilişkilendirilen 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ı kitlelerini dışa aktarmayı daha iyi destekler. Kullanıcılar bu kitlelere uygunluk koşulu olan bir etkinlik olmadan girer. Örneğin, kullanıcı yedi gün boyunca web sitenizi 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.

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

Kitle dışa aktarma işlemleri, mülkünüz için kullanıcı tarafından sağlanan veriler etkinleştirilmiş olsa bile artık etiketlemede belirtilen kullanıcı kimliğini döndürür. Kullanıcı tarafından sağlanan verilerin toplanması etkinleştirilirse ölçümü iyileştirmek için etiketleme sırasında 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ılabilir olduğunda eşzamansız olarak Webhook bildirimleri almanızı sağlar.

18.01.2024 Sorgu dizesi veya dakika bileşeni 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 uyumludur.

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

Kapsamlı uyumluluk bilgileri için GA4 Boyut ve Metrik Gezgini'ni inceleyin.

13.12.2023 Öğe kapsamlı özel parametreler

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

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üne bakın.

05.12.2023 Kitle listeleri, Data API v1 beta sürümünde kitle dışa aktarma olarak kullanılabilir.

Kitle Listeleri özelliğinin adı Kitle Dışa Aktarmaları olarak değiştirildi 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, ResponseMetaData listesine eklendi. Bu koleksiyon, istekte sonuçların örnek olarak alındığı her tarih aralığı için bir SampleMetadata içerir. Google Analytics, yalnızca kardinalite sınırlarının veri kalitesini düşüreceğini tahmin ettiğinde örnekleme uygular.

28.11.2023 Data API 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 güncel kitle üyeliği sonuçlarıyla çalışmanızı sağlar.

13.10.2023 Üyelik süresi 1 gün olan kitleler için destek eklendi.

Üyelik süreleri 1 gün olan kitleler artık Kitle Listelerini dışa aktarma işlevi tarafından desteklenmektedir.

12.09.2023 AudienceList varsayılan sıralama kuralları

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

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 alacaksı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: true, false ve (not set).

    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 veriliyor. 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, false değerini döndürür.

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

2023-07-10 Kitle Listeleri

Data API v1 alfa sürümüne Kitle Listeleri desteği eklendi. Kitle listeleri, kitle listesi oluşturulduğu sırada kitledeki kullanıcıların anlık görüntüsünü içerir.

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

19.05.2023 Özel kanal grupları

Data API'ye özel kanal grupları desteği eklendi.

11.05.2023 Jeton kotası değişiklikleri.

Data API'nin kota sistemi, daha hassas ücretlendirmelere olanak tanıyacak şekilde güncellendi.

Her istek için ücretlendirilen jeton sayısı, kota değişikliğine uygun şekilde güncellendi ve daha fazla sayıda basit raporlama sorgusuna izin verecek şekilde yeniden dengelendi. Bununla birlikte, büyük tarih raporları için önemli ölçüde daha fazla kota jetonu ücretlendirilir.

Bu değişiklikten sonra bazı isteklerin ücreti aynı kalacak olsa da daha karmaşık sorguların ücretlerinde belirgin bir artış olacak. Örneğin, 6 aydan uzun bir süreye ait veriler için yapılan istekler 1.000 veya daha fazla kota jetonu tüketebilir.

Standart mülkler

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 Temel Jeton Sayısı 5.000 40.000
Proje Başına Mülk Başına Saatlik Temel 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 Jetonu Sayısı 25.000 200.000
Mülk Başına Saatlik Dönüşüm Hunisi Jetonu Sayısı 5.000 40.000
Proje Başına Mülk Başına Saatlik Dönüşüm Hunisi Jetonu 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 Temel Jeton Sayısı 50.000 400.000
Proje Başına Mülk Başına Saatlik Temel 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 Jetonu Sayısı 250.000 2.000.000
Mülk Başına Saatlik Dönüşüm Hunisi Jetonu Sayısı 50.000 400.000
Proje Başına Mülk Başına Saatlik Dönüşüm Hunisi Jetonu 17.500 140.000

2023-03-02 Tarih boyutları eklendi.

  • dayOfWeekName Haftanın günü adı. Haftanın günü (İngilizce). Bu boyutun Sunday, Monday gibi değerleri vardır.

  • isoWeek Yılın ISO 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 bulunur.

  • 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 bulunur.

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

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

  • yearWeek Yıl hafta. year ve week değerlerinin birleşimi. Örnek değerler arasında 202253 veya 202301 bulunur.

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ğinin kullanılması önerilir. Özel bir yer kodu da kullanılabilir. Bu alan, etiketleme sırasında 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 ve 14 Mayıs 2023'te sorgu dizesi döndürmeyecek şekilde güncellenecek olan landingPage boyutunun yerini alır.

2023-01-28 "Kullanıcı başına görüntüleme sayısı" ve "Kaydıran kullanıcı sayısı" 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" ve "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, kullanıcının IP adresinden türetilen coğrafi kimliği.

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.

2022-10-18 Reklam metrikleri eklendi.

  • advertiserAdClicks reklam tıklaması. 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 hesaplanır 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 hesaplanır.

17.10.2022 Öğe kapsamlı metrikler eklendi.

  • itemsAddedToCart ürün alışveriş sepetine eklendi. Tek bir öğe için alışveriş sepetine eklenen birim sayısı.
  • itemsCheckedOut öğe ödünç alındı. Tek bir öğe için ödemesi yapılan birim sayısı.
  • itemsClickedInList Listede tıklanan öğe 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 ürün sayısı. Tek bir öğe için promosyonda görüntülenen birim sayısı.

2022-09-13 Ş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ı metriklerle, activeUsers gibi kullanıcı tabanlı metriklerle ve sessions gibi oturum tabanlı metriklerle uyumlu olmaya devam edecek.

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

  3. pagePathPlusQueryString gibi sorgu dizesini içeren boyutlar yalnızca sınırlı sayıda boyut ve metrikle uyumlu olur.

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

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

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

    Yeni kotalar hakkında ayrıntılı bilgi için Kotalar dokümanlarını inceleyin.

2022-08-03 Oturum kapsamlı SA360 boyutları eklendi.

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

  • sessionSa360CampaignName Oturumla ilgili SA360 kampanyası Search Ads 360'ta bu oturumla sonuçlanan kampanyanın adı.

  • sessionSa360CreativeFormat Oturumla ilgili SA360 reklam öğesi biçimi. Search Ads 360'ta bu oturumla sonuçlanan reklam öğesinin 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ı. SA360'ta bu oturumla sonuçlanan arama motoru hesabının adı.

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

  • sessionSa360Keyword Oturumla ilgili SA360 anahtar kelime metni. Search Ads 360'tan bu oturuma yönlendiren arama motoru anahtar kelimesi.

  • sessionSa360Medium Oturumla ilişkilendirilen SA360 aracısı Search Ads 360'tan bu oturuma yönlendiren arama motoru anahtar kelimesi. Örneğin, "cpc".

  • sessionSa360Query Oturumla ilgili SA360 sorgusu Search Ads 360'tan bu oturumla sonuçlanan 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.

2022-07-11 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 Bir 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.

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 edinen 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. Bir oturumla sonuçlanan reklam içeriği. utm_content parametresi tarafından doldurulur.

  • sessionManualTerm Oturum manuel terimi. 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ıların oranı.

Uygulama/Web

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

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

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

  • 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 Her 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 GEKS / HEKS. 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 En az 1 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 birleştirilmiş hali. YYYYAAGGSSDD biçiminde gösterilir.

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

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

07.09.2021 Etkinlik parametreleri tarafından 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 Bir etkinliğin tetiklenme yöntemi.

  • outbound Bağlantı, mülkün alanının dışındaki bir siteye yönlendirme yapıyorsa "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 tam yönlendiren URL.

  • percentScrolled Sayfanın kullanıcı tarafından aşağı kaydırılan bölümünün tüm sayfaya kıyasla yüzdesi (ör. "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ür durumdaysa "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 günlüğe kaydedildiği sayfa yolunu ve sorgu dizesini döndürür.

Yaklaşan değişikliklerle ilgili duyuru:

  • firstUserTrafficOrigin Kullanıcıyı ilk edinen trafik kaynağı. UTM'leri kullanan trafik için bu alanın "Manuel" değerini döndürmesine güvenmeyin. Yakında kullanıma sunulacak bir özellik için bu alan, "Manuel" yerine "(not set)" değerini döndürecek şekilde güncellenecek.

  • sessionTrafficOrigin Oturum kampanyasının trafik kaynağı. UTM'leri kullanan trafik için bu alanın "Manuel" değerini döndürmesine güvenmeyin. Yakında kullanıma sunulacak bir özellik için bu alan, "Manuel" yerine "(not set)" değerini döndürecek şekilde güncellenecek.

  • trafficOrigin Dönüşüm etkinliği kampanyasının trafik kaynağı. UTM'leri kullanan trafik için bu alanın "Manuel" değerini döndürmesine güvenmeyin. Yakında kullanıma sunulacak bir özellik için bu alan, "Manuel" yerine "(not set)" değerini döndürecek şekilde güncellenecek.

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 Gerçek zamanlı raporlama değişiklikleri.

Artık runRealtimeReport yönteminin minuteRanges parametresini kullanarak okunacak etkinlik verilerinin dakika aralıklarını belirtebilirsiniz.

21.07.2021 Yeni kanal gruplaması boyutları.

Data API raporlama şemasına yeni kanal gruplaması boyutları eklendi:

  • 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ı gösterir.

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

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

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

09.04.2021 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 bir 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.

2021-02-19 Sayfalandırma değişiklikleri.

  • Varsayılan rapor yanıtı boyutu,10 satır etkinlik verisinden 10.000 satıra çıkarıldı.

  • Tüm satırları alma girişimini 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.

2021-02-08 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.

2021-02-08 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şlar ve 01 ile 53 arasında iki basamaklı bir sayı döndürür. Haftalar pazar günü başlar. 1 Ocak her zaman 01. haftadadı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ı.

28.01.2021 Yeni tarih/saat boyutları eklendi.

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

28.01.2021 Data API, sorgu başına ücretlendirilen kota jetonlarını azalttı.

Data API, sorgu başına ücretlendirilen 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. getMetadata'yı kullanın. API isteği başına bir yıllık maksimum tarih aralığı kaldırıldı.

2020-11-02 Gerçek Zamanlı Raporlama Yöntemi eklendi.

Örnekler için Gerçek Zamanlı Rapor Oluşturma, REST referans dokümanları için runRealtimeReport sayfasına bakın.

19.10.2020 İstemci kitaplığı yapıları güncellendi.

İstemci kitaplığı yapıları, kullanım talimatları ve kod örnekleriyle birlikte güncellendi.

13.10.2020 Uygulama + Web mülkleri, Google Analytics 4 (GA4) olarak yeniden adlandırıldı.

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 evrensel meta verileri döndürür.

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

Özel boyutlar ve metriklerle ilgili belgeler 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.