Analytics Data API'nin Realtime yöntemi için sorgularda desteklenen boyutlar ve metrikler. Temel raporlama yöntemleri (örneğin, RunReport), Gerçek Zamanlı yönteminden farklı bir boyut ve metrik grubu kabul eder.
Boyutlar
Aşağıdaki boyutlar, herhangi bir mülkle ilgili raporlarda istenebilir. Rapor yanıtındaki boyut sütunu için Dimension kaynağının name alanında "API Adı"nı belirtin.
| API adı | Kullanıcı arayüzü adı | Açıklama |
|---|---|---|
appVersion |
Uygulama sürümü | Uygulamaya ait versionName (Android) veya kısa paket sürümü (iOS). |
audienceId |
Hedef kitle kimliği | Bir kitlenin sayısal tanımlayıcısı. Kullanıcılar, raporun tarih aralığında ait oldukları kitlelerde raporlanır. Mevcut kullanıcı davranışı, kullanıcıların eski raporlarda hangi kitle listelerinin üyesi olduğunu etkilemez. |
audienceName |
Kitle adı | Bir kitlenin verilen adı. Kullanıcılar, raporun tarih aralığında ait oldukları kitlelerde raporlanır. Mevcut kullanıcı davranışı, kullanıcıların eski raporlarda hangi kitle listelerinin üyesi olduğunu etkilemez. |
audienceResourceName |
Kitle kaynak adı | Bu kitlenin kaynak adı. Kaynak adları, bir kaynağı benzersiz şekilde tanımlamak için hem koleksiyon hem de kaynak tanımlayıcıları içerir. Daha fazla bilgi için Kaynak adları bölümünü inceleyin. |
city |
Şehir | Kullanıcı etkinliğinin gerçekleştiği şehir. |
cityId |
Şehir kimliği | Kullanıcı etkinliğinin gerçekleştiği şehrin coğrafi kimliği (IP adresinden türetilir). |
country |
Ülke | Kullanıcı etkinliğinin gerçekleştiği ülke. |
countryId |
Ülke kimliği | Kullanıcı etkinliğinin gerçekleştiği ülkenin coğrafi kimliği. Kullanıcının IP adresinden elde edilir. ISO 3166-1 alfa-2 standardına göre biçimlendirilmiş olmalıdır. |
deviceCategory |
Cihaz kategorisi | Cihaz türü: Masaüstü, Tablet veya Mobil |
eventName |
Etkinlik adı | Etkinliğin adı. |
minutesAgo |
Gerçek zamanlı dakika önce | Bir etkinliğin kaç dakika önce toplandığı. 00, geçerli dakikayı, 01 ise önceki dakikayı ifade eder. |
platform |
Platform | Uygulamanızın veya web sitenizin yayınlandığı platform (ör. web, iOS veya Android). Bir raporda akışın türünü belirlemek için hem platformu hem de streamId'yi kullanın. |
streamId |
Akış Kimliği | Uygulamanız veya web siteniz için sayısal veri akışı tanımlayıcısı. |
streamName |
Akış adı | Uygulamanızın veya web sitenizin veri akışı adı. |
unifiedScreenName |
Sayfa başlığı ve ekran adı | Etkinliğin kaydedildiği sayfa başlığı (web) veya ekran adı (uygulama). |
Özel boyutlar
Anlık Veri API'si, kullanıcı kapsamlı özel boyutlar hakkında rapor oluşturabilir. Özel boyutlar hakkında daha fazla bilgi edinmek için Özel kullanıcı özellikleri başlıklı makaleyi inceleyin. Özel boyutlar, API raporu isteğinde boyutun parametre adı ve kapsamıyla belirtilir. Örneğin, parametre adı "last_level" olan kullanıcı kapsamlı özel boyut için bir rapor oluşturmak üzere Data API isteğine "customUser:last_level" ekleyin. Mülk, bu kullanıcı kapsamlı özel boyutu kaydetmediyse bu API isteği başarısız olur.
Aşağıda, özel boyutların genel söz dizimi verilmiştir. Bir mülkle ilgili tüm özel boyutları listelemek için Metadata API yöntemini sorgulayabilirsiniz.
| Genel API Adı | Açıklama |
|---|---|
customUser:parameter_name |
parameter_name için kullanıcı kapsamlı özel boyut. |
Etkinlik kapsamlı özel boyutlar, Realtime API'de desteklenmez.
Metrikler
Aşağıdaki metrikler, herhangi bir mülkle ilgili raporlarda istenebilir. Rapor yanıtındaki metrik sütunu için Metric kaynağının name alanında "API Adı"nı belirtin.
| API adı | Kullanıcı arayüzü adı | Açıklama |
|---|---|---|
activeUsers |
Etkin kullanıcı sayısı | Sitenizi veya uygulamanızı ziyaret eden farklı kullanıcıların sayısı. |
eventCount |
Etkinlik sayısı | Etkinlik sayısı. |
keyEvents |
Önemli etkinlikler | Önemli etkinliklerin sayısı. Bir etkinliğin önemli etkinlik olarak işaretlenmesi raporları, söz konusu önemli etkinliğin oluşturulmaya başlamasından itibaren etkiler. Bu işlem, geçmiş verileri değiştirmez. Google Analytics'te herhangi bir etkinliği önemli olarak işaretleyebilirsiniz. Bazı etkinlikler (ör. first_open veya purchase) varsayılan olarak önemli etkinlik olarak işaretlenir. |
screenPageViews |
Görüntüleme sayısı | Kullanıcılarınızın 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 etkinliği sayısı). |
Etkinlik kapsamlı özel metrikler, Realtime API'de desteklenmez.