Bu belgede, Google Analytics Reporting API v4'ün gelişmiş özellikleri açıklanmaktadır. API ile ilgili ayrıntılı bir referans için Referans Kılavuzu'na bakın.
Giriş
Basit bir rapor oluşturduktan sonra, gelişmiş raporlar oluşturmak için bu özellikleri kullanın:
Elektronik Ritimler
Google Analytics Reporting API v4, Pivot Tablolar oluşturmanıza olanak tanır.
Pivot tabloyla istek oluşturmak için ReportRequest'ta Pivot alanını tanımlayın.
Pivot nesnesinin kendi boyut ve metrik grubu vardır. Pivot tabloya dahil edilecek boyut sayısını belirtmek için isteğe bağlı startGroup ve maxGroupCount özellikleri de mevcuttur.
İstek
Aşağıdaki API çağrısı, ülkeye göre oturum ister ve sonuçları tarayıcıda özetler:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dateRanges":
[
{
"startDate": "2014-11-01",
"endDate": "2014-11-30"
}
],
"metrics":
[
{
"expression": "ga:sessions"
}
],
"dimensions":
[
{
"name": "ga:country"
}
],
"pivots":
[
{
"dimensions":
[
{
"name": "ga:browser"
}
],
"maxGroupCount": 3,
"startGroup": 3,
"metrics":
[
{
"expression": "ga:sessions"
}
]
}
]
}
]
}
Yanıt sütunu başlığı
Bir pivot istek için döndürülen report nesnesinde metricHeader, pivotHeaderEntries alanları pivot boyut değerlerinin sırasını ve ilgili metrik değerlerini tanımlayan pivotHeaders nesnelerinin bir listesini içerir. Örneğin:
"columnHeader": {
"dimensions": [
"ga:country"
],
"metricHeader": {
"metricHeaderEntries": [
{
"name": "ga:sessions",
"type": "INTEGER"
}
],
"pivotHeaders": [
{
"pivotHeaderEntries": [
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Internet Explorer"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Firefox"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Android Browser"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
}
],
"totalPivotGroupsCount": 7
}
]
}
},
Yanıt satırları
reportData nesnesinin her bir satırı, her biri bir dizi pivotValue nesnesi içeren bir dateRangeValue nesnesi dizisini tanımlar. Değerlerin sırası, yanıt sütunu başlığındaki pivot başlıklarında listelenen metriklerin sırasına karşılık gelir.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
Orijinal istekte maxGroupCount değeri 3 olduğu için raporda yalnızca üç pivot değer olduğunu unutmayın. "totalPivotGroupsCount": 7 nedeniyle
en fazla yedi değer olabilir.
Pivot tablo satırı örneği
Yukarıdaki örnek yanıtta, Amerika Birleşik Devletleri ülkesiyle ilişkilendirilen satır aşağıdaki pivot tabloda temsil edilir:
| Country (Ülke) | Toplam Oturum |
Internet Explorer Oturumları |
FireFox Oturumları |
Android Tarayıcı Oturum |
|---|---|---|---|---|
| Hindistan | 12 | 3 | 2 | 4 |
| ABD | 192 | 21 | 18 | 1 |
| Birleşik Krallık | 35 | 12 | 2 | 0 |
Kohortlar
Kohort, ortak bir özelliği paylaşan kullanıcı grubudur. Örneğin, Edinme Tarihi aynı olan tüm kullanıcılar aynı kohorta dahildir. Kohort Analizi raporu, kohort davranışını izole edip analiz etmenize olanak tanır. Kohorta özel boyut ve metriklerin listesi için Kohort ve yaşam boyu değer (YBD) boyutlarını ve metriklerini inceleyin.
Kohort isteği tanımlamak için name, type ve dateRange ile bir kohort nesnesi tanımlamanız gerekir:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthDay"
}
],
"metrics":
[
{
"expression": "ga:cohortActiveUsers"
},
{
"expression": "ga:cohortTotalUsers"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-08-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-07-01"
}
}
]
}
}
]
}
Yukarıdaki API Explorer örneğine bakın.
Kohort kısıtlamaları
Geçerli bir grup isteği aşağıdaki kısıtlamaları karşılamalıdır:
ga:cohortboyutu, yalnızca isteğin bir veya daha fazla kohort tanımı olması durumunda dahil edilir.- Grup adı benzersiz olmalıdır.
- Bir istekte maksimum kohort sayısı 12'dir.
ga:cohortNthWeektanımlıysa başlangıç tarihi Pazar ve bitiş tarihi Cumartesi olmalıdır.ga:cohortNthMonthtanımlanmışsa başlangıç tarihi ayın ilk günü, bitiş tarihi de ayın son günü olmalıdır.ga:cohortNthDaytanımlıysa tarih aralığı tam olarak bir gün olmalıdır.- Bugünün tarihine ait kohort isteklerine izin verilmez.
- Kohort ve kohort olmayan istekler aynı
batchGetisteğinde olmamalıdır. - Kohortlardaki tarih aralığı 1 Şubat 2015'ten sonra olmalıdır.
Yaşam boyu değer (YBD)
Yaşam Boyu Değer raporu, kullanıcı edinildikten sonraki 90 gün boyunca kullanıcı değerinin (Gelir) ve etkileşimin (Uygulama Görüntülemeleri, Hedef Tamamlamalar, Oturumlar ve Oturum Süresi) nasıl büyüdüğünü gösterir. YBD'ye özel boyut ve metrikleri inceleyin.
YBD isteği, lifetimeValue alanının true olarak ayarlandığı bir kohort olarak tanımlanır. Örneğin:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthWeek"
}
],
"metrics":
[
{
"expression": "ga:cohortTotalUsersWithLifetimeCriteria"
},
{
"expression": "ga:cohortRevenuePerUser"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-09-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-08-01"
}
}
],
"lifetimeValue": true
}
}
]
}
API Explorer'da yukarıdaki örneğe bakın.
Kohort ve yaşam boyu değer (YBD) boyutları ve metrikleri
Boyutlar
| Boyut Adı | Tanım |
|---|---|
ga:cohort |
Kullanıcının ait olduğu kohortun adı. Kohortların tanımına bağlı olarak, bir kullanıcının birden fazla kohorta ait olabileceği gibi bu kohort da kullanıcının birden fazla kohorta dahil olabilir. |
ga:cohortNthDay |
Kohort tanımı tarihine göre 0 tabanlı gün göreli konumu. Örneğin bir kohort ilk ziyaret tarihi 2015-09-01 olarak tanımlanırsa 2015-09-04 tarihi için ga:cohortNthDay 3 olur. |
ga:cohortNthMonth |
Kohort tanımı tarihine göre 0 tabanlı ay ofseti. |
ga:cohortNthWeek |
Kohort tanımı tarihine göre 0 tabanlı haftalık göreli konum. |
ga:acquisitionTrafficChannel |
Kullanıcının edinildiği trafik kanalı. Kullanıcının ilk oturumundan elde edilir. Trafik kanalı, kullanıcı edinme sırasında varsayılan kanal gruplaması kurallarına (varsa görünüm düzeyinde) göre hesaplanır. |
ga:acquisitionSource |
Kullanıcının edinildiği kaynak. Kullanıcının ilk oturumundan türetildi. |
ga:acquisitionMedium |
Kullanıcının edinildiği aracı. Kullanıcının ilk oturumundan türetildi. |
ga:acquisitionSourceMedium |
ga:userAcquisitionSource ve ga:acquisitionMedium değerlerinin toplamı. |
ga:acquisitionCampaign |
Kullanıcının edinildiği kampanya. Kullanıcının ilk oturumundan türetildi. |
Metrikler
| Metrik Adı | Tanım |
|---|---|
ga:cohortActiveUsers |
Bu metrik, 0 tabanlı göreli boyutlar (ga:cohortNthDay, ga:cohortNthWeek veya ga:cohortNthMonth) bağlamında alakalıdır. Grupta 9. gün/hafta/ay için karşılık gelen zaman aralığında etkin olan kullanıcıların sayısını gösterir. Örneğin, ga:cohortNthWeek = 1 için ikinci haftada etkin olan kullanıcıların (grupta) sayısı. Bir istek ga:cohortNthDay, ga:cohortNthWeek veya ga:cohortNthMonth özelliklerinden birini içermiyorsa bu metrik ga:cohortTotalUsers ile aynı değere sahip olur. |
ga:cohortTotalUsers |
Gruba ait kullanıcıların sayısı (kohort boyutu olarak da bilinir). |
ga:cohortAppviewsPerUser |
Bir kohort için kullanıcı başına uygulama görüntüleme sayısı. |
ga:cohortGoalCompletionsPerUser |
Bir grup için kullanıcı başına hedef tamamlama sayısı. |
ga:cohortPageviewsPerUser |
Bir kohort için kullanıcı başına sayfa görüntüleme sayısı. |
ga:cohortRetentionRate |
Kohort saklama oranı. |
ga:cohortRevenuePerUser |
Bir kohort için kullanıcı başına gelir. |
ga:cohortVisitDurationPerUser |
Bir kohort için kullanıcı başına oturum süresidir. |
ga:cohortSessionsPerUser |
Bir grup için kullanıcı başına oturum sayısı. |
Yaşam boyu değer (YBD) metrikleri
| Metrik Adı | Tanım |
|---|---|
ga:cohortTotalUsersWithLifetimeCriteria |
Bu, ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium veya ga:acquisitionCampaign boyutlarına sahip bir istek bağlamında alakalıdır. Kohortlarda mevcut kanal, kaynak, aracı veya kampanya üzerinden edinilen kullanıcıların sayısını temsil eder. Örneğin, ga:acquisitionTrafficChannel=Direct için, kohortta doğrudan edinilen kullanıcıların sayısını belirtir. Belirtilen boyutların hiçbiri mevcut değilse değeri ga:cohortTotalUsers olur (yalnızca uygulama görüntülemeleri). |
ga:cohortAppviewsPerUserWithLifetimeCriteria |
Bir kohortun edinme boyutu için kullanıcı başına uygulama görüntüleme sayısı (yalnızca uygulama görüntülemeleri). |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria |
Bir grubun edinme boyutu için kullanıcı başına hedef tamamlama sayısı (yalnızca uygulama görüntüleme sayısı). |
ga:cohortPageviewsPerUserWithLifetimeCriteria |
Bir kohortun edinme boyutu için kullanıcı başına sayfa görüntüleme sayısı (yalnızca uygulama görüntülemeleri). |
ga:cohortRevenuePerUserWithLifetimeCriteria |
Bir grubun edinme boyutu için kullanıcı başına gelir (yalnızca uygulama görüntülemeleri). |
ga:cohortSessionsPerUserWithLifetimeCriteria |
Bir grubun edinme boyutu için kullanıcı başına oturum süresi (yalnızca uygulama görüntülemeleri). |