مرجع أحداث المنصة

تُصدر Joryio هذه الأحداث تلقائيًا كجزء من المنصة (مسار الرسائل، وبطاقات Wallet، وتكاملات المتجر، وSDK). تظهر في تدفق الأحداث بجانب أحداثك المخصصة، وتعد هذه الصفحة المرجع المعتمد لمعنى كل حدث. يعرف مساعد AI هذه التعريفات ويستخدم الإشارات عند اقتراح الرحلات والشرائح. أما الأحداث والسمات الخاصة بك، فأضف وصفًا لها في صفحات الأحداث والسمات؛ إذ يقرأها AI أيضًا.

الرسائل

الحدث	الوصف	الإشارة
`message.sent`	أرسلت Joryio رسالة (عبر أي قناة) إلى هذا المستخدم.	-
`message.delivered`	أكد مزود الخدمة التسليم.	-
`message.opened`	فتح المستلم رسالة Email.	تفاعل
`message.clicked`	نقر المستلم رابطًا متتبعًا.	تفاعل قوي
`message.bounced`	ارتد التسليم (دائم/مؤقت).	مشكلة في جودة القائمة
`message.auto_replied`	أرسل صندوق بريد المستلم ردًا تلقائيًا (خارج المكتب). تم تسليم البريد: ليس ارتدادًا.	-
`message.unsubscribed`	ألغى المستلم الاشتراك عبر رابط أو ترويسة من Joryio، أو بحفظ صفحة التفضيلات، أو برد STOP. يوضح `scope` ما الذي غادره: `channel` (القناة التي وصلت عليها الرسالة فقط) أو `list` أو `global` (كل شيء - اختيار صريح). يحمل `campaignId` و`canvasId` و`nodeId` و`variantId`. يوضح `unsubscribeSource` طريقة الوصول (`header_one_click` = زر تطبيق البريد، `page_button` = زر الصفحة المستضافة، `preferences_page`، `page_everything`، `keyword`؛ منذ 2026-10-15)، مع `userAgent` و`sinceSendMs` (بالمللي ثانية بعد الإرسال). منذ 2026-11-02 يُكتب أيضاً عندما يلغي عضو في الفريق (`admin`) أو مفتاح API (`api`) الاشتراك في قناة، وعند إلغاء الاشتراك من SDK (`sdk`)، وعند إلغاء اشتراك من المتجر (`store_sync`، بما في ذلك مربع غير محدد عند تفعيل الإعداد الاختياري للمتجر)؛ ولا تحمل هذه حملة.	إلغاء اشتراك
`message.subscribed`	أصبح الشخص مشتركًا - المقابل لـ `message.unsubscribed` (منذ 2026-10-25). مرة واحدة لكل تغيير حقيقي (من دون حالة أو `unsubscribed` أو `pending` إلى مشترك)، ولا يُسجَّل أبدًا إذا كان الشخص مشتركًا من قبل. `scope`: `channel` (القناة نفسها) أو `list` (قائمة، مع `listId`). يحمل `channel` و`source` (كيف حدث - راجع حدث الاشتراك) و`platform` لاشتراك من متجر و`optInSource` و`status` و`previousStatus` و`resubscribe`. يمكن أن تبدأ رحلة منه. لا يُسجَّل للاستيراد أو مزامنة مستودع البيانات أو الإضافة الجماعية إلى قائمة أو المزامنة الأولى للمتجر.	اشتراك
`Unsubscribe Page Viewed`	فتح المستلم صفحة إلغاء الاشتراك أو التفضيلات من رابط في رسالة. ليس إلغاء اشتراك. الخصائص: `campaignId` و`canvasId` و`nodeId` و`variantId` و`channel` و`page` (`unsubscribe` أو `preferences`) و`position` (أي رابط إلغاء اشتراك في البريد). الروبوتات مستبعدة؛ مرة لكل رابط كل 24 ساعة.	نية إلغاء الاشتراك
`message.failed`	فشل الإرسال لدى مزود الخدمة.	-
`message.spam_complaint`	ليس اسم حدث يُرسل فعليًا: تصل شكاوى البريد العشوائي باسم `message.spamreport`. لا يُعرض في منتقيات الأحداث.	خطر على قابلية التسليم
`message.queued`	قبل مزود الخدمة الرسالة ووضعها في الطابور.	-
`message.deferred`	أرجأ مزود الخدمة التسليم مؤقتًا (ستتم إعادة المحاولة).	-
`message.skipped`	تخطت Joryio الإرسال بسبب قيد (قائمة حظر أو حد تكرار أو ساعات هادئة أو موافقة).	-
`message.held`	محتجزة بواسطة Joryio: احتجزت بوابة التفاعل رسالة رحلة لفترة لأن الشخص تلقى للتو رسالة أخرى، أو أسقطتها عندما فات وقتها؛ يقول `reason` السبب ويسمّي الرسالة المنافسة إن وُجدت.	`outcome`, `reason`, `nodeId`
`message.complained`	اسم بديل مقبول لـ `message.spamreport` عند عدّ الشكاوى (صفوف تاريخية)؛ لا يرسله أي مصدر اليوم. لا يُعرض في منتقيات الأحداث.	خطر على قابلية التسليم
`message.spamreport`	شكوى بريد عشوائي أبلغ عنها مزود الخدمة (اسم بديل لـ `spam_complaint` لدى بعض المزودين).	خطر على قابلية التسليم

