تكامل Shopify

اربط متجر Shopify لمزامنة المنتجات والطلبات والعملاء والسلات المتروكة تلقائيًا. فعّل تقسيم العملاء القوي وحملات استرداد السلات المتروكة.

الميزات

• مزامنة تلقائية - تتزامن المنتجات والطلبات والعملاء في الوقت الفعلي عبر webhooks
• استرداد السلات المتروكة - حفظ روابط الدفع لاستخدامها في حملات الاسترداد
• تتبع المتجر وصفحة الدفع - يتتبع بكسل Joryio مشاهدات الصفحات والمنتجات والمجموعات وعمليات البحث والسلة وكل خطوة في صفحة الدفع، دون أي كود في القالب
• رسائل داخل الموقع - يعرض app embed الخاص بـ Joryio رسائل Joryio داخل متجرك
• التقاط البريد الإلكتروني - التعرف على المتسوقين من صفحة الدفع وحسابهم في المتجر ونماذج المتجر
• إسناد UTM - التقاط معاملات UTM التسويقية وإسنادها
• دعم متاجر متعددة - ربط عدة متاجر Shopify مع تقسيم الأحداث حسب المتجر

ربط متجرك

تثبّت Joryio من Shopify، ثم تربط المتجر بمساحة عملك في Joryio من داخل لوحة إدارة Shopify. تحتاج إلى حساب Joryio - يُنشئ فريق Joryio الحسابات (احجز عرضًا توضيحيًا).

1. ثبّت Joryio من Shopify: من رابط التثبيت الذي أرسله إليك Joryio، أو بالنقر على تثبيت Joryio من Shopify في صفحة Shopify في Joryio (الإعدادات → التكاملات → Shopify). يعرض Shopify الأذونات التي يطلبها Joryio - المنتجات والطلبات والعملاء وعمليات الدفع والخصومات (للقسائم)، وكذلك customer events وpixels (read_customer_events، write_pixels) اللذين يضيفان بكسل Joryio إلى متجرك - وتوافق عليها في Shopify
2. يفتح Shopify تطبيق Joryio داخل لوحة إدارة Shopify. يعرض المتجر غير المرتبط بعد هذا المتجر غير مرتبط بحساب Joryio بعد
3. انقر على لدي حساب - تسجيل الدخول. يُفتح Joryio في علامة تبويب جديدة
4. سجّل الدخول إلى Joryio. إذا طلب Joryio حسابك في Joryio، فأدخل اسم الحساب من عنوان تسجيل الدخول الخاص بك (.../a/your-account)
5. في صفحة ربط متجر Shopify اختر مساحة العمل لهذا المتجر وانقر على ربط المتجر بمساحة العمل هذه. مساحة العمل التي لا يمكنك إدارة التكاملات فيها، أو التي يرتبط بها متجر Shopify آخر، تظهر مع السبب لكن لا يمكن اختيارها
6. عد إلى علامة تبويب لوحة إدارة Shopify. خلال ثوانٍ تسأل ربط هذا المتجر بـ Joryio؟ وتعرض اسم مساحة العمل واسم الحساب. تحقّق منهما وانقر على ربط المتجر
7. تعرض الصفحة الاتصال. يستورد Joryio منتجاتك وطلباتك وعملاءك، ويشترك في تحديثات Shopify، ويضيف البكسل تلقائيًا
8. فعّل النوافذ المنبثقة: انقر على تفعيل Joryio في قالبك، ثم اضغط حفظ في Shopify - راجع تفعيل النوافذ المنبثقة

لا يستطيع إكمال الربط إلا عضو فريق Shopify الذي بدأه، ولا يُربط شيء حتى ينقر ربط المتجر. ينتهي الرابط الذي لا يُستخدم خلال 15 دقيقة: ابدأ من جديد من صفحة Joryio في لوحة إدارة Shopify.

لا يطلب منك Joryio أبدًا كتابة عنوان متجرك. إذا فتحت صفحة Shopify في Joryio قبل تثبيت Joryio في متجرك، فستظهر تثبيت Joryio من Shopify - ثبّته من هناك ثم تابع من الخطوة 2. هل ثبّته بالفعل؟ افتح Joryio من Apps في لوحة إدارة Shopify وانقر على لدي حساب - تسجيل الدخول.

أين تُخزَّن بيانات متجرك

تُخزَّن بيانات متجرك في منطقة Joryio نفسها التي يوجد فيها حسابك - المنطقة التي أُنشئ فيها الحساب. لا تختار منطقة عند التثبيت أبدًا: تسجيل الدخول هو ما يحددها، فلا يمكن أن ينتهي المتجر في منطقة غير منطقة حسابه. لا يُخزَّن أي شيء عن المتجر في أي مكان قبل أن تربطه.

فتح Joryio من Shopify

افتح Joryio من Apps في لوحة إدارة Shopify في أي وقت. داخل لوحة الإدارة يعرض:

