Audience'lar
Cohort üzerinde durmuyor, aktif senkronize ettiğin ve destination'a akıttığın member listesi. Hourly sync, CSV export, quota dahil.
Workflow
Cohort → audience akışı
Önce cohort tanımla, sonra audience'a promote et. source_cohort_id ile bağ kurulur, hourly tick devreye girer.
1. Cohort oluştur
/app/cohorts altında event + property koşullarıyla cohort tanımla. Cohort statik bir sayıdır; audience canlı senkronize edilen versiyonu.
/app/behavior2. Audience'a promote et
/app/audiences sayfasında 'Yeni audience' → kaynak cohort'u seç. source_cohort_id link kurulur, hourly refresh otomatik açılır.
/app/audiences# 1. Önce bir cohort oluştur
gurulu cohort create high-intent \
--rule 'event:add_to_cart in last 7d' \
--rule 'event:checkout_started in last 7d'
# 2. Cohort → audience promote
gurulu audience create \
--name "Yüksek niyetli ziyaretçiler" \
--source-cohort high-intent \
--sync hourly
# 3. Aktif audience oluşur — destination'lara bağlanmaya hazır
gurulu audience list --status activeActive sync
Hourly refresh — her saat tetikleniyor
Worker tick + Redis pub/sub + delta diff + günlük snapshot — audience üyeleri canlı.
Nasıl çalışıyor?
Worker her saat tetik atar, audience tanımı CH'de yeniden değerlendirilir, joined/left delta hesaplanır, audience_changes_daily snapshot'ı kayda alınır.
- Worker hourly tick → her audience için Redis kanalına publish
- Önceki üye listesiyle diff → joined + left ayrılır
- audience_changes_daily — günlük üye sayısı + net değişim
// Worker hourly tick — Redis pub/sub trigger
PUBLISH gurulu:audience:refresh:{audience_id} '{"reason":"hourly_tick"}'
// Sonuç: audience_changes_daily snapshot
// { audience_id, snapshot_date, member_count, joined_count, left_count, net_change }CSV export
Aktif üye listesini indir
GET /v1/audiences/:id/export.csv — aktif audience üye listesi, basit 3-kolon CSV.
curl -X GET https://api.gurulu.io/v1/audiences/aud_01H8XYZ/export.csv \
-H "Authorization: Bearer $GURULU_SECRET_KEY" \
-o audience-members.csv
# CSV kolonlar:
# audience_id, person_id, joined_atKolonlar
audience_id, person_id, joined_at. Hashed PII (email_sha256 vs.) destination push'larına özel, CSV export'ta yok.
Kota
Free 3 / Custom unlimited
Aktif audience sayısı M28 W3 quota dimension 'audiences' ile takip edilir.
audiencesaudiencesLimit aşıldığında yeni audience oluşturma reddedilir; mevcut audience'lar çalışmaya devam eder.
Kullanım örnekleri
Hangi senaryolarda işe yarıyor?
Hazır 4 örnek — kendi audience tanımınla başlamak için ilham.
RFM yüksek-değer
Son 30 günde 3+ purchase + son alım <14 gün → premium remarketing havuzu.
Churn-risk
Aktif sub + son 14 gün login yok → save-the-customer e-posta + Meta CAPI suppression.
B2B hesap
company_domain prop'u ile filtre → hedef hesabın tüm kullanıcılarını tek audience'ta topla.
Davranışsal
add_to_cart yapıp purchase yapmadan ayrılan ziyaretçiler → cart abandonment kampanyası.
İlgili dokümanlar
Devamında oku
Audience'larını destination'a bağla, AI özetinde gör, playground'da pattern keşfet.