Bu dokümanda, Google Analytics Raporlama API'si v4'ün gelişmiş özellikleri açıklanmaktadır. API'ye ilişkin ayrıntılı referans için Reference Guide (Referans Kılavuzu) dokümanına göz atın.
Giriş
Basit bir rapor oluşturduktan sonra, gelişmiş raporlar oluşturmak için şu özellikleri kullanın:
Pivotlar
Google Analytics Reporting API v4, Pivot Tablolar oluşturmanıza olanak tanır.
Pivot tabloyla bir istek oluşturmak için ReportRequest'teki Pivot alanını tanımlayın.
Pivot nesnesinin kendi boyut ve metrikleri vardır. Ayrıca, pivot tabloya dahil edilecek boyutların sayısını belirtmek için isteğe bağlı startGroup
ve maxGroupCount
değerleri bulunur.
İstek
Aşağıdaki API çağrısı, oturumları ülkeye göre ister ve tarayıcıdaki sonuçları ö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 isteği için döndürülen report nesnesinde metricHeader
öğesinin, pivotHeaderEntries
alanları pivot boyut değerlerinin sıralamasını ve karşılık gelen metrik değerlerini tanımlayan bir pivotHeaders nesne listesi bulunur. Ö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 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
3 olduğu için raporda yalnızca üç pivot değer olduğuna dikkat edin. "totalPivotGroupsCount": 7
nedeniyle yediye kadar değer olabilir.
Pivot tablo satırı örneği
Yukarıdaki örnek yanıtta, United States ülkesiyle ilişkili satır aşağıdaki pivot tabloda temsil edilmektedir:
Ülke | Toplam Oturum |
Internet Explorer Oturumları |
FireFox Oturumları |
Android Tarayıcı Oturumları |
---|---|---|---|---|
Hindistan | 12 | 3 | 2 | 4 |
ABD | 192 | 21 | 18 | 1 |
Birleşik Krallık | Tayland bahtı | 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 özgü boyut ve metriklerin listesi için Grup ve yaşam boyu değer (YBD) boyutları ve metrikleri bölümüne bakın.
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"
}
}
]
}
}
]
}
API Explorer'da yukarıdaki örneğe bakın.
Kohort kısıtlamaları
Geçerli bir grup isteği aşağıdaki kısıtlamaları karşılamalıdır:
ga:cohort
boyutu, yalnızca istekte bir veya daha fazla kohort tanımı varsa dahil edilir.- Grup adı benzersiz olmalıdır.
- Bir istekteki maksimum kohort sayısı 12'dir.
ga:cohortNthWeek
tanımlanırsa başlangıç tarihi Pazar, bitiş tarihi ise Cumartesi olmalıdır.ga:cohortNthMonth
tanımlanırsa başlangıç tarihi ayın ilk günü ve bitiş tarihi ayın son günü olmalıdır.ga:cohortNthDay
tanımlıysa tarih aralığı tam olarak bir gün olmalıdır.- Bugün tarihli kohort isteklerine izin verilmiyor.
- Kohort ve grup olmayan istekler aynı
batchGet
isteğ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, bir kullanıcı edinildikten sonraki 90 gün boyunca kullanıcı değerinin (Gelir) ve etkileşiminin (Uygulama Görüntülemeleri, Hedef Tamamlamalar, Oturumlar ve Oturum Süresi) nasıl büyüdüğünü gösterir. YBD'ye özel boyutları ve metrikleri inceleyin.
YBD isteği, lifetimeValue
alanı true
olarak ayarlanmış 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.
Grup ve yaşam boyu değer (YBD) boyutları ve metrikleri
Boyutlar
Boyut Adı | Tanım |
---|---|
ga:cohort |
Kullanıcının ait olduğu grubun adı. Kohortların tanımlanma şekline bağlı olarak, bir kullanıcının birden çok segmente ait olabilmesine benzer şekilde, bir kullanıcı birden çok kohorta ait olabilir. |
ga:cohortNthDay |
Kohort tanım tarihine göre 0 tabanlı gün ofseti. Örneğin, bir kohort ilk ziyaret tarihi 2015-09-01 olarak tanımlanmışsa 2015-09-04 tarihi için ga:cohortNthDay 3 olur. |
ga:cohortNthMonth |
Grup tanımı tarihine göre 0 tabanlı ay ofseti. |
ga:cohortNthWeek |
Kohort tanım tarihine göre 0 tabanlı hafta ofseti. |
ga:acquisitionTrafficChannel |
Kullanıcının kazanıldığı trafik kanalı. Kullanıcının ilk oturumundan çıkarılır. Trafik kanalı, kullanıcı edinme sırasındaki 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üretilmiştir. |
ga:acquisitionMedium |
Kullanıcının kazanıldığı aracı. Kullanıcının ilk oturumundan türetilmiştir. |
ga:acquisitionSourceMedium |
ga:userAcquisitionSource ve ga:acquisitionMedium değerlerinin birleşik değeri. |
ga:acquisitionCampaign |
Kullanıcıyı kazandıran kampanya. Kullanıcının ilk oturumundan türetilmiştir. |
Metrikler
Metrik Adı | Tanım |
---|---|
ga:cohortActiveUsers |
Bu metrik, 0 tabanlı ofset boyutları (ga:cohortNthDay , ga:cohortNthWeek veya ga:cohortNthMonth ) bağlamında geçerlidir. Kohortta n. gün/hafta/ayda etkin olan zaman aralığında etkin olan kullanıcıların sayısını gösterir. Örneğin, ga:cohortNthWeek = 1 için ikinci hafta etkin olan kullanıcıların (gruptaki) sayısı. İstekte ga:cohortNthDay , ga:cohortNthWeek veya ga:cohortNthMonth değerleri yoksa bu metrik, ga:cohortTotalUsers ile aynı değere sahip olur. |
ga:cohortTotalUsers |
Gruba ait kullanıcı sayısı. Kohort boyutu olarak da bilinir. |
ga:cohortAppviewsPerUser |
Bir grup 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 grup için kullanıcı başına sayfa görüntüleme sayısı. |
ga:cohortRetentionRate |
Kohort elde tutma oranı. |
ga:cohortRevenuePerUser |
Bir grubun kullanıcı başına geliridir. |
ga:cohortVisitDurationPerUser |
Bir grup 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 geçerlidir. Mevcut kanal, kaynak, aracı veya kampanya yoluyla edinilen gruplardaki kullanıcı sayısını temsil eder. Örneğin ga:acquisitionTrafficChannel=Direct için bu değer, gruptaki doğrudan edinilen kullanıcıların sayısını temsil eder. Belirtilen boyutların hiçbiri yoksa değeri ga:cohortTotalUsers değerine eşit olur (yalnızca uygulama görüntülemeleri). |
ga:cohortAppviewsPerUserWithLifetimeCriteria |
Bir grubun 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ülemeleri). |
ga:cohortPageviewsPerUserWithLifetimeCriteria |
Bir grubun 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). |