تخطّ إلى المحتوى الرئيسي

دليل البدء السريع

سيساعدكم هذا الدليل على إرسال حملتكم الأولى في أقل من 5 دقائق.

المتطلبات الأساسية​

  • حساب Joryio (سجلوا في joryio.com)
  • الوصول إلى كود موقعكم الإلكتروني لدمج SDK

الخطوة 1: ثبّتوا SDK (دقيقتان)​

عبر npm​

npm install @joryio/web-sdk

أو عبر وسم script (يُقدَّم من Joryio API)​

<script src="https://api-eu1.joryio.com/sdk/web/latest/joryio.min.js"></script>

هيئوه في تطبيقكم​

import JoryioSDK from '@joryio/web-sdk';

const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_your_key_here' // احصلوا عليه من الإعدادات ← التطبيقات
});

// تعرّف على المستخدمين عند تسجيل دخولهم
joryio.identify('user_123');
joryio.setAttributes({
  email: 'user@example.com',
  name: 'John Doe',
});

// تتبع الأحداث
joryio.track('Page Viewed', {
  page: 'Homepage'
});
الحصول على مفتاح SDK

اذهبوا إلى الإعدادات ← التطبيقات في لوحة Joryio لإنشاء تطبيق والحصول على مفتاح SDK.

الخطوة 2: مزود Email (يُعده المسؤول)​

مزود Email ‏(SendGrid أو SES وغيرهما) هو بنية الإرسال. يُعده مسؤول Joryio في مؤسستكم عبر وحدة التحكم الإدارية؛ لا تضبطون بيانات اعتماد المزود من لوحة التحكم. إن لم يكن Email يرسل بعد، اطلبوا من المسؤول إعداد مزود.

المزودون المدعومون
  • SendGrid
  • Bird (Reach API)
  • AWS SES
  • Mailgun
  • SMTP (أي مزود)

الخطوة 2.5: أضيفوا هوية مرسل (دقيقة واحدة)​

يربط مسؤولكم أولًا نطاق إرسال ويتحقق منه (SPF/DKIM) - يمكنكم رؤية صحته تحت التحليلات ← قابلية التسليم. ثم أنشئوا العنوان الذي ستصدر منه رسائلكم:

  1. انتقلوا إلى الإعدادات ← إعداد Email
  2. انقروا إضافة إعداد
  3. عيّنوا اسم العرض والجزء المحلي، واختاروا نطاقًا موثقًا من القائمة (مثل news@yourdomain.com)
  4. (اختياري) عيّنوه المرسل الافتراضي

راجعوا إعداد Email لقوائم Reply-To / BCC المُدارة والمرسلين لكل نسخة.

الخطوة 3: أنشئوا شريحتكم الأولى (دقيقة واحدة)​

  1. انتقلوا إلى الجمهور ← الشرائح
  2. انقروا إنشاء شريحة
  3. سمّوها «كل المستخدمين»
  4. اتركوا عوامل التصفية فارغة (تطابق الجميع)
  5. انقروا إنشاء شريحة

الخطوة 4: أرسلوا حملتكم الأولى (دقيقة واحدة)​

  1. اذهبوا إلى الحملات
  2. انقروا إنشاء حملة واختاروا نوع حملة Email
  3. اتبعوا خطوات المعالج:
    • التفاصيل: سمّوها «Email الترحيب»
    • الإنشاء: الموضوع «مرحبًا في تطبيقنا!» ورسالة الترحيب
    • الجمهور: اختاروا شريحة «كل المستخدمين»
  4. انقروا إرسال Email تجريبي على نسختكم للمعاينة
  5. في خطوة الملخص، انقروا إطلاق الحملة

تهانينا! أرسلتم للتو حملتكم الأولى.

الخطوات التالية​

تتبع مزيد من الأحداث​

أضيفوا تتبع الأحداث عبر تطبيقكم:

// تسجيل مستخدم
joryio.track('Signup Completed', {
  plan: 'free',
  source: 'website'
});

// استخدام ميزة
joryio.track('Feature Used', {
  feature: 'export',
  format: 'csv'
});

// عمليات الشراء
joryio.track('Order Completed', {
  order_id: 'order_123',
  total: 99.99,
  items: 3
});

أنشئوا شرائح متقدمة​

ابنوا شرائح من سلوك المستخدم:

استهدفوا المستخدمين حيث:
- plan = "trial"
و
- signup_date ضمن آخر 14 يومًا
و
- لم يُجروا "Order Completed"

ابنوا رحلات آلية​

أنشئوا رحلة لتهيئة مؤتمتة:

  1. اذهبوا إلى رحلات العملاء ← إنشاء رحلة عميل
  2. عيّنوا محفز حدث (مثل حدث التسجيل)
  3. أضيفوا Email ترحيب (فوري)
  4. أضيفوا تأخيرًا (يومان)
  5. أضيفوا Email تعليميًا لميزة
  6. فعّلوا الرحلة

مشكلات شائعة​

الأحداث لا تظهر؟​

  • تحققوا من صحة مفتاح SDK
  • فعّلوا وضع التصحيح: new JoryioSDK({ sdkKey, enableDebug: true })
  • تحققوا من وحدة تحكم المتصفح بحثًا عن أخطاء

رسائل Email لا تُرسل؟​

  • اطلبوا من المسؤول تأكيد إعداد مزود Email
  • تحققوا أن المرسل على نطاق موثق
  • راجعوا حالة الحملة

هل تحتاجون إلى مساعدة؟​

كل شيء جاهز! ابدؤوا ببناء مهام أتمتة تسويقية قوية.