受众
不是冻结的 cohort：而是主动同步并推送到 destination 的成员列表。每小时同步、CSV 导出、配额齐备。
工作流
Cohort → audience 流程
先定义一个 cohort，再提升为 audience。source_cohort_id 保持关联，每小时 tick 自动开启。
1. 创建 cohort
在 /app/cohorts 用 event + property 条件定义一个 cohort。Cohort 是静态计数；audience 是实时同步的版本。
/app/cohorts# 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 active主动同步
每小时刷新 — 每小时触发
Worker tick + Redis pub/sub + delta diff + 每日快照 — 受众成员保持实时。
工作方式
Worker 每小时触发，在 CH 中重新评估受众定义，计算 joined/left 差异，并记录 audience_changes_daily 快照。
- Worker 每小时 tick → 每个受众发布到一个 Redis channel
- 与上一份成员列表做 diff → 拆出 joined + left
- audience_changes_daily — 每日成员数 + 净变化
// 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 导出
下载活跃成员列表
GET /v1/audiences/:id/export.csv — 活跃受众成员的简单 3 列 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_at列
audience_id、person_id、joined_at。已哈希 PII（email_sha256 等）保留给 destination 推送 — 不在 CSV 导出中。
配额
Free 3 / Custom 无限
活跃受众数由 M28 W3 配额维度 'audiences' 跟踪。
audiencesaudiences达到上限后，新建受众会被拒绝；已有受众继续运行。
使用场景
受众的价值所在
四个入门 recipe — 给你定义自己受众的灵感。
RFM 高价值
最近 30 天 3+ 次购买 + 最近购买 <14 天 → 高级 remarketing 池。
Churn-risk
活跃订阅 + 最近 14 天未登录 → save-the-customer 邮件 + Meta CAPI suppression。
B2B 账号
按 company_domain 过滤 → 把目标账号下所有用户汇总到一个受众。
行为型
add_to_cart 但从未 purchase 的访客 → 购物车放弃 campaign。
相关文档
下一步阅读
把受众接入 destination，在 AI 摘要中看它们流动，在 playground 发现 patterns。