• الاتصال وآخر مزامنة - الحالة نفسها التي تعرضها صفحة Shopify في Joryio
• بكسل Joryio والنوافذ المنبثقة في متجرك، مع تفعيل Joryio في قالبك ما دامت النوافذ المنبثقة غير مفعّلة
• فتح Joryio - صفحة Shopify في Joryio، في علامة تبويب جديدة

يعرض المتجر الذي فُصل إعادة الربط - تسجيل الدخول، الذي يشغّل خطوات الربط نفسها.

المتاجر المتصلة قبل أن يُفتح Joryio داخل Shopify

يبقى المتجر الذي رُبط سابقًا من Joryio (بإدخال نطاق المتجر) متصلًا: تستمر المنتجات والطلبات والتحديثات الفورية والبكسل في العمل. في أول مرة يفتح فيها أحدٌ Joryio من Apps في لوحة إدارة Shopify للمتجر، يجدّد Joryio وصوله إلى المتجر في الخلفية - إذ يشترط Shopify هذا النوع من الوصول لكل تطبيق ابتداءً من 1 يناير 2027. لا يتغير شيء آخر ولا يوجد ما توافق عليه في Joryio. افتح Joryio من Shopify مرة واحدة قبل هذا التاريخ.

إعدادات المزامنة

بعد الربط، اضبط البيانات التي تريد مزامنتها:

الإعداد	الوصف	الافتراضي
مزامنة المنتجات	استيراد المنتجات من Shopify	مفعّل
مزامنة الطلبات	استيراد الطلبات وتحديث الحالات	مفعّل
مزامنة العملاء	استيراد بيانات العملاء	مفعّل
مزامنة السلات	تتبع عمليات إتمام الشراء المتروكة	مفعّل
الأيام التاريخية	أيام سجل الطلبات المراد استيراده	60 (90 عندما يمنح المتجر الوصول إلى جميع الطلبات)

يعيد Shopify طلبات آخر 60 يومًا فقط ما لم يمنح المتجر Joryio الوصول إلى جميع الطلبات. وحتى ذلك الحين تُختصر الفترة الأطول إلى 60 يومًا، وتوضح علامة تبويب الإعدادات ذلك.

يمكنك الوصول إليها في الإعدادات → التكاملات → Shopify → علامة الإعدادات.

تتبع واجهة المتجر

عند ربط المتجر يضيف Joryio بكسل Joryio إليه - لا يوجد ما تثبّته. يشغّل Shopify البكسل في كل صفحات المتجر وداخل صفحة الدفع، لذلك تُتتبع خطوات الدفع أيضًا. يمكنك رؤيته في لوحة إدارة Shopify ضمن Settings → Customer events. يُخزَّن كل حدث باسمه القياسي (عمود يُخزَّن باسم) - وهو الاسم نفسه الذي تستخدمه تكاملات WooCommerce وMagento وحزم SDK:

الحدث	يُخزَّن باسم	متى يُرسل
مشاهدة صفحة	Page Viewed	كل زيارة لصفحة، بما في ذلك صفحات الدفع
مشاهدة منتج	Product Viewed	صفحة منتج، مع النوع المعروض وسعره وحالة المخزون: in_stock (true أو false) وstock_status (in_stock أو out_of_stock)
مشاهدة مجموعة	Product List Viewed	صفحة مجموعة، مع category_id (معرّف المجموعة) وcategory_name
بحث	Products Searched	بحث في المتجر، مع كلمات البحث في query
إضافة إلى السلة	Product Added	كل إضافة إلى السلة، مع الكمية
إزالة من السلة	Product Removed	منتج أُزيل من السلة
مشاهدة السلة	Cart Viewed	صفحة السلة، مع إجمالي السلة والعناصر
بدء الدفع	Checkout Started	يدخل المتسوق صفحة الدفع، مع الإجمالي والعناصر
خطوة في الدفع	Checkout Step Completed	يُكمل المتسوق خطوة في الدفع: قيمة step هي contact أو address أو shipping
بيانات الدفع	Payment Info Entered	يرسل المتسوق بيانات الدفع
التعريف	$identify	البريد الإلكتروني للمتسوق، من صفحة الدفع أو حساب مسجَّل الدخول في المتجر أو نموذج في المتجر

تحمل أحداث المنتجات product_id وvariant_id وquantity وprice وcurrency. الطلبات ليست حدثًا من البكسل: يصل كل طلب مرة واحدة عبر webhooks الطلبات في Shopify ويُخزَّن باسم Order Completed، لذلك لا تُحتسب الإيرادات مرتين أبدًا.

الرسائل داخل الموقع والتسجيلات: app embed

بعض الميزات يجب أن تعمل داخل صفحة المتجر نفسها، وهذا ما لا يستطيعه البكسل. يحمّل app embed الخاص بـ Joryio حزمة Joryio للويب في متجرك بحيث:

• تظهر رسائل Joryio داخل الموقع (in-app) في متجرك
• يُتعرَّف على المتسوق المسجّل دخوله إلى حسابه في المتجر، وينضم تصفّحه وسلّته ورسائل الموقع من قبل تسجيل الدخول إلى جهة اتصاله. يعتمد Joryio فقط على تأكيد Shopify نفسه بأن المتسوق مسجّل الدخول
• يعرّف أي بريد إلكتروني يُكتب في نموذج داخل المتجر (النشرة البريدية، التواصل، الحساب) المتسوقَ. البريد الإلكتروني المكتوب لا يضم الزائر أبدًا إلى جهة اتصال موجودة - يمكن لأي شخص كتابة عنوان شخص آخر

في Shopify وحده صاحب المتجر يستطيع تفعيل app embed - راجع تفعيل النوافذ المنبثقة. يمكنك من إعدادات embed إيقاف الرسائل داخل الموقع أو التقاط البريد الإلكتروني من النماذج.

تفعيل النوافذ المنبثقة

تظهر النوافذ المنبثقة من Joryio (رسائل in-app) في متجرك فقط بعد تفعيل app embed الخاص بـ Joryio في قالبك. في Shopify وحده صاحب المتجر يستطيع تفعيله:

1. في التكاملات → Shopify → الاتصال ابحث عن النوافذ المنبثقة في متجرك
2. انقر على تفعيل Joryio في قالبك. يفتح Shopify محرر القالب مع تفعيل Joryio مسبقًا ضمن App embeds
3. اضغط حفظ

يدويًا: في Shopify انتقل إلى Online Store → Themes → Customize → App embeds، وفعّل Joryio واضغط حفظ. يتم ذلك مرة واحدة لكل قالب تنشره.

تعرض الشارة بجانب النوافذ المنبثقة في متجرك القيمة مفعّل بعد أن يحمّل متجرك Joryio لأي زائر خلال آخر 7 أيام، وغير مفعّل بعد حتى ذلك الحين - لذلك قد تلزم زيارة واحدة لمتجرك بعد الحفظ. وما دامت تعرض مفعّل يحل محل الزر رابط صغير فتح محرر القالب.

إعدادات رسائل in-app

يحمّل الـ embed حزمة SDK من https://sdk.joryio.com/web/1/joryio.min.js (أحدث إصدار من 1.x، وهو الملف نفسه الذي تحمّله إضافة WooCommerce وامتداد Magento)؛ تذهب طلبات البيانات الخاصة بها إلى خادم Joryio الخاص بمتجرك. في محرر القالب، لـ embed الخاص بـ Joryio هذه الإعدادات:

الإعداد	الافتراضي	ماذا يفعل
In-app messages	مفعّل	يعرض رسائل in-app من Joryio في المتجر
Allow HTML in-app messages	مفعّل	يعرض أيضًا الرسائل المبنية بمحرر HTML. تُعرض داخل إطار محمي في متجرك: لا تعمل السكربتات المكتوبة فيها، ولا تستطيع الرسالة الوصول إلى صفحات متجرك أو إرسال طلبات شبكة خاصة بها

لا يُحتسب شيء مرتين: تتشارك حزمة SDK مع البكسل معرّف الزائر المجهول ولا ترسل مشاهدات صفحات أو بدايات جلسات خاصة بها - أحداث الصفحات والسلة تأتي من البكسل.

إشعارات Web Push غير متاحة في Shopify

تحتاج إشعارات المتصفح إلى service worker يُقدَّم من عنوان المتجر نفسه في جذره (/joryio-sw.js). لا يسمح Shopify لأي تطبيق بوضع ملف هناك: ملفات app embed تُقدَّم من شبكة CDN الخاصة بـ Shopify، وهي عنوان آخر، وخوادم app proxy لا تجيب إلا تحت /apps/... (أو /a أو /community أو /tools) وتزيل الترويسة التي كانت ستسمح للـ worker بتغطية المتجر كله. لذلك لا يوجد في الـ embed مفتاح لـ Web Push. يعمل Web Push في متاجر WooCommerce وMagento.

الخصوصية والموافقة

يتبع البكسل وapp embed شريط ملفات تعريف الارتباط في متجرك (إعدادات Customer Privacy في Shopify). يعملان فقط للزوار الذين سمحوا بكل من analytics وmarketing، ويتوقفان عن الإرسال عندما يسحب الزائر موافقته. في المناطق التي لا يطلب فيها متجرك الموافقة، يعملان لكل الزوار.

لا يشارك Shopify البريد الإلكتروني للمتسوق مع بكسلات التطبيقات إلا عند اعتماد التطبيق لبيانات العملاء المحمية. وإلى ذلك الحين تصل رسائل البريد من صفحة الدفع إلى Joryio عبر webhooks الدفع والطلبات وليس عبر البكسل.

المتاجر المتصلة قبل أكتوبر 2026

أُعدّت هذه المتاجر بسكربت تتبع سيتوقف Shopify عن تحميله في 1 مارس 2027، ولم يعمل قط داخل صفحة الدفع. يستمر في العمل إلى أن تنتقل:

1. في التكاملات → Shopify → الاتصال انقر على الموافقة على الأذونات الجديدة
2. وافق في Shopify على إذني customer events وpixels الجديدين
3. عند العودة إلى Joryio يُضاف البكسل ويتوقف السكربت القديم تلقائيًا عن إرسال الأحداث، فلا يُحتسب شيء مرتين
4. انقر على تفعيل Joryio في قالبك لتفعيل app embed

إذا طلب منك Shopify الموافقة على أذونات جديدة عند فتح Joryio من Apps في لوحة إدارة Shopify، فوافق عليها هناك بدلًا من ذلك - يضيف Joryio عندها البكسل ويوقف السكربت القديم.

يبقى السكربت القديم نفسه مسجلًا في متجرك إلى أن يزيله Shopify: يحذفه Shopify عند إلغاء تثبيت التطبيق، ويتوقف عن تحميله في 1 مارس 2027. لا يحذفه Joryio - بل يوقف فقط إرسال الأحداث منه.

إسناد UTM

تُلتقط معاملات التسويق تلقائيًا:

• utm_source وutm_medium وutm_campaign
• utm_term وutm_content

تُحفظ معاملات UTM طوال الزيارة وتُرفق بأحداثها.

دعم متاجر متعددة

عند ربط عدة متاجر Shopify بمساحة العمل نفسها:

1. يحصل كل متجر على كيان تطبيق خاص به ومفتاح SDK فريد.
2. تُعلم كل الأحداث بـ $app_id للمتجر.
3. صفِّ الأحداث حسب $platform = 'shopify' أو $app_id محدد.
4. يمكن ربط المستخدمين بين المتاجر عبر Email.

التعرّف على الزوار من البريد الإلكتروني الذي يكتبونه

يُضبط Recognise visitors by the email they type في Joryio، ضمن التكاملات → Shopify → الإعدادات. يكون مفعّلًا افتراضيًا.

• مفعّل (افتراضي) - البريد الإلكتروني الذي يكتبه الزائر عند الدفع أو في نموذج يعرّف متصفحه على أنه جهة الاتصال صاحبة هذا البريد: جهة الاتصال الموجودة (الأحدث نشاطًا، عندما تشترك عدة جهات اتصال في البريد - انظر أدناه) أو جهة اتصال جديدة. يُضم تصفح الزائر السابق إلى جهة الاتصال هذه، ولا تُنشأ جهة اتصال ثانية بالبريد نفسه. هذا ما تتوقعه معظم المتاجر. المقابل: من يكتب بريد شخص آخر يُتعرَّف عليه كذلك الشخص في هذا المتصفح - فقد يرى مثلًا رسائل in-app والمحتوى المخصّص لذلك الشخص.
• معطّل (هوية صارمة) - البريد المكتوب لا يعرّف المتصفح أبدًا. يصل بريد الضيف إلى Joryio مع الطلب، ويذهب الطلب إلى جهة الاتصال صاحبة هذا البريد. لا يُتعرَّف في المتصفح إلا على عميل مسجّل الدخول إلى المتجر.

يسري التغيير خلال دقائق.

بريد مصحَّح. عندما يصحح الزائر بريدًا كُتب بخطأ، يُزال العنوان الخاطئ من متصفحه مرة أخرى ويُطابَق العنوان المصحَّح مثل أي عنوان آخر، فينتقل الزائر إلى جهة الاتصال الصحيحة. يرسل Shopify السلة مع كل تحديث لصفحة الدفع، لذا تتبع السلة البريد بالفعل. لا يُزال العنوان المكتوب إلا ما دام لا شيء آخر في جهة الاتصال يدل على شخص: الطلب أو رقم الهاتف أو اختيار الموافقة أو حساب في المتجر أو عنوان كُتب قبل أكثر من يوم يُبقيه.

عندما تشترك عدة جهات اتصال في بريد إلكتروني

قد يخص البريد الإلكتروني أكثر من جهة اتصال واحدة في Joryio (مثل زوجين، أو شخص واحد استُورد مرتين). عندما يطابق البريد الذي يكتبه الزائر عند الدفع عدة جهات اتصال، تذهب السلة وعملية الدفع والطلب إلى جهة الاتصال الأحدث نشاطًا - وهي القاعدة نفسها التي يستخدمها الاستيراد وواجهة API والنماذج، فلا يتوزع سجل الشخص الواحد بين جهتي اتصال. وبمجرد أن تختار عملية الدفع جهة اتصال، تبقى معها: تحديثات السلة اللاحقة والموافقة والسلة المتروكة والطلب وتحديثات حالته تذهب كلها إلى جهة الاتصال نفسها، حتى لو تغيّرت جهة الاتصال الأخرى في الأثناء. العميل المسجّل دخوله في المتجر يذهب دائمًا إلى جهة الاتصال التي تحمل حساب العميل الخاص به في المتجر. لا تُدمج جهات الاتصال أبدًا، ويظل إلغاء الاشتراك ساريًا على كل جهات الاتصال التي تحمل هذا البريد.

كيف تحدّث بيانات المتجر جهة الاتصال

تحدّث الطلبات وعمليات الدفع وتحديثات العملاء من متجرك جهة الاتصال المطابقة في Joryio:

• الهاتف - الطلبات وعمليات الدفع: الهاتف الذي يكتبه المتسوق عند الدفع لا يستبدل أبدًا الهاتف الحالي لجهة الاتصال، حتى عندما يربط Shopify الطلب بعميل - إذ يُلحق Shopify الدفع كضيف بالعميل الحالي صاحب البريد الإلكتروني المكتوب، فلا يثبت الربط هوية المتسوق. بل يملأ الهاتف فقط عندما لا يكون لجهة الاتصال هاتف.
• الهاتف - سجل العميل في Shopify: تحديثات العملاء من Shopify (واستيراد العملاء) تحدّث هاتف جهة الاتصال.
• الأسماء تأتي من سجل العميل في Shopify.
• رقم العميل في المتجر: يأتي رقم عميل Shopify لجهة الاتصال من سجل العميل في Shopify (تحديثات العملاء واستيراد العملاء)، وليس أبدًا من طلب أو عملية دفع. وعندما يحمل سجل العميل بريدًا إلكترونيًا مختلفًا، ينتقل الرقم إلى جهة الاتصال صاحبة ذلك البريد.
• يحتفظ الطلب بالهاتف المكتوب عند الدفع في عنوان الفوترة والشحن الخاص به، مهما حدث لجهة الاتصال.
• موافقة SMS المقدَّمة عند الدفع برقم مختلف عن رقم جهة الاتصال لا تؤدي إلى اشتراك رقم جهة الاتصال.
• طرق أخرى لتغيير هاتف جهة الاتصال: حساب العميل في المتجر، أو الـ SDK أو الـ API من موقعك أو تطبيقك (مثلًا بعد تسجيل دخول الشخص)، أو الاستيراد، أو تعديل جهة الاتصال في Joryio.

Webhooks

يسجل التكامل تلقائيًا Webhooks للتحديثات اللحظية:

• إنشاء الطلب وتحديثه وإلغاؤه وتنفيذه
• إنشاء إتمام الشراء وتحديثه (السلات المتروكة)
• إنشاء المنتج وتحديثه وحذفه
• إنشاء العميل وتحديثه

اعرض Webhooks المسجلة في الإعدادات → التكاملات → Shopify → علامة Webhooks.

المطابقة المجدولة

قد تضيع التحديثات المباشرة (الـ webhooks) - مثلًا عندما يكون المتجر غير متاح، أو عندما يفشل التسليم مرات كثيرة. كل 6 ساعات يفحص Joryio المتجر بحثًا عمّا تغيّر منذ الفحص السابق، ويضيف ما فاتته التحديثات المباشرة: الطلبات (مع الاستردادات والإلغاءات)، والعملاء، والمنتجات، وعمليات الدفع المتروكة خلال آخر 24 ساعة.

لا يُحتسب أي شيء مرتين: العنصر الموجود لدى Joryio بالإصدار نفسه أو بإصدار أحدث يبقى كما هو، والنسخة الأقدم لا تحل أبدًا محل نسخة أحدث.

• الطلب المفقود الذي تم خلال آخر 24 ساعة يُسجَّل كما لو وصل مباشرة، فتبدأ مسارات ما بعد الشراء كالمعتاد. أما الطلب المفقود الأقدم، والاسترداد أو الإلغاء لطلب كان Joryio يعرفه، فيُسجَّلان دون بدء مسارات؛ ويُسجَّل كل من Order Refunded وOrder Cancelled مرة واحدة فقط.
• يُفحص كل متجر في وقته الخاص، فلا تُقرأ المتاجر كلها دفعة واحدة، ويقرأ الفحص الواحد عددًا محدودًا من التغييرات؛ والمتجر الذي لديه تغييرات أكثر يُستكمل خلال نصف ساعة.
• تُتخطى المتاجر غير المتصلة أو التي بها خطأ أو التي ما زالت قيد المزامنة حتى تتصل من جديد.

تظهر النتيجة في الإعدادات → التكاملات → Shopify: آخر مطابقة: 22/10/2026 12:00 - العناصر التي تمت إضافتها: 3. إذا استمرت الفحوص في العثور على تغييرات لم تصل مباشرة، يُطلق Joryio تنبيه Live updates from Shopify may be failing (الجرس، والسجلات والمراقبة، وبريد إلى مسؤولي مساحة العمل). تُضاف البيانات المفقودة في جميع الأحوال، لكن تحقق من اتصال المتجر: المسارات التي تتفاعل مع هذه التغييرات تبدأ متأخرة.

تعرض الصفحة نفسها آخر حدث مستلم - متى وصل آخر تحديث مباشر من المتجر إلى Joryio (بتأخير دقيقة واحدة على الأكثر) - وآخر مزامنة، وهي الأحدث بين آخر مزامنة كاملة وآخر مطابقة. في المتجر الذي يرسل تحديثات مباشرة يتقدم آخر حدث مستلم حتى عندما لا تعمل أي مزامنة.

الاستردادات والإلغاءات

يصبح كل استرداد في Shopify حدث Order Refunded واحدًا (بالمبلغ المسترد والبنود والملاحظة)، وكل إلغاء حدث Order Cancelled واحدًا، لكي تتمكن الرحلة من التفاعل معهما. راجع أحداث الاسترداد والإلغاء.

طلبات الخصوصية من Shopify

يمرّر Shopify طلبات الخصوصية من عملائه إلى كل تطبيق يستخدمه المتجر. يعالج Joryio كل طلب في كل مساحة عمل متصلة بالمتجر، ويُعلم المالكين والمسؤولين والأعضاء الذين يمكنهم إدارة الإعدادات في مساحة العمل (بالبريد الإلكتروني وفي الجرس):

الطلب من Shopify	ما يفعله Joryio	ما تفعله أنت
طلب عميل بياناته	يجد جهة الاتصال بمعرّف العميل في Shopify أو ببريده الإلكتروني ويبدأ تصدير بيانات في صفحة طلبات أصحاب البيانات	عندما يصبح التصدير جاهزًا، نزّله وأرسله إلى العميل عبر Shopify خلال 30 يومًا. إذا لم يكن لدى Joryio أي بيانات عن العميل، يذكر الإشعار ذلك
طلب عميل محو بياناته	يبدأ محوًا لجهة الاتصال (الملف الشخصي والأحداث والرسائل؛ تحتفظ الطلبات بالمبالغ لكنها تفقد اسم العميل وعناوينه ومعرّف العميل في Shopify وملاحظة الطلب ورابط حالة الطلب ورقم التتبع والربط بجهة الاتصال) ويزيل البيانات الشخصية من الطلبات التي يذكرها Shopify	لا شيء
تم محو بيانات المتجر (بعد 48 ساعة من إلغاء تثبيت التطبيق)	يزيل اتصال المتجر - راجع إلغاء تثبيت Joryio من Shopify	لا شيء. إذا أعدت تثبيت التطبيق خلال الـ 48 ساعة، يُبقي Joryio المتجر متصلًا

إلغاء تثبيت Joryio من Shopify

عند إلغاء التثبيت، يتوقف Joryio عن تلقي بيانات Shopify ويزيل الاتصال. تبقى جهات اتصالك وسجل طلباتك في مساحة العمل الخاصة بك في Joryio حتى تحذفها أو يطلب عميل محو بياناته؛ وتُؤرشف المنتجات.

بالتفصيل، بعد 48 ساعة من إلغاء التثبيت (عندما يطلب Shopify من Joryio إزالة بيانات المتجر):

• يُزال: اتصال المتجر وصلاحية الوصول الخاصة به، والسلات المتروكة وعمليات إتمام الشراء من المتجر.
• يُحتفظ به: جهات الاتصال، والطلبات - التي تبقى مرتبطة بجهات اتصالها ومعلَّمة بأنها من متجر تم فصله - حتى تستمر القيمة الدائمة للعميل وRFM والشرائح والإسناد في العمل، مثلًا إذا انتقلت إلى WooCommerce أو Magento.
• يُؤرشف: منتجات المتجر. تظل الطلبات السابقة تعرض ما تم شراؤه؛ ولا تُقترح المنتجات المؤرشفة أبدًا، ولا تُعرض في اختيارات المنتجات، ولا تُستخدم في رسائل العودة إلى المخزون أو انخفاض السعر.

التثبيت من جديد: ثبّت Joryio من رابط التثبيت وافتحه من Apps. تعرض الصفحة خطوات الربط مرة أخرى - راجع ربط متجرك. اربط المتجر بمساحة العمل التي كان فيها من قبل، لتبقى جهات الاتصال وسجل الطلبات معًا.

صحة الاتصال

بعد ربط Shopify، تكون لوحة الصحة (في التكاملات → Shopify → الاتصال) أول ما تفحصه إذا توقفت بيانات المتجر عن المزامنة:

• تفاصيل المتجر - الاسم الحي والخطة والعملة والنطاق المسحوبة من Shopify. ظهورها يؤكد استمرار عمل رمز الوصول.
• حالة Webhook - في علامة Webhooks، يظهر كل موضوع مطلوب بوصفه مسجلاً أو مفقودًا. يعيد زر إعادة التسجيل إنشاء أي Webhooks مفقودة لاستئناف التحديثات اللحظية.
• التتبع في المتجر - هل بكسل Joryio نشط، مع الموافقة على الأذونات الجديدة أو إعادة تسجيل التتبع عندما لا يكون نشطًا، وزر تفعيل Joryio في قالبك الخاص بـ app embed. راجع تتبع واجهة المتجر.

إذا انحرفت البيانات، أعد تسجيل Webhooks المفقودة في علامة Webhooks، ثم شغّل مزامنة الكل يدويًا لإعادة الملء.

الموافقة على التسويق

يقرأ Joryio الموافقة على التسويق التي يحتفظ بها Shopify لكل عميل - موافقة البريد الإلكتروني وSMS التي يجمعها متجرك عند الدفع وفي النماذج وفي لوحة إدارة Shopify - ويطبّقها على اشتراك جهة الاتصال في Joryio:

في Shopify	في Joryio
Subscribed (بريد إلكتروني أو SMS)	تُشترك جهة الاتصال في تلك القناة. من ألغى اشتراكه لا يُعاد اشتراكه - راجع الجدول أدناه؛ ويمكنه إعادة الاشتراك بنفسه من مركز التفضيلات.
Unsubscribed	يُلغى اشتراك جهة الاتصال في تلك القناة - ما لم يسجّل Joryio تغييرًا أحدث لها (مثلًا، اشتركت عبر نموذج Joryio بعد إلغاء الاشتراك في Shopify).
Not subscribed أو pending (اشتراك مزدوج ما زال ينتظر التأكيد) أو بلا موافقة	لا تغيير.

• ينطبق ذلك على الاستيراد التاريخي، وعلى كل تحديث للعميل والطلب، وعلى إشعارات Shopify المخصّصة لتغيير الموافقة.
• في طلب لا يحمل عميله أي موافقة، يُحتسب مربع التسويق عند الدفع: التحديد يشترك، والمربع غير المحدد لا يغيّر شيئًا.
• يُسجَّل كل تغيير في سجل اشتراك جهة الاتصال مع المصدر (shopify_customer أو shopify_checkout) ومستوى الموافقة في Shopify (فردية أو مؤكدة) ووقت تسجيل Shopify للتغيير.
• تغيير الموافقة الذي يصل مع طلب جديد أو محدَّث يسجّل أيضًا عنوان IP للمتسوق الذي حفظه Shopify في الطلب (عنوان IP للمتصفح)، ويظهر فقط لأعضاء الفريق المسموح لهم برؤية البيانات الشخصية. الاستيراد التاريخي وإشعارات موافقة العملاء من Shopify لا تحمل عنوان IP - لا يوفّره Shopify.
• العنوان الموجود في قائمة الحظر (ارتداد، أو إلغاء اشتراك مسجّل على جهة اتصال أخرى) لا يُشترك.
• لا يكتب Joryio الموافقة إلى Shopify: إلغاء الاشتراك في Joryio لا يغيّر قائمة عملائك في Shopify.

ما تفعله موافقة المتجر أو إلغاؤه

ما يرسله المتجر	ما يفعله Joryio
تحديد موافقة عند الدفع كـضيف	يشترك جهة اتصال ليس لها اشتراك في تلك القناة بعد. ما لم يكن إعداد المتجر أدناه مفعّلًا، لا يعيد أبدًا اشتراك من ألغى اشتراكه - فعند الدفع كضيف يمكن لأي شخص كتابة أي بريد إلكتروني.
أي موافقة أخرى من Shopify، بما فيها موافقة عميل له حساب في المتجر	مثل تحديد الضيف: ما لم يكن الإعداد أدناه مفعّلًا، لا تعيد أبدًا اشتراك من ألغى اشتراكه. يربط Shopify الدفع كضيف بالعميل الموجود الذي له البريد الإلكتروني نفسه ولا يخبر Joryio ما إذا كان المشتري مسجّل الدخول، لذا لا يستطيع Joryio التمييز بين صاحب الحساب ومن كتب بريده الإلكتروني. (WooCommerce وMagento يخبران بذلك - راجع صفحتيهما.)
موافقة عند الدفع أو في سجل العميل، مع تفعيل السماح لموافقات الدفع بإعادة اشتراك من ألغوا اشتراكهم (معطّل افتراضيًا)	يعيد اشتراك جهة اتصال ألغت اشتراكها - حتى بعد الدفع كضيف - عندما يكون وقت الموافقة لدى المتجر بعد آخر إلغاء اشتراك لها. الخطر: لا يخبر Shopify Joryio ما إذا كان المشتري مسجّل الدخول، لذا يمكن لمن يكتب بريد شخص آخر عند الدفع أن يعيد اشتراكه؛ ويمكنه دائمًا إلغاء الاشتراك مجددًا بنقرة واحدة. تبقى الحالات أدناه التي لا تُلغى أبدًا سارية.
مربع غير محدد	لا تغيير - لا يُعد أبدًا إلغاءً للاشتراك.
إلغاء في المتجر	يلغي الاشتراك، إلا إذا سجّل Joryio تغييرًا لاحقًا لجهة الاتصال هذه.
ما لا تلغيه أبدًا أي موافقة من المتجر، سواء كان الإعداد مفعّلًا أو معطّلًا	شكوى البريد العشوائي، والارتداد الدائم، والحظر على مستوى المؤسسة، ومساحة عمل أخرى، وإلغاء اشتراك مسجّل على جهة اتصال أخرى بالبريد أو الهاتف نفسه، وSTOP في SMS.

• الإعداد موجود في التكاملات → Shopify → الإعدادات، واحد لكل اتصال متجر، معطّل افتراضيًا. يمكن للمسؤولين فقط تغييره، ويُسجَّل كل تغيير في سجل التدقيق.
• موافقة المتجر تشترك في القناة لا في قائمة: القائمة التي تتطلب التأكيد المزدوج ترسل رسالة التأكيد عند انضمام الشخص إليها.

المتاجر المتصلة قبل أكتوبر 2026

تُسجَّل إشعارات تغيير الموافقة عند Sync All أو Re-register التالي. وحتى ذلك الحين تظل الموافقة تصل مع كل تحديث للعميل والطلب.

استرداد السلات المتروكة

عندما يترك العميل سلته:

1. يُلتقط عنوان URL لإتمام الشراء.
2. تُخزن قيمة السلة وعناصرها.
3. يُربط Email العميل، إذا التُقط.

استخدم هذه البيانات لإنشاء حملات استرداد السلات المتروكة في Canvas مع عنوان URL الفعلي لإتمام الشراء.

استكشاف الأخطاء وإصلاحها

المنتجات/الطلبات لا تتزامن

• تحقق من تفعيل المزامنة في تبويب الإعدادات.
• تأكد من تسجيل webhooks في تبويب Webhooks.
• جرّب المزامنة اليدوية عبر زر "مزامنة الكل".

"Shopify has not approved this app's access to protected customer data"

• لا يعطي Shopify بيانات العملاء (العملاء، وتفاصيل العميل في الطلبات) إلا للتطبيقات الموافق عليها لبيانات العملاء المحمية. وحتى ذلك الحين يرفض Shopify هذه القراءات، ويذكر Last Error في صفحة التكامل الكائن الذي رُفض
• يطلب مطوّر التطبيق الموافقة من Shopify Dev Dashboard (أو Partner Dashboard): التطبيق -> API access -> Protected customer data. بعد الموافقة انقر Sync All
• رفض كيان واحد لا يوقف البقية: تستمر مزامنة المنتجات والطلبات وعمليات الدفع المتروكة، وتُسجَّل الـ webhooks (الطلبات والسلال الفورية) قبل بدء المزامنة. تبقى الحالة Error حتى تنتهي مزامنة دون أخطاء، ويعرض Last Sync آخر مزامنة انتهت كذلك
• تعرض صفحة Joryio داخل لوحة إدارة Shopify الحالة نفسها مع سبب مختصر

البكسل غير نشط

• يظهر الموافقة على الأذونات الجديدة: لم يوافق المتجر بعد على أذونات البكسل - راجع المتاجر المتصلة قبل أكتوبر 2026.
• يظهر خطأ: انقر على إعادة تسجيل التتبع. إذا استمر، توضح رسالة Shopify السبب.
• تحقق في لوحة إدارة Shopify ضمن Settings → Customer events من أن بكسل Joryio يظهر متصلًا.

لا يتم التقاط البريد الإلكتروني

• تصل رسائل البريد من صفحة الدفع عبر webhooks الدفع والطلبات.
• تحتاج نماذج المتجر والحسابات المسجّل دخولها إلى تفعيل app embed - راجع app embed.
• الزائر الذي لم يسمح بـ analytics وmarketing لا يُتتبع.

مشكلات الاتصال

• تحقق من أن تطبيق Shopify لديه الأذونات المطلوبة.
• افتح Joryio من Apps في لوحة إدارة Shopify. يعرض المتجر الذي فُصل إعادة الربط - تسجيل الدخول، الذي يربطه من جديد - راجع فتح Joryio من Shopify.

مشاهدات المنتجات أو الإضافة إلى السلة مفقودة

• يعمل البكسل في قوالب Online Store وفي صفحة الدفع في Shopify. قد لا تشغّل الواجهة headless (مثل Hydrogen أو واجهة مخصصة أخرى) بكسلات التطبيقات، فأرسل الأحداث باستخدام Web SDK بدلًا من ذلك
• الزوار الذين رفضوا ملفات تعريف الارتباط الخاصة بـ analytics أو marketing لا يُتتبعون
• تقرأ مشاهدات المنتجات حالة المخزون من عنوان /products/<handle>.js في متجرك. إذا حظرت سمة أو تطبيق هذا العنوان، تصل مشاهدات المنتجات من دون حالة المخزون