Google Analytics 4'teki kitleler, kullanıcılarınızı işletmeniz için önemli olan şekillerde segmentlere ayırmanızı sağlar. Kitleler sayesinde, sitenizin veya uygulamanızın kullanıcılarını paylaşılan özelliklere göre gruplandırabilirsiniz.
Google Analytics Data API v1'i kullanarak, kitledeki kullanıcıların anlık görüntüsünü içeren Kitle Dışa Aktarma işlemleri oluşturabilirsiniz.
Kitle dışa aktarma işlemi oluşturma
Google Analytics Data API v1, Kitle Dışa Aktarma oluşturmak için eşzamansız bir yaklaşım kullanır. Öncelikle, kullanıcılar için Audience Export (Kitle Dışa Aktarma) oluşturmak için audienceExports.create
yöntemine istek gönderilmesi gerekir. Ardından, kitledeki kullanıcıları almak için audienceExports.query
yöntemi kullanılır.
Ayrıca, belirli bir Kitle Dışa Aktarma ile ilgili yapılandırma meta verilerini almak için audienceExports.get
ve bir mülkle ilgili tüm Kitle Dışa Aktarma işlemlerini listelemek için audienceExports.list
kullanabilirsiniz.
Raporlama varlığı seçin
Tüm Data API v1 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. Örneğin:
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 yolunu manuel olarak değiştirmenize gerek yoktur.
Çoğu API istemcisi, properties/GA4_PROPERTY_ID
biçiminde bir dize bekleyen property
parametresi sağlar.
İstemci kitaplıklarını kullanmaya ilişkin örnekler için Hızlı başlangıç kılavuzuna bakın.
Kitle Dışa Aktarma isteği oluşturma
Kitle Dışa Aktarma oluşturmak için bir istekteki AudienceExport
nesnesini kullanarak audienceExports.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 Dışa Aktarma işlemine dahil edilir.
Örnek kitle dışa aktarma oluşturma isteği:
HTTP İsteği
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
audienceExports.create
yönteminin yanıtında, name
alanında Audience Export adı (properties/1234567/audienceExports/123
gibi) bulunur. Bu ad, kullanıcıları Kitle Dışa Aktarma özelliğinden almak için sonraki sorgularda kullanılabilir.
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 hazırlık durumu durumunu sorgulama
audienceExports.create
görüşmesinden sonra Kitle Dışa Aktarma işleminin oluşturulması birkaç dakika sürebilir. audienceExports.get
yöntemini çağırarak Kitle Dışa Aktarma işleminin hazır olma durumunu alabilirsiniz.
Kitle Dışa Aktarma'yı belirtmek için audienceExports.create
yanıtından aldığınız Kitle Dışa Aktarma adını (ör. properties/1234567/audienceExports/123
) kullanın.
Örnek:
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 oluşturma işlemi tamamlandığında CREATING
olan durumu ACTIVE
olarak değişir.
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"
}
Tüm kitle dışa aktarma işlemlerinin durumunu audienceExports.list
yöntemini çağırarak alabilirsiniz.
Kitle dışa aktarma işleminde kullanıcıları alma
audienceExports.create
yöntemi kullanılarak Kitle Dışa Aktarma oluşturulduktan sonra audienceExports.query
yöntemini çağırın ve Kitle Dışa Aktarma adını (properties/1234567/audienceExports/123
gibi) 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
}
Kitle Dışa Aktarma veri beklentileri
Aşağıdaki bölümde, Kitle Dışa Aktarma işlemlerindeki kullanıcı üyelikleriyle ilgili veri beklentileri belirlenir.
Veri güncelliği
Kitle Dışa Aktarma verilerinin güncelliği, Google Analytics'in etkinlikleri toplamasının, etkinlikleri işlemesinin ve ardından kitlelerdeki kullanıcı üyeliğini güncellemesinin ne kadar sürdüğünü gösterir. Tüm bu işlem 24 saat sürerse Kitle Dışa Aktarma veri güncelliği 24 saat olur. Daha fazla bilgi edinmek için Veri Güncelliği bölümüne bakın.
Örneğin, bir kullanıcı ilk satın alma işlemini tamamlar ve 7 saat sonra "Alıcılar" kitlesi için bir Kitle Dışa Aktarma oluşturursanız kullanıcı büyük olasılıkla henüz "Alıcılar" Kitle Dışa Aktarma bölümünde olmayacaktır. İlk satın alma işleminden sonraki 14 ila 38 saat içinde, söz konusu kullanıcı muhtemelen yeni kitle dışa aktarma işlemine dahil olur.
Kitle dışa aktarma işlemleri anlık görüntülerdir
Kitle Dışa Aktarma, bir kitledeki kullanıcıların anlık bir anlık görüntüsüdür. Google Analytics, Google Ads yeniden pazarlama için kitlelerdeki kullanıcıları otomatik ve sürekli olarak Google Ads'e aktarır. Buna karşılık, Data API v1 kullanılarak oluşturulan Kitle Dışa Aktarma işlemleri, söz konusu kitledeki en son kullanıcıları görmek için yeni bir Kitle Dışa Aktarma işlemi oluşturmanız gerekir.
Kitle Dışa Aktarma işlemleri, mevcut en yeni kullanıcı üyeliklerine göre oluşturulur. Ancak Kitle Dışa Aktarma işlemlerinin veri güncelliği 20 saat olabilir. Bu, Kitle Dışa Aktarma işleminin geçerli andan 20 saat öncesine ait tüm etkinlikleri temel alacağı anlamına gelir.
En son üyelik verileri günde bir kez, genellikle mülkün saat dilimindeki yaz saatlerinde güncellenir. Bu, aynı kitle için 09:00 ve 11:00'da yapılan Kitle Dışa Aktarma işleminin büyük olasılıkla aynı verileri döndüreceği, ancak 15:00'teki Kitle Dışa Aktarma işleminin, bir günün daha verilerini eklemeye bağlı olarak farklı olabileceği anlamına gelir.
Kitle Dışa Aktarma işlemlerinin geçerlilik süresi
Kitle dışa aktarma işlemlerinin süresi 72 saat sonra dolar. Her gün bir kitleye yeni kullanıcılar girip çıkabilirler. Kullanıcıların en son ekran görüntüsünü elde etmek amacıyla her gün için yeni Kitle Dışa Aktarma işlemleri oluşturmanız gerekir.
Kitle Dışa Aktarma kullanıcı sınırları
Bir kitlenin veya mülkün boyutu kullanıcı sınırını aştığında, Kitle Dışa Aktarma işlemleri kitlenin temsili örneklerini döndürür. Bu sınırlar mülk türünüze (standart veya 360 mülkü) bağlıdır ve her Kitle Dışa Aktarma işleminde ayrı ayrı uygulanır. Geri gelen kullanıcılar, istenen kitledeki kullanıcılardır. Bu kullanıcılar, kitlenin üyesi olabilecek veya olmayabilecek kullanıcılardır.
Sınır Türü | Standart Mülk Sınırları | Analytics 360 Mülk Sınırları |
---|---|---|
Maksimum geri gelen kullanıcı sayısı | 2 milyon | 200 milyon |
Maksimum dikkate alınan kullanıcı sayısı | 10 milyon | 1 milyar |
Raporlama kimliği tutarlılığı
Raporlama kimliği, kullanıcıların raporlarda nasıl tekilleştirileceğine karar verir. Kitle dışa aktarma işlemleri, raporlama kimliği ayarına göre DEĞİŞMEZ. Kitle Dışa Aktarma işlemleri, kullanıcıları her zaman kullanıcı kimliği ve ardından cihaz kimliğine göre tanımlar.
Yani bir kitleyle ilgili raporlar, Kitle Dışa Aktarma işleminin döndürdüğünden daha fazla kullanıcı gösterebilir. Örneğin, Raporlama Kimliği "Cihaz tabanlı" ise ve User ID toplanmışsa raporlar kullanıcı kimliğine göre kullanıcıları tekilleştirmez ancak Kitle Dışa Aktarma işlemleri kullanıcı kimliğine göre tekilleştirilir.
Dolgu tutarlılığı
Google Analytics'te Kitle oluşturup Google Ads yeniden pazarlamayı etkinleştirdiğinizde Google Analytics, Google Ads'de bu kitleyi en son eklenen üyelerle doldurur. Ancak Google Analytics raporları ve kitle dışa aktarımları, doldurulmuş kitle üyeliklerini İÇERMEZ. Raporların ve Kitle Dışa Aktarma işlemlerinin kullanıcıyı ilgili kitlede göstermesi için kitle oluşturulduktan sonra söz konusu kullanıcının günlüğe bir etkinlik kaydetmesi gerekir.
Örneğin, bir kullanıcı 20 Haziran'da günlüğe bir satın alma etkinliği kaydederse ve 21 Haziran'da bir "Alıcılar" kitlesi oluşturursanız söz konusu kullanıcıyı yeni Kitle Dışa Aktarma işlemlerinde görebilmek için 22 Haziran'a kadar beklemeniz gerekebilir. Ancak bu kullanıcı 21 Haziran'da günlüğe bir etkinlik kaydettiyse yalnızca kitle dışa aktarma işlemine dahil edilir.