Google Analytics 4'teki kitleler, kullanıcılarınızı işletmeniz açısından önem taşıyan ölçütlere göre segmentlere ayırmanızı sağlar. Kitleler sayesinde, sitenizin veya uygulamanızın kullanıcılarını ortak özelliklere göre gruplandırabilirsiniz.
Kullanıcıların anlık görüntüleriyle birlikte kitlelerinizi Data API'yi kullanarak dışa aktarabilirsiniz.
Kitle dışa aktarma işlemlerinde gördüğünüz veriler hakkında önemli bilgiler için Kitle dışa aktarma veri beklentileri kılavuzuna bakın.
Genel bakış
Kitle dışa aktarma oluşturmak ve sorgulamak için aşağıdaki Data API isteklerini yapın:
- Kitle dışa aktarma oluşturmak için
audienceExports.create
yöntemini çağırın. - Kitledeki kullanıcıları almak için
audienceExports.query
yöntemi çağrılır.
Daha fazla bilgi için belirli bir kitle dışa aktarma işlemiyle ilgili yapılandırma meta verilerini almak için audienceExports.get
, belirli bir mülkle ilgili tüm kitle dışa aktarma işlemlerini listelemek içinse audienceExports.list
yöntemini çağırabilirsiniz.
Rapor eden varlık seçin
Tüm Data API yöntemleri, Google Analytics 4 mülk tanımlayıcısının bir URL istek yolunda properties/GA4_PROPERTY_ID
biçiminde belirtilmesini gerektirir. Aşağıda bir örnek verilmiştir:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
Rapor, belirtilen Google Analytics 4 mülkünde toplanan Google Analytics etkinlik verilerine göre oluşturulur.
Data API istemci kitaplıklarından birini kullanıyorsanız istek URL'si yolunu değiştirmeniz gerekmez.
Çoğu API istemcisi, properties/GA4_PROPERTY_ID
biçiminde bir dize bekleyen bir property
parametresi sağlar.
İstemci kitaplıklarını kullanma örnekleri için Hızlı başlangıç kılavuzuna bakın.
Kitle dışa aktarma işlemi oluşturma
Kitle dışa aktarma işlemi oluşturmak için isteğinizdeki AudienceExport
nesnesini kullanarak audienceExports.create
yöntemini çağırın. Aşağıdaki parametreler gereklidir:
audience
alanındaproperties/{propertyId}/audiences/{audienceId}
biçiminde geçerli bir kitle adı. Bu değeri elde etmek için Google Analytics Admin API v1'inaudiences.list
yöntemini kullanabilirsiniz.audiences.list
yanıtınınAudience.name
alanı kitle adını içerir.dimensions
alanındaki geçerli bir boyut listesi. Bu yöntem tarafından desteklenen boyutların listesini Kitle dışa aktarma şeması belgelerinde bulabilirsiniz. Kitle dışa aktarma işlemine yalnızca bu alanda belirtilen boyutlarla ilgili veriler dahil edilir.
Aşağıda, kitle dışa aktarma oluşturmak için örnek bir istek verilmiştir:
HTTP İsteği
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
audienceExports.create
yönteminin bir yanıtı, name
alanında kitle dışa aktarma işleminin adını içerir (örneğin, properties/1234567/audienceExports/123
).
Aşağıda örnek bir yanıt verilmiştir:
HTTP Yanıtı
{
"response": {
"@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
}
Kitle dışa aktarma işlemindeki kullanıcıları sorgulamak için name
kullanılabilir.
Kitle dışa aktarma işleminin hazırlık durumunu sorgula
audienceExports.create
aramasından sonra kitle dışa aktarma dosyasının oluşturulması birkaç dakika sürebilir.
audienceExports.get
yöntemini çağırarak kitle dışa aktarma işleminin hazırlık durumunu kontrol edebilirsiniz.
İsteğinizde kitle dışa aktarma işlemini belirtmek için audienceExports.create
yanıtındaki kitle dışa aktarma adını kullanın.
Aşağıda örnek bir istek verilmiştir:
HTTP İsteği
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
Kitle dışa aktarma işleminin hazırlık durumu, yanıtın state
alanında döndürülür. Kitle dışa aktarma işlemi tamamlandığında, CREATING
olan durumu ACTIVE
olarak değişir.
Aşağıda örnek bir yanıt verilmiştir:
HTTP Yanıtı
{
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
audienceExports.list
yöntemini çağırarak tüm kitle dışa aktarma işlemlerinin durumunu alabilirsiniz.
Kitle dışa aktarma işleminden kullanıcıları al
Kitle dışa aktarma işlemi oluşturulduktan sonra audienceExports.query
yöntemini çağırın ve istekte kitle dışa aktarmanın name
değerini belirtin.
Aşağıda örnek bir istek verilmiştir:
HTTP İsteği
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Kitle dışa aktarma işlemi hazırsa bu çağrı, kitledeki kullanıcıların listesini döndürür.
Aşağıda örnek bir yanıt verilmiştir:
HTTP Yanıtı
{
"audienceExport": {
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "ACTIVE",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
},
"audienceRows": [
{
"dimensionValues": [
{
"value": "1000276123.1681742376"
}
]
},
{
"dimensionValues": [
{
"value": "1000374452.1668627377"
}
]
},
{
"dimensionValues": [
{
"value": "1000391956.1652750758"
}
]
},
{
"dimensionValues": [
{
"value": "1000410539.1682018694"
}
]
},
{
"dimensionValues": [
{
"value": "1000703969.1666725875"
}
]
}
],
"rowCount": 5
}