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

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

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

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

  • حساب Joryio، إذ ينشئ فريق Joryio مؤسستكم، وللانضمام إلى مؤسسة قائمة اطلبوا دعوة من مسؤولها
  • الوصول إلى كود موقعكم الإلكتروني لدمج SDK

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

عبر npm​

npm install @joryio/web-sdk

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

<script src="https://sdk.joryio.com/web/1/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: '[email protected]',
  name: 'John Doe',
});

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

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

الخطوة 2: مزود Email (تُعده Joryio)​

مزود Email ‏(SendGrid أو Amazon SES وخدمات مماثلة) هو بنية الإرسال، وتشغّلها Joryio نيابةً عنكم. عند إنشاء حسابكم يضبط فريق Joryio إرسال Email لمؤسستكم؛ لا يوجد ما تثبّتونه ولا بيانات اعتماد مزود تُدخلونها في لوحة التحكم. بعد إتمام خطوات هذا الدليل يمكنكم إرسال Email فورًا. إن لم تُرسَل الرسائل، تواصلوا مع دعم Joryio.

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

يربط دعم Joryio نطاق الإرسال الخاص بكم ويتحقق منه (SPF/DKIM)؛ تضيفون أنتم سجلات DNS التي يرسلها إليكم، ويمكنكم متابعة صحته تحت التحليلات ← قابلية التسليم. ثم أنشئوا العنوان الذي ستصدر منه رسائلكم:

  1. انتقلوا إلى الإعدادات ← إعداد Email
  2. انقروا إضافة إعداد
  3. عيّنوا اسم العرض والجزء المحلي، واختاروا نطاقًا موثقًا من القائمة (مثل [email protected])
  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', {
  orderId: '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 لا تُرسل؟​

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

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

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