بطاقات Wallet

الحدث	الوصف	الإشارة
`pass.issued`	أُصدرت بطاقة Wallet للمستخدم (Joryio Wallet Passes).	-
`pass.installed`	أضاف المستخدم البطاقة إلى محفظة Apple أو Google.	اشتراك في قناة Wallet
`pass.updated`	دُفع تحديث لمحتوى البطاقة إلى البطاقات المثبتة.	-
`pass.removed`	أزال المستخدم البطاقة من محفظته (Joryio Wallet Passes).	نية توقف؛ رحلة استعادة تُشغّل بهذا الحدث ذات إشارة قوية
`pass.downloaded`	تم تنزيل ملف البطاقة (خطوة تسبق التثبيت).	-
`pass.scanned`	تم مسح الباركود أو رمز QR للبطاقة (مثل الاسترداد عند نقطة البيع).	تفاعل قوي؛ استخدام فعلي
`pass.expired`	وصلت البطاقة إلى تاريخ انتهائها.	فرصة للتجديد
`pass.update_pushed`	دُفع تحديث محتوى إلى البطاقات المثبتة (Push صريح عند التعديل).	-
`pass.voided`	ألغت الشركة البطاقة أو عطلتها.	-

التجارة الإلكترونية

الحدث	الوصف	الإشارة
`purchase`	ليس حدثًا ترسله Joryio: تصل عملية الشراء المكتملة باسم `Order Completed`. لا يُعرض في منتقيات الأحداث.	-
`Order Completed`	طلب مكتمل من متجر متصل أو من Orders API أو من SDK (حدث التجارة المعتمد). يحمل أيضًا السلة التي جاء منها الطلب وما إذا كان قد استعادها: `cartRef`، `recoveredCart` (`true` عندما استعاد الطلب سلة متروكة - القرار نفسه الذي تعرضه علامة "سلة مستعادة" في صفحة الطلبات)، `recoveredVia` (`recovery_link`, `same_cart`, `contact_cart`, `reported`)، وإسناد الوصول الذي أبلغ عنه المتجر: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`، `campaign_id`، `canvas_id`. راجع خصائص Order Completed.	شراء - السلة المستعادة هي تحويل رحلة الاستعادة
`Order Refunded`	أبلغ متجر متصل (Shopify وWooCommerce وMagento) أو واجهة Orders API عن استرداد جديد في طلب - حدث واحد لكل استرداد، كامل أو جزئي. `total` هو المبلغ الذي أعاده هذا الاسترداد (`total_base` بالعملة الأساسية)، وليس إجمالي الطلب. وأيضًا: `order_id` و`currency` و`refund_type` (`full` أو `partial`) و`refund_amount` و`refund_id` و`reason` و`products` و`coupon_codes`. الإيراد صافٍ من الاستردادات أصلًا، لذا لا يخفضه هذا الحدث مرة ثانية أبدًا. راجع أحداث الاسترداد والإلغاء.	عدم رضا بعد الشراء
`Order Cancelled`	ألغى متجر متصل أو واجهة Orders API طلبًا - مرة واحدة لكل طلب. الخصائص: `order_id` و`total` و`currency` و`reason` و`cancelled_at` و`coupon_codes`.	بيع ضائع
`Coupon Issued`	أصدر برنامج قسائم رمزاً للشخص (الخصائص: program، program_id، campaign_id، canvas_id، node_id، source، expires_at). الرمز نفسه لا يوجد أبداً على أي حدث.	-
`Coupon Redeemed`	استخدم طلبٌ رمزاً أصدرته Joryio (تُضاف order_id، revenue، redeemed_by_someone_else). يُطلق على الشخص الذي أُصدر له الرمز.	تحويل من رسالة
`Coupon Expired`	انتهت صلاحية رمز دون استخدام (program، program_id، campaign_id، canvas_id، expires_at).	فرصة لاستعادة العميل
`Checkout Started`	بدأت عملية إتمام الشراء لكنها لم تكتمل بعد.	-
`cart_abandoned`	ليس حدثًا: إنه حالة السلة المتروكة التي يفحصها شرط شريحة أو فرع (E-commerce: سلة متروكة). لبدء رحلة عند ترك سلة، استخدم `Cart Abandoned`. لا يُعرض في منتقيات الأحداث، ولا يمكن نشر رحلة تبدأ به.	-
`Cart Abandoned`	ترسله المتاجر المتصلة (Shopify وWooCommerce وMagento وPrestaShop) عندما تبقى سلة دون طلب طوال مهلة الترك المحددة لمساحة العمل. `checkoutUrl` هو رابط الاسترداد الخاص بالمتجر لهذه السلة - اربطه بصيغة `{{ cart.checkoutUrl }}`. يظهر في منتقيات الأحداث مع عبارة "ترسله المتاجر المتصلة". يحدد `cartId` هذه السلة: تحصل السلة التالية لجهة الاتصال على معرّف جديد (قبل 2026-10-27 كان يتكرر بين سلال جهة الاتصال نفسها). و`cartRef` هو مرجع السلة في المتجر نفسه (`quote_33` في Magento، أو جلسة WooCommerce، أو معرّف سلة PrestaShop، أو رمز دفع Shopify). لا يُرسل لسلة لا يمكن الوصول إلى صاحبها (بلا بريد إلكتروني أو هاتف أو معرّف عميل أو هوية في تطبيق) - ويُرسل مرة واحدة إذا أصبح الوصول إليه ممكنًا - ومرة واحدة لكل ترك: السلة التي تغيّرت عناصرها بعد تركها (أُفرغت ثم مُلئت من جديد، أو أُضيفت عناصر أو أُزيلت)، أو التي تعود دون تغيير بعد يوم أو أكثر، ثم تُترك مرة أخرى، هي ترك جديد بمعرّف `cartId` جديد (السلة نفسها تُركت مرة أخرى)؛ ولا يُرسل تكرار الترك نفسه مرة أخرى. `value` هو إجمالي السلة الذي أرسله المتجر (قد يشمل الشحن)؛ و`subtotal` هو المجموع الفرعي للعناصر، قبل الشحن والضريبة. تكون `recoveryLink` بقيمة `true` عندما يكون `checkoutUrl` رابط الاسترداد الخاص بالمتجر و`false` عندما يكون مجرد صفحة الدفع أو السلة (منذ 2026-11-01). تكون `source` بقيمة `plugin_event` عندما يُبلغ المتجر عن الترك و`cart_abandonment_scan` عندما يحدد Joryio السلة بنفسه (عندما لا يُبلغ المتجر عن الترك).	مشغّل رحلة الاسترداد التقليدي
`Cart Updated`	أُضيفت عناصر إلى السلة أو أُزيلت منها.	-
`Product Added`	أُضيف منتج إلى السلة.	نية شراء
`back_in_stock`	عاد منتج شاهده المستخدم مؤخرًا أو أضافه إلى السلة (من دون شرائه) إلى المخزون؛ يصدر لكل مستخدم عند انتقال الكتالوج من نفاد المخزون إلى توفره (Shopify وWooCommerce).	مشغّل تجزئة عالي التحويل
`price_drop`	انخفض سعر منتج شاهده المستخدم مؤخرًا أو أضافه إلى السلة (من دون شرائه) بما يتجاوز الحد المحدد؛ يصدر لكل مستخدم عند انتقال سعر الكتالوج إلى الانخفاض.	مشغّل تجزئة عالي التحويل
`entity_back_in_stock`	الحدث الافتراضي لتنبيه علاقة الكيان (إعادة توفر في كتالوج مخصص أو حلقة جديدة وغيرها)؛ يصدر لكل مستخدم عند انتقال حقل مراقب في سجل كيان مخصص. يمكن ضبط التنبيهات لإصدار اسم حدث مخصص بدلًا من ذلك.	مشغّل كتالوج مخصص
`Product Viewed`	تمت مشاهدة صفحة منتج.	اهتمام بالتصفح

SDK / الويب

الحدث	الوصف	الإشارة
`session_start`	ليس الاسم الذي ترسله حزم SDK: تصل بداية الجلسة باسم `Session Start`. لا يُعرض في منتقيات الأحداث.	-
`Page Viewed`	تمت مشاهدة صفحة (Web SDK).	-
`signup`	ليس حدثًا ترسله Joryio: تتتبع التطبيقات حدث التسجيل الخاص بها (مثل `Signed Up`). لا يُعرض في منتقيات الأحداث.	-

الرسائل داخل التطبيق

الحدث	الوصف	الإشارة
`in_app.served`	علامة من جهة الخادم: تم تسليم رسالة داخل التطبيق إلى جهاز لعرضها (واحدة لكل تسليم). تحجز مكانًا في حد التكرار لمدة دقيقتين حتى يؤكد الجهاز العرض؛ ولا يُحتسب في الحد إلا `in_app.displayed`، وهو انطباع يؤكده العميل.	-
`in_app.viewed`	ليس الاسم الذي ترسله حزم SDK: يصل عرض رسالة داخل التطبيق باسم `in_app.displayed`. لا يُعرض في منتقيات الأحداث.	-
`in_app.clicked`	نقر المستخدم CTA داخل رسالة داخل التطبيق.	تفاعل
`in_app.displayed`	عُرضت رسالة داخل التطبيق (انطباع).	-
`in_app.dismissed`	أغلق المستخدم الرسالة داخل التطبيق دون اتخاذ إجراء.	-
`in_app.converted`	نفذ المستخدم إجراء الهدف لرسالة داخل التطبيق.	تحويل
`In-App Form Submitted`	أُرسل نموذج داخل رسالة في التطبيق وكُتب إلى هذا الشخص: سمات واشتراكات في القوائم ووسوم (الخصائص: `campaignId` و`campaignName` و`variantId` و`fields` و`listsSubscribed`، و`email` و`phone` و`phoneUpdated` من النموذج - انظر `Form Submitted`).	تحويل

الرحلات

يكتبها محرك الرحلات لكل خطوة يصل إليها الشخص ويغادرها، في كل أنواع العقد. تُسجَّل منذ إصدار 2026-10-13 فصاعدًا - عمليات تشغيل الرحلة قبله لا تحتوي على أحداث خطوات. سجل داخلي للرحلة: لا يُحتسب أبدًا كنشاط للشخص نفسه ولا يُحاسَب عليه أبدًا.

الحدث	الوصف	الإشارة
`canvas.step.entered`	وصل الشخص إلى خطوة في الرحلة (المشغّل، التأخير، التفرع، التجربة، الرسالة - أي عقدة). حدث واحد لكل زيارة؛ الرسالة المؤجلة بسبب ساعات الهدوء أو حد المعدل ثم أعيدت محاولتها هي الزيارة نفسها. الخصائص: `canvasId` و`canvasVersion` و`nodeId` و`nodeType` و`executionId`.	-
`canvas.step.left`	غادر الشخص خطوة في الرحلة. `outcome` هو ما قررته الخطوة - اسم الفرع، أو معرّف مسار التجربة (أو `no_winner` عندما تنتهي التجربة بلا فائز وتحرر مجموعة الانتظار الخاصة بها - فتنتهي الرحلة عندها كـ `completed`)، أو `success` / `on_error` لـ webhook، أو `did` / `timed_out` / اسم مجموعة لتقسيم السلوك، أو `issued` / `not_issued`، أو `sent` / `skipped`، أو `elapsed` للتأخير، وإلا `next`. `nextNodeId` هو المكان الذي انتقل إليه؛ ويكون فارغًا عندما تنتهي الرحلة عند هذه الخطوة، وعندها يوضح `exitReason` السبب (`completed` أو `exited` أو `exit_criteria` أو `restart` أو `error`). `durationMs` هو الوقت الذي قضاه في الخطوة.	-

التوصيات

الحدث	المعنى	الإشارة
`recommendation.served`	عالج نموذج توصيات عناصر لهذا المستخدم في رسالة أُرسلت (الخصائص: `modelId` و`itemIds`).	انطباع تخصيص

صفحات الهبوط

الحدث	المعنى	الإشارة
`Landing Page Viewed`	شخص معروف (وصل عبر رابط من Joryio يحمل رمزه) فتح صفحة هبوط منشورة (الخصائص: `pageId` و`pageSlug` و`pageName` و`referrer` وقيم UTM).	اهتمام
`Landing Page Form Submitted`	أُرسل نموذج صفحة هبوط وكُتب إلى هذا الشخص: سمات واشتراكات في القوائم ووسوم (الخصائص: `pageId` و`pageSlug` و`pageName` و`fields` و`listsSubscribed` و`referrer` وقيم UTM، و`email` و`phone` و`phoneUpdated` من النموذج - انظر `Form Submitted`).	تحويل

نماذج الموقع

الحدث	المعنى	الإشارة
`Form Submitted`	أُرسل نموذج على موقعك الخاص وكُتب إلى هذا الشخص: نموذج Contact Form 7 أو Elementor Pro على ووردبريس (عبر إضافة Joryio)، أو نموذج الاتصال أو نموذج مربوط آخر على PrestaShop (عبر وحدة Joryio). يُسجَّل سواء وافق الشخص على التسويق أم لا (الخصائص: `source` - `cf7` أو `elementor` أو `prestashop_contact` أو `prestashop_form`، و`formId` و`formName` و`pageUrl` و`consentGiven` و`consentText` (صياغة مربع الموافقة الذي حدّده الشخص، عندما يرسلها النموذج) و`listsSubscribed`، و`listsPending` للقوائم ذات التأكيد المزدوج التي تنتظر التأكيد، و`email` و`phone` الخاصين بالنموذج، بالتنسيق الذي تخزّنهما به جهة الاتصال، مع `phoneUpdated` عندما يختلف هاتف النموذج عن هاتف جهة الاتصال: `true` عندما تحمله جهة الاتصال الآن، و`false` عندما احتفظت جهة الاتصال بهاتفها). نموذج الزائر يملأ فقط بريدًا أو هاتفًا فارغًا؛ ونموذج عميل المتجر المسجَّل دخوله يمكنه تحديث هاتفه. `email` و`phone` بيانات شخصية: مخفيان عن أعضاء الفريق غير المسموح لهم برؤية البيانات الشخصية ويُمحيان مع الشخص. باقي القيم المُدخلة في النموذج لا تُحفظ في الحدث.	تحويل

الرسائل​

بطاقات Wallet​

التجارة الإلكترونية​

SDK / الويب​

الرسائل داخل التطبيق​

الرحلات​

التوصيات​

صفحات الهبوط​

نماذج الموقع​