M24 · Audience Builder

الجماهير

ليس cohort مجمَّداً: بل قائمة أعضاء تتم مزامنتها فعلياً ودفعها إلى الوجهات. مزامنة كل ساعة، تصدير CSV، حصة مشمولة.

تدفق العمل

Cohort → audience

عرّف cohort أولاً، ثم رقّه إلى audience. يبقي source_cohort_id الرابط؛ تنطلق tick الساعية تلقائياً.

1. أنشئ cohort

في /app/cohorts عرّف cohort بشروط event + property. الـ cohort عدد ثابت؛ الـ audience هو النسخة الحية المُزامَنة.

/app/cohorts

2. ارفعه إلى audience

في /app/audiences اختر 'جمهور جديد' → اختر cohort المصدر. يُربط source_cohort_id وتُفعَّل تحديث ساعي تلقائياً.

/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 active

المزامنة النشطة

تحديث ساعي — يُطلَق كل ساعة

Worker tick + Redis pub/sub + delta diff + لقطة يومية — يبقى أعضاء الجمهور حيين.

كيف يعمل

ينطلق الـ Worker كل ساعة، ويُعاد تقييم تعريف الجمهور في CH، وتُحسب فروقات joined/left، وتُسجَّل لقطة audience_changes_daily.

  • Worker tick ساعي → النشر على قناة Redis لكل جمهور
  • 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 — أعضاء الجمهور النشط بصيغة CSV بسيطة من 3 أعمدة.

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 وغيره) محجوز للدفع إلى الوجهات — وليس في تصدير CSV.

الحصة

Free 3 / Custom بلا حد

يُتعقّب عدد الجماهير النشطة عبر بُعد حصة M28 W3 'audiences'.

الباقة
الحد الأقصى للجماهير النشطة
بُعد الحصة
Free
3 جماهير نشطة (المسوّدات + المؤرشفة لا تُحسَب)
audiences
Custom
بلا حد (usage-based، بعد الفاتورة)
audiences

عند بلوغ الحد، يُرفض إنشاء جمهور جديد؛ تستمر الجماهير القائمة في العمل.

حالات الاستخدام

حيث تُثبت الجماهير قيمتها

أربع وصفات ابتدائية — إلهام لتعرّف بنفسك.

RFM عالي القيمة

3+ مشتريات في آخر 30 يوماً + آخر شراء قبل أقل من 14 يوماً → بركة remarketing مميزة.

Churn-risk

اشتراك نشط + لا تسجيل دخول في آخر 14 يوماً → بريد save-the-customer + استثناء Meta CAPI.

حساب B2B

تصفية حسب company_domain → جمع كل مستخدمي حساب مستهدف في جمهور واحد.

سلوكي

زوار قاموا بـ add_to_cart دون شراء → حملة purchase abandonment.

وثائق ذات صلة

اقرأ بعد ذلك

اربط الجماهير بالوجهات، شاهد حركتها في ملخص الذكاء الاصطناعي، اكتشف patterns في الـ playground.

الوجهات — Meta CAPI / Google Ads / Webhookالملخص الصباحي — حركة الجمهور في الموجزPlayground Crawler — اكتشاف patternsفهرس الوثائق
الجماهير — وثائق Gurulu