Kitle büyümesini okuma
Şu an biten bir zaman aralığında her kitleye gün, saat veya dakika bazında sayılan kaç kişinin katıldığı: kitleler sayfasındaki büyüme grafiği. Bir kitle birinin ne zaman katıldığını kaydeder, ne zaman ayrıldığını asla kaydetmez; bu yüzden her sayı bugün hâlâ listede olan kişileri katılım tarihlerine göre sayar ve bir çizgi hiçbir zaman düşmez.
Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.
GET /audiences/growth
Şu an biten bir zaman aralığında her kitleye gün, saat veya dakika bazında sayılan kaç kişinin katıldığı: kitleler sayfasındaki büyüme grafiği. Bir kitle birinin ne zaman katıldığını kaydeder, ne zaman ayrıldığını asla kaydetmez; bu yüzden her sayı bugün hâlâ listede olan kişileri katılım tarihlerine göre sayar ve bir çizgi hiçbir zaman düşmez.
Örnek
audiences:read gerektirir. Tüm kitleler için audienceIds parametresini vermeyin ya da virgülle ayırarak en fazla 50 kitle belirtin. Aralık days (1 ile 1095 arası) veya minutes (1 ile 1576800 arası; ikisi birlikte gönderilirse bu geçerli olur) ile belirlenir, varsayılanı 30 gündür. grain değeri day, hour veya minute olur, varsayılanı daydir; offsetMinutes (-840 ile 840 arası) ise görüntüleyenin UTC farkıdır, böylece günlük dilimler onun yerel gece yarısında başlar.
curl "$OE/audiences/growth?days=30" -H "$AUTH"{ "object": "audience_growth", "since": "2026-08-25T00:00:00.000Z", "until": "2026-09-23T12:00:00.000Z", "grain": "day", "offsetMinutes": 0, "totals": { "contacts": 412, "memberships": 415, "added": 37, "lists": 2, "busiest": "2026-09-18" }, "series": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": true, "total": 412, "before": 378, "added": 34, "buckets": [ { "bucket": "2026-09-14", "added": 9 }, { "bucket": "2026-09-18", "added": 25 } ] }, { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": false, "total": 3, "before": 0, "added": 3, "buckets": [{ "bucket": "2026-09-18", "added": 3 }] } ]}total şu anki üyeler, before bunlardan since öncesinde katılanlar, added ise aralık içinde katılanlardır; yani before artı added, total eder. Katılıp sonra ayrılan bir kişi bunların hiçbirinde yer almaz.
totals.contacts her kişiyi kaç listede olursa olsun bir kez sayar, totals.memberships ise listeleri toplar; böylece bir kişi, okunan ve kendisini içeren her liste için bir kez sayılır, varsayılan kitle de herkesi içerir. totals.busiest tüm listelerde en çok katılımın olduğu dilimdir, kimse katılmadıysa null olur.
Dilim anahtarları gün için YYYY-MM-DD, saat için YYYY-MM-DDTHH ve dakika için YYYY-MM-DDTHH:MM biçimindedir ve offsetMinutes ile belirtilen yerel saattedir. Yalnızca katılım olan dilimler listelenir; bu yüzden çizerken boşlukları sıfırla doldurun. series, total değerine göre büyükten küçüğe, sonra ada göre sıralanır ve builtin varsayılan kitlede true olur.
audienceIds içinde bu çalışma alanında bir kitle olmayan bir kimlik 404 audience_not_found, 50’den fazla kimlik ise 422 invalid_parameter verir. Aralık ilk diliminin başında başlar; bu yüzden since, tam olarak days gün öncesinden biraz daha erkene düşebilir.