Bu belgede, Google Analytics Data API v1'in bazı gelişmiş özellikleri açıklanmaktadır. API'nin ayrıntılı referansı için API Referansı'na bakın.
Özel tanımları listeleme ve raporlar oluşturma
Data API, kayıtlı Özel Boyutlar ve Özel Metrikler ile ilgili raporlar oluşturabilir. Metadata API Yöntemi, Mülkünüzün kayıtlı Özel Tanımlarının API adlarını listelemek için kullanılabilir. Bu API adları, örneğin Rapor İstekleri'nde runReport yönteminde kullanılabilir.
Aşağıdaki bölümlerde, her bir Özel Tanım türü için örnekler gösterilmektedir. Bu örneklerde, GA4_PROPERTY_ID
değerini Mülk Kimliğinizle değiştirin.
Etkinlik kapsamlı özel boyutlar
1. Adım: Metadata API Yöntemini Mülk Kimliğinizle sorgulayın.
GET https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/metadata
2. Adım: Yanıttan rapor oluşturmak istediğiniz Etkinlik Kapsamlı Özel Boyutu bulun. Boyut mevcut değilse boyutu kaydetmeniz gerekir.
"dimensions": [
...
{
"apiName": "customEvent:achievement_id",
"uiName": "Achievement ID",
"description": "An event scoped custom dimension for your Analytics property."
},
...
],
3. Adım: Özel boyutu bir rapor isteğine ekleyin. Aşağıda, runReport yöntemi için yapılan örnek bir istek gösterilmektedir.
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
"dimensions": [{ "name": "customEvent:achievement_id" }],
"metrics": [{ "name": "eventCount" }]
}
Kullanıcı kapsamlı özel boyutlar
1. Adım: Metadata API Yöntemini Mülk Kimliğinizle sorgulayın.
GET https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/metadata
2. Adım: Yanıttan hakkında rapor oluşturmak istediğiniz Kullanıcı Kapsamlı Özel Boyutu bulun. Boyut mevcut değilse boyutu kaydetmeniz gerekir.
"dimensions": [
...
{
"apiName": "customUser:last_level",
"uiName": "Last level",
"description": "A user property for your Analytics property."
},
...
],
3. Adım: Özel boyutu bir rapor isteğine ekleyin. Aşağıda, runReport yöntemi için yapılan örnek bir istek gösterilmektedir.
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"entity": { "propertyId": "GA4_PROPERTY_ID" },
"dateRanges": [{ "startDate": "7daysAgo", "endDate": "yesterday" }],
"dimensions": [{ "name": "customUser:last_level" }],
"metrics": [{ "name": "activeUsers" }]
}
Etkinlik kapsamlı özel metrikler
1. Adım: Metadata API Yöntemini Mülk Kimliğinizle sorgulayın.
GET https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/metadata
2. Adım: Yanıttan rapor oluşturmak istediğiniz Etkinlik Kapsamlı Özel Metriği bulun. Metrik yoksa metriği kaydetmeniz gerekir.
"metrics": [
...
{
"apiName": "customEvent:credits_spent",
"uiName": "Credits Spent",
"description": "An event scoped custom metric for your Analytics property.",
"type": "TYPE_STANDARD"
},
...
],
3. Adım: Özel metriği bir rapor isteğine ekleyin. Aşağıda, runReport yöntemi için yapılan örnek bir istek gösterilmektedir.
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"dateRanges": [{ "startDate": "30daysAgo", "endDate": "yesterday" }],
"dimensions": [{ "name": "eventName" }],
"metrics": [{ "name": "customEvent:credits_spent" }]
}
Tek bir önemli etkinlik için önemli etkinlik oranı metrikleri
1. Adım: Metadata API Yöntemini Mülk Kimliğinizle sorgulayın.
GET https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/metadata
2. Adım: Yanıttan rapor oluşturmak istediğiniz Tek Önemli Etkinlik için Temel Etkinlik Oranı Metriği'ni bulun. Önemli etkinlik mevcut değilse anahtar etkinliği ayarlamanız gerekir.
"metrics": [
...
{
"apiName": "sessionKeyEventRate:add_to_cart",
"uiName": "Session key event rate for add_to_cart",
"description": "The percentage of sessions in which a specific key event was triggered",
},
...
],
3. Adım: Önemli etkinlik oranı metriğini bir rapor isteğine ekleyin. Aşağıda runReport yöntemi için yapılan örnek bir istek verilmiştir.
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"dateRanges": [{ "startDate": "30daysAgo", "endDate": "yesterday" }],
"dimensions": [{ "name": "eventName" }],
"metrics": [{ "name": "sessionKeyEventRate:add_to_cart" }]
}
Etkinlik kapsamlı özel metrik ortalamaları
1. Adım: Metadata API Yöntemini Mülk Kimliğinizle sorgulayın.
GET https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/metadata
2. Adım: Yanıttan rapor oluşturmak istediğiniz Etkinlik Kapsamlı Özel Metrik Ortalamasını bulun. Metrik yoksa metriği kaydetmeniz gerekir.
"metrics": [
...
{
"apiName": "averageCustomEvent:credits_spent",
"uiName": "Average Credits Spent",
"description": "The average of an event scoped custom metric for your Analytics property.",
"type": "TYPE_STANDARD"
},
...
],
3. Adım: Özel metrik ortalamasını rapor isteğine ekleyin. Aşağıda, runReport yöntemi için yapılan örnek bir istek gösterilmektedir.
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"dateRanges": [{ "startDate": "2020-11-01", "endDate": "2020-11-10" }],
"dimensions": [{ "name": "eventName" }],
"metrics": [{ "name": "averageCustomEvent:credits_spent" }]
}
Grup raporu örnekleri
Kohort raporları, kohort için kullanıcıları elde tutma ile ilgili bir zaman serisi oluşturur. Her API alanıyla ilgili ayrıntılı belgeler için CohortSpec için REST referansına bakın.
Grup raporu oluşturma
Aşağıda örnek bir grup raporu sunulmuştur. Örneğin:
- Grup,
2020-12-01
firstSessionDate
değerine sahip kullanıcılardır. Bu grup,cohorts
nesnesi tarafından yapılandırılır. Rapor yanıtındaki boyutlar ve metrikler yalnızca kohortun kullanıcılarını temel alır. - Kohort raporunda üç sütun gösterilir. Bu sütun, boyutlar ve metrik nesneleri tarafından yapılandırılır.
cohort
boyutu grubun adıdır.cohortNthDay
boyutu,2020-12-01
tarihinden itibaren geçen gün sayısıdır.cohortActiveUsers
metriği hâlâ etkin olan kullanıcıların sayısıdır.
cohortsRange
nesnesi, raporun bu grup için2020-12-01
ile başlayan ve2020-12-06
ile biten etkinlik verilerini içermesi gerektiğini belirtir.DAILY
ayrıntı düzeyi kullanıldığında, tutarlılık içincohortNthDay
boyutu önerilir.
Grup için rapor isteği:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"dimensions": [{ "name": "cohort" }, { "name": "cohortNthDay" }],
"metrics": [{ "name": "cohortActiveUsers" }],
"cohortSpec": {
"cohorts": [
{
"dimension": "firstSessionDate",
"dateRange": { "startDate": "2020-12-01", "endDate": "2020-12-01" }
}
],
"cohortsRange": {
"endOffset": 5,
"granularity": "DAILY"
}
},
}
Bu istek için örnek bir rapor yanıtı:
{
"dimensionHeaders": [
{ "name": "cohort" }, { "name": "cohortNthDay" }
],
"metricHeaders": [
{ "name": "cohortActiveUsers", "type": "TYPE_INTEGER" }
],
"rows": [
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0000" }],
"metricValues": [{ "value": "293" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0001" }],
"metricValues": [{ "value": "143" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0002" }],
"metricValues": [{ "value": "123" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0003" }],
"metricValues": [{ "value": "92" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0005" }],
"metricValues": [{ "value": "86" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0004" }],
"metricValues": [{ "value": "83" }]
}
],
"metadata": {},
"rowCount": 6
}
Bu rapor yanıtından yola çıkarak söz konusu Grup raporunun grafiği elde edilir. Bu rapordaki bir analiz, bu kohortun etkin kullanıcı sayısındaki en büyük düşüşün birinci ve ikinci gün arasında olduğudur.
Birden fazla kohort ve kullanıcıları elde tutma oranı
Kullanıcı edinme ve elde tutma, Web Sitenizi veya Uygulamanızı büyütmenin yollarıdır. Grup raporları, kullanıcıları elde tutmaya odaklanır. Bu örnekteki rapor, bu mülkün 4 günlük kullanıcıları elde tutma oranını iki hafta içinde% 10 artırdığını göstermektedir.
Bu raporu oluşturmak için üç kohort belirtiriz: İlki firstSessionDate
2020-11-02
, ikincisi firstSessionDate
2020-11-09
ve üçüncüsü firstSessionDate
2020-11-16
olan üçüncü kohort. Mülkünüzdeki kullanıcı sayısı bu üç gün için farklı olacağından, doğrudan cohortActiveUsers
metriğini kullanmak yerine grubun cohortActiveUsers/cohortTotalUsers
kullanıcı elde tutma oranı metriğini karşılaştırırız.
Bu gruplar için rapor isteği:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"dimensions": [{ "name": "cohort" },{ "name": "cohortNthDay" }],
"metrics": [
{
"name": "cohortRetentionFraction",
"expression": "cohortActiveUsers/cohortTotalUsers"
}
],
"cohortSpec": {
"cohorts": [
{
"dimension": "firstSessionDate",
"dateRange": { "startDate": "2020-11-02", "endDate": "2020-11-02" }
},
{
"dimension": "firstSessionDate",
"dateRange": { "startDate": "2020-11-09", "endDate": "2020-11-09" }
},
{
"dimension": "firstSessionDate",
"dateRange": { "startDate": "2020-11-16", "endDate": "2020-11-16" }
}
],
"cohortsRange": {
"endOffset": 4,
"granularity": "DAILY"
}
},
}
Bu istek için örnek bir rapor yanıtı:
{
"dimensionHeaders": [{ "name": "cohort" },{ "name": "cohortNthDay" }],
"metricHeaders": [{
"name": "cohortRetentionFraction",
"type": "TYPE_FLOAT"
}
],
"rows": [
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0000" }],
"metricValues": [{ "value": "1" }]
},
{
"dimensionValues": [{ "value": "cohort_1" },{ "value": "0000" }],
"metricValues": [{ "value": "1" }]
},
{
"dimensionValues": [{ "value": "cohort_2" },{ "value": "0000" }],
"metricValues": [{ "value": "1" }]
},
{
"dimensionValues": [{ "value": "cohort_2" },{ "value": "0001" }],
"metricValues": [{ "value": "0.308" }]
},
{
"dimensionValues": [{ "value": "cohort_1" },{ "value": "0001" }],
"metricValues": [{ "value": "0.272" }]
},
{
"dimensionValues": [{ "value": "cohort_2" },{ "value": "0002" }],
"metricValues": [{ "value": "0.257" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0001" }],
"metricValues": [{ "value": "0.248" }]
},
{
"dimensionValues": [{ "value": "cohort_2" },{ "value": "0003" }],
"metricValues": [{ "value": "0.235" }]
},
{
"dimensionValues": [{ "value": "cohort_2" },{ "value": "0004" }],
"metricValues": [{ "value": "0.211" }]
},
{
"dimensionValues": [{ "value": "cohort_1" },{ "value": "0002" }],
"metricValues": [{ "value": "0.198" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0002" }],
"metricValues": [{ "value": "0.172" }]
},
{
"dimensionValues": [{ "value": "cohort_1" },{ "value": "0003" }],
"metricValues": [{ "value": "0.167" }]
},
{
"dimensionValues": [{ "value": "cohort_1" },{ "value": "0004" }],
"metricValues": [{ "value": "0.155" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0003" }],
"metricValues": [{ "value": "0.141" }]
},
{
"dimensionValues": [{ "value": "cohort_0" },{ "value": "0004" }],
"metricValues": [{ "value": "0.118" }]
}
],
"metadata": {},
"rowCount": 15
}
Bu rapor yanıtından yola çıkarak söz konusu Grup raporunun grafiği elde edilir. Bu rapordan elde edilen analizlere göre, 4 günlük kullanıcıları elde tutma oranı iki haftalık süre içinde% 10 arttı. 2020-11-16
oranında firstSessionDate
değerine sahip sonraki kohortun, 2020-11-02
değerindeki firstSessionDate
metriğiyle önceki kohortun elde tutulmasını aşıyor.
Haftalık kohortlar ve kohortları diğer API özellikleriyle kullanma
Kullanıcı davranışlarındaki günlük sapmaları kaldırmak için haftalık kohortları kullanın. Haftalık kohort raporlarında, aynı hafta içinde firstSessionDate
metriğine sahip olan tüm kullanıcılar grubu oluşturur. Hafta Pazar günü başlar ve Cumartesi günü sona erer. Ayrıca bu raporda, Rusya'da etkinliği olan kullanıcıları Meksika'da etkinliği olan kullanıcılarla karşılaştırmak için grubu bölümlere ayırıyoruz. Bu dilimlemede, yalnızca iki ülkeyi dikkate almak için country
boyutu ve bir dimensionFilter
kullanılır.
Bu gruplar için rapor isteği:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"dimensions": [
{ "name": "cohort" },
{ "name": "cohortNthWeek" },
{ "name": "country" }
],
"metrics": [{ "name": "cohortActiveUsers" }],
"dimensionFilter": {
"filter": {
"fieldName": "country",
"inListFilter": {
"values": [ "Russia", "Mexico" ]
}
}
},
"cohortSpec": {
"cohorts": [
{
"dimension": "firstSessionDate",
"dateRange": {
"startDate": "2020-10-04",
"endDate": "2020-10-10"
}
}
],
"cohortsRange": {
"endOffset": 5,
"granularity": "WEEKLY"
}
},
}
Bu istek için örnek bir rapor yanıtı:
{
"dimensionHeaders": [
{ "name": "cohort" },
{ "name": "cohortNthWeek" },
{ "name": "country" }
],
"metricHeaders": [
{ "name": "cohortActiveUsers", "type": "TYPE_INTEGER" }
],
"rows": [
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0000" },{ "value": "Russia" }
],
"metricValues": [{ "value": "105" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0000" },{ "value": "Mexico" }
],
"metricValues": [{ "value": "98" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0001" },{ "value": "Mexico" }
],
"metricValues": [{ "value": "35" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0002" },{ "value": "Mexico" }
],
"metricValues": [{ "value": "24" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0001" },{ "value": "Russia" }
],
"metricValues": [{ "value": "23" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0004" },{ "value": "Mexico" }
],
"metricValues": [{ "value": "17" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0003" },{ "value": "Mexico" }
],
"metricValues": [{ "value": "15" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0005" },{ "value": "Mexico" }
],
"metricValues": [{ "value": "15" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0002" },{ "value": "Russia" }
],
"metricValues": [{ "value": "3" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0003" },{ "value": "Russia" }
],
"metricValues": [{ "value": "1" }]
},
{
"dimensionValues": [
{ "value": "cohort_0" },{ "value": "0004" },{ "value": "Russia" }
],
"metricValues": [{ "value": "1" }]
}
],
"metadata": {},
"rowCount": 11
}
Bu rapor yanıtından yola çıkarak söz konusu Grup raporunun grafiği elde edilir. Bu rapora göre bu mülk, Meksika'da etkinliği olan kullanıcıları elde tutma konusunda Rusya'da etkinliği olan kullanıcılara kıyasla daha iyi performans gösteriyor.
Karşılaştırmalar
Karşılaştırmalar, verilerinizin alt gruplarını yan yana değerlendirmenize olanak tanır. Bir rapor tanımında comparisons
alanını belirterek karşılaştırmaları tanımlayabilirsiniz. Data API'nin Karşılaştırmalar özelliği, Google Analytics ön ucundaki Karşılaştırmalar özelliğine benzer.
Her API alanıyla ilgili ayrıntılı belgeler için Karşılaştırma için REST referansını inceleyin.
Karşılaştırma Oluşturun
Karşılaştırmak istediğiniz her veri kümesi için ayrı bir karşılaştırma oluşturabilirsiniz. Örneğin, uygulama ve web verilerini karşılaştırmak için Android ve iOS verileri için bir karşılaştırma, Web verileri için başka bir karşılaştırma oluşturabilirsiniz.
Aşağıda, iki karşılaştırmanın tanımlandığı ve etkin kullanıcı sayısını ülkeye göre ayrılmış olarak döndüren bir örnek rapor verilmiştir.
"Uygulama trafiği" adlı ilk karşılaştırma, platform
boyutunu "iOS" ve "Android" değerleriyle eşleştirmek için inListFilter
kullanmaktadır. "Web trafiği" adlı ikinci karşılaştırma, platform
boyutunu "web" ile eşleştirmek için stringFilter
kullanır.
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID:runReport
{
"comparisons": [
{
"name": "App traffic",
"dimensionFilter": {
"filter": {
"fieldName": "platform",
"inListFilter": {
"values": [
"iOS",
"Android"
]
}
}
}
},
{
"name": "Web traffic",
"dimensionFilter": {
"filter": {
"fieldName": "platform",
"stringFilter": {
"matchType": "EXACT",
"value": "web"
}
}
}
}
],
"dateRanges": [
{
"startDate": "2024-05-01",
"endDate": "2024-05-15"
}
],
"dimensions": [
{
"name": "country"
}
],
"metrics": [
{
"name": "activeUsers"
}
]
}
Karşılaştırmalar özelliğini kullanan tüm istekler için comparison
alanı, oluşturulan rapora otomatik olarak eklenir. Bu alan, istekte sağlanan karşılaştırmanın adını içerir.
Karşılaştırmalar içeren bir yanıtın örnek snippet'ini burada görebilirsiniz:
{
"dimensionHeaders": [
{
"name": "comparison"
},
{
"name": "country"
}
],
"metricHeaders": [
{
"name": "activeUsers",
"type": "TYPE_INTEGER"
}
],
"rows": [
{
"dimensionValues": [
{
"value": "Web traffic"
},
{
"value": "United States"
}
],
"metricValues": [
{
"value": "638572"
}
]
},
{
"dimensionValues": [
{
"value": "Web traffic"
},
{
"value": "Japan"
}
],
"metricValues": [
{
"value": "376578"
}
]
},
{
"dimensionValues": [
{
"value": "App traffic"
},
{
"value": "United States"
}
],
"metricValues": [
{
"value": "79527"
}
]
},
...
],
...
}