انتقل إلى المحتوى الرئيسي

المقدمة

اشترك في الإشعارات والتحديثات المتعلقة بالمنتجات.

🔐 تتطلب هذه الطريقة تفويضًا.

ماذا يفعل هذا الموديل؟​

يتيح لك موديل Events اشتراك المستخدمين في إشعارات المنتجات - مثل تلقي بريد إلكتروني عندما يعود المنتج إلى المخزون، أو تنبيه عندما ينخفض السعر.

فكر في الأمر كنظام اشتراك للمنتجات - يمكن للمستخدمين الاشتراك في منتجات معينة وتلقي إشعارات عندما يتغير شيء ما.

شرح بسيط​

تخيل أنك تدير متجرًا عبر الإنترنت وترغب في إبقاء المستخدمين على اطلاع بالمنتجات:

  • المنتج عاد إلى المخزون - إخطار المستخدمين الذين ينتظرون هذا العنصر
  • انخفاض السعر - تنبيه المستخدمين الذين يراقبون هذا المنتج
  • إضافة منتج جديد - إخطار المشتركين في فئة معينة
  • تحذير من المخزون المحدود - إبلاغ المستخدمين المهتمين قبل نفاد المنتج

بدلاً من تتبع يدوي لمن يريد ماذا:

  • قم بتكوين أحداث المنتجات في لوحة إدارة OneEntry
  • يشترك المستخدمون في المنتجات التي تهمهم
  • إشعارات تلقائية عندما يتغير شيء ما
  • إدارة جميع الاشتراكات في مكان واحد

مثال من العالم الحقيقي:

بدون موديل Events (يدوي):
- المستخدم يريد تنبيه إعادة التخزين → كود تتبع مخصص
- سعر المنتج ينخفض → منطق إشعار يدوي
- كل منتج يحتاج إلى معالجة منفصلة

مع موديل Events (آلي):
- المستخدم يشترك في المنتج → يتم تخزينه تلقائيًا
- تم إعادة تخزين المنتج → يتم إخطار جميع المشتركين
- يتم إدارة جميع الاشتراكات مركزيًا

المفاهيم الأساسية​

ما هو حدث المنتج؟​

حدث المنتج هو إشعار يتم تفعيله بواسطة تغييرات في المنتج:

  • المحفز - ما يحدث للمنتج (مثل "عاد إلى المخزون")
  • الإشعار - ما يتلقاه المشتركين (بريد إلكتروني، دفع، رسالة سوكت)
  • المشتركون - المستخدمون الذين اختاروا تلقي تحديثات هذا المنتج
  • القالب - محتوى رسالة الإشعار

قنوات الإشعار​

ثلاث طرق لإخطار المشتركين:

القناةالوصفالأفضل لـ
البريد الإلكترونيإرسال رسائل بريد إلكترونيتنبيهات إعادة التخزين، انخفاض الأسعار، النشرات الإخبارية
إشعار الدفعتنبيهات على الهاتف/المتصفحتنبيهات عاجلة، مبيعات فلاش
Socket.IOرسائل ويب سوكت في الوقت الحقيقيتحديثات المخزون المباشرة، مزامنة الأسعار الفورية
التكاملاترسائل التكاملسير العمل المخصص للإشعارات

اقرأ المزيد عن التكاملات

مثال على تدفق الحدث​

1. المستخدم يشترك في منتج
   ↓
2. حالة المنتج تتغير (إعادة التخزين، تغيير السعر، إلخ)
   ↓
3. الحدث يكتشف التغيير
   ↓
4. الحدث يرسل إشعارات لجميع المشتركين
   ↓
5. المشتركون يتلقون الرسالة

ما تحتاج لمعرفته​

محفزات أحداث المنتج الشائعة​

أحداث المنتج النموذجية التي قد تقوم بإعدادها:

  • المنتج عاد إلى المخزون
  • تنبيه انخفاض السعر
  • تحذير من المخزون المنخفض
  • المنتج تم إيقافه
  • متغير جديد متاح
  • عرض خاص على المنتج

اقرأ المزيد عن محفزات الأحداث.

متغيرات القالب​

استخدم عناصر النائب في قوالب الإشعارات لتضمين تفاصيل المنتج مثل الاسم والسعر والتوافر.

جدول مرجعي سريع - الطرق الشائعة​

الطريقةماذا تفعل
getAllSubscriptions()الحصول على جميع اشتراكات المنتجات
subscribeByMarker()الاشتراك في حدث منتج بواسطة علامة
unsubscribeByMarker()إلغاء الاشتراك من حدث منتج بواسطة علامة

ملاحظة: يتم تكوين الأحداث في لوحة إدارة OneEntry. يدير SDK الاشتراكات - استخدمه للاشتراك/إلغاء الاشتراك للمستخدمين من أحداث المنتجات.

الأسئلة الشائعة (FAQ)​

كيف يمكنني إنشاء أو تعديل أحداث المنتجات؟​

تتم إدارة الأحداث في لوحة إدارة OneEntry admin panel:

  1. تسجيل الدخول إلى إدارة OneEntry
  2. الانتقال إلى قسم الأحداث
  3. إنشاء أو تعديل أحداث المنتجات
  4. تكوين المحفزات والقنوات والقوالب
  5. تفعيل الحدث

ما الفرق بين إشعار الدفع وSocket.IO؟​

إشعار الدفع - يُرسل إلى الجهاز (يعمل حتى عند إغلاق التطبيق)

  • يظهر في مركز الإشعارات
  • يمكن للمستخدم النقر لفتح التطبيق
  • الأفضل لـ: تنبيهات إعادة التخزين، انخفاض الأسعار

Socket.IO - رسالة ويب سوكت في الوقت الحقيقي (فقط عندما يكون التطبيق مفتوحًا)

  • تسليم فوري للعملاء المتصلين
  • تحديثات مباشرة بدون تحديث
  • الأفضل لـ: عرض المخزون المباشر، تحديثات الأسعار في الوقت الحقيقي

هل يمكنني تفعيل حدث منتج يدويًا من الكود الخاص بي؟​

لا يدعم SDK المحفزات اليدوية. يتم تشغيل الأحداث تلقائيًا بناءً على المحفزات المكونة في OneEntry عندما تتغير بيانات المنتج.

هل يمكنني تخصيص قوالب الإشعارات؟​

نعم! في لوحة إدارة OneEntry:

  • قوالب بريد إلكتروني بتنسيق HTML
  • تنسيق مخصص
  • دعم متعدد اللغات
  • متغيرات خاصة بالمنتج

ملاحظات هامة​

قاعدة تسمية الأحداث​

استخدم علامات واضحة ووصفية لأحداث المنتجات:

علامات جيدة:
- product_back_in_stock
- product_price_drop
- product_low_stock
- product_new_variant
- product_discontinued

علامات سيئة:
- event1
- notification
- product_event
- test

أفضل الممارسات​

  • استخدم علامات أحداث وصفية تتضمن "منتج"
  • تضمين تفاصيل المنتج ذات الصلة في قوالب الإشعارات
  • توطين رسائل الأحداث للأسواق المختلفة
  • التعامل مع أخطاء الاشتراك بشكل سلس
  • السماح للمستخدمين بإلغاء الاشتراك بسهولة

مزيد من المعلومات حول واجهة المستخدم للموديل https://doc.oneentry.cloud/docs/events/introduction

تعريف موديل الأحداث​


const { Events } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

الوثائق ذات الصلة​