Bu belgede, Google Analytics Data API v1'in gelişmiş bir özelliği olan yinelenen kitle listeleri açıklanmaktadır. Kitle listesini dışa aktarma özelliğiyle ilgili temel bilgileri görmek için kitle dışa aktarmayla ilgili temel bilgiler kılavuzunu inceleyin.
Yinelenen kitle listeleri, en güncel verilerle çalıştığınızdan emin olmak için kitle üyelikleri değiştikçe her gün kitle listeleri oluşturur.
Normal (yinelenmeyen) kitle listeleri, liste oluşturulduğu sırada kitlede bulunan statik kullanıcı listeleridir.
Her gün yeni bir kitle listesi oluşturma
Bir günün kitle verilerinin işlenmesi ve üyeliğin güncellenmesi değişken bir zaman alır. Kitle listesi verilerinin 24 saat içinde güncellendiğinden emin olmak mümkün değildir.
Örneğin, her gün aynı saatte bir kitle listesi isteseniz bile, bazı günlerde kitle listesi önceki günle aynı olur. Bazı günlerde ise kitle listesi farklı olur ve ek bir günlük üyelik değişiklikleri içerir.
Kitle listeleri, en son üyelik değişikliklerinden bir gün öncesine ait etkinlik verilerini temel alır. Günlük üyelik güncellemeleri yapılmadan önce bir kitle listesi oluşturursanız bu liste iki gün öncesine ait verileri kullanır. Günlük üyelik güncellemeleri yaptıktan sonra bir kitle listesi oluşturursanız bu kitlede düne ait veriler kullanılır.
Yinelenen bir kitle listesine düzenli olarak anket yapma
Yinelenen Kitle Listeleri, yalnızca ek bir güne ait veriler mevcut olduğunda Kitle Listeleri oluşturur. Böylece yeni Kitle Listeleri'ni ne zaman oluşturacağınıza karar vermekten kurtulursunuz. Bunun yerine, ek veri olup olmadığını görmek için Gün boyunca Yinelenen Kitle Listesi'ni uygun bir şekilde sorgulayabilirsiniz.
Yinelenen Kitle Listesi Oluşturma
Yinelenen bir kitle listesi oluşturmak için bir istekteki RecurringAudienceList
nesnesini kullanarak recurringAudienceLists.create
yöntemini çağırın. Aşağıdaki parametreler gereklidir:
audience
alanındaproperties/{propertyId}/audiences/{audienceId}
olarak biçimlendirilmiş 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 boyutların geçerli bir listesi. Bu yöntemin desteklediği boyutların listesini Kitle Dışa Aktarma Şeması belgelerinde bulabilirsiniz. Yalnızca bu alanda belirtilen boyutların verileri Kitle Listesi'ne dahil edilir.
Yinelenen kitle listesi oluşturma isteği için örnek:
HTTP İsteği
POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
recurringAudienceLists.create
yönteminin yanıtı, name
alanında properties/1234567/recurringAudienceLists/123
gibi bir ad içerir. Bu ad, bu yinelenen kitle listesinin yapılandırma meta verilerini almak için sonraki sorgularda kullanılabilir. Ayrıca yapılandırma meta verileri, bu yinelenen kitle listesi için oluşturulmuş kitle listesi örneklerinin kaynak adlarını içerir.
HTTP Yanıtı
{
"name": "properties/1234567/recurringAudienceLists/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"activeDaysRemaining": 180,
"audienceLists": [
"properties/1234567/audienceLists/45678"
]
}
Anket yapılandırması meta verileri
Belirli bir yinelenen kitle listesiyle ilgili yapılandırma meta verilerini almak için recurringAudienceLists.get
yöntemini kullanın. Yapılandırma meta verileri, bu yinelenen kitle listesi için oluşturulan kitle listesi örneklerinin kaynak adlarını içerir.
Aşağıda bir örnek verilmiştir:
HTTP İsteği
GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123
Yanıt olarak bir RecurringAudienceList
örneği döndürülür. Dosya, bu yinelenen kitle listesi için oluşturulan kitle listesi örneklerinin kaynak adlarını içeren yapılandırma meta verilerini içerir.
HTTP Yanıtı
{
"name": "properties/1234567/recurringAudienceLists/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"activeDaysRemaining": 180,
"audienceLists": [
"properties/1234567/audienceLists/45678"
]
}
Bir mülkün tüm yinelenen kitle listelerini listelemek için recurringAudienceLists.list
kullanabilirsiniz.
Yeni kitle listeleri hakkında eşzamansız bildirimler almak için Webhook'ları kullanın
recurringAudienceLists.get
yöntemini kullanarak belirli bir yinelenen kitle listesiyle ilgili yapılandırma meta verilerini periyodik olarak yoklamak yerine, bir kitle listesi kullanıma sunulduğunda Webhook bildirimlerini eşzamansız olarak alabilirsiniz.
Webhook bildirimlerini yapılandırmak için yeni bir yinelenen kitle listesi oluştururken webhookNotification
alanını belirtin.
Google Analytics Data API v1'de Webhook'ları kullanma hakkında daha fazla bilgi için WebhookNotification
belgelerini inceleyin.
Kitle dışa aktarma işlemindeki kullanıcıları alma
Kitle Dışa Aktarma işlemindeki kullanıcıları almak için audienceExports.query
yöntemini çağırın ve recurringAudienceLists.get
veya recurringAudienceLists.list
tarafından sağlanan yapılandırma meta verilerinden alınan Kitle Dışa Aktarma adını belirtin.
HTTP İsteği
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Kitle Dışa Aktarma hazırsa bir kitledeki kullanıcıların listesini içeren bir yanıt döndürülür:
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
}