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

مقدمة

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

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

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

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

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

شرح بسيط​

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

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

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

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

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

Without Events Module (manual):
- User wants restock alert → Custom tracking code
- Product price drops → Manual notification logic
- Each product needs separate handling

With Events Module (automated):
- User subscribes to product → Stored automatically
- Product restocked → All subscribers notified
- All subscriptions managed centrally

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

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

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

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

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

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

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

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

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

1. User subscribes to a product
   ↓
2. Product status changes (restocked, price change, etc.)
   ↓
3. Event detects the change
   ↓
4. Event sends notifications to all subscribers
   ↓
5. Subscribers receive the message

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Good markers:
- product_back_in_stock
- product_price_drop
- product_low_stock
- product_new_variant
- product_discontinued

Bad markers:
- event1
- notification
- product_event
- test

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

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

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

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


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

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