استكشاف أخطاء محتوى Checkout Blocks وإصلاحها
قد لا يُعرض محتوى Checkout Blocks الخاص بك كما هو متوقع لأسباب مختلفة، مما يؤدي إلى اختفاء العناصر أو عدم عملها بشكل صحيح. تشمل المشكلات الشائعة عدم استيفاء قواعد العرض، أو سوء تهيئة الأذونات، أو وجود تعارض بين الإعدادات في المكوّن نفسه وكيفية إضافة المكوّن إلى محرر الدفع والحسابات.
يساعدك هذا الدليل على استكشاف أخطاء Checkout Blocks الشائعة وإصلاحها بنفسك. إذا كنت لا تزال تواجه مشكلات بعد مراجعة الخطوات في هذا الدليل، فبادر بالتواصل مع دعم Shopify للحصول على المساعدة.
في هذه الصفحة
استكشاف أخطاء المكوّنات وإصلاحها
المكوّنات هي عناصر التخصيص التي تعرض المحتوى في صفحة الدفع الخاصة بك، مثل الحقول المخصصة، والمحتوى الديناميكي، واللافتات. إذا كان المكوّن لا يعمل كما هو متوقع، فاستخدم الأقسام التالية لتحديد المشكلة وحلها.
المكوّن لا يُعرض في صفحة الدفع
استكشاف أخطاء عدم إضافة المكوّن إلى المحرر وإصلاحها
لا يؤدي إنشاء مكوّن في تطبيق Checkout Blocks إلى إضافته تلقائيًا إلى صفحة الدفع. بل ستحتاج إلى إضافة المكوّن إلى تكوين صفحة الدفع باستخدام محرر الدفع والحسابات.
الخطوات:
- من مسؤول Shopify، انتقل إلى الإعدادات > الدفع.
استكشاف أخطاء عدم تعيين المكوّن كـ "نشط" وإصلاحها
يجب تعيين المكوّن كـ نشط لكي يُعرض ضمن صفحة الدفع. لا تُعرض مسودات المكوّنات للعملاء.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف أخطاء عدم نشر المكوّن في سوق أو صفحة وإصلاحها
إذا نُسّق المكوّن الخاص بك بإعدادات نشر خاصة بسوق معين، فإنه يُعرض فقط في الأسواق التي حدّدتها. وإذا نُشر المكوّن في صفحات دفع محددة فقط، فلن يُعرض في الصفحات الأخرى.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف أخطاء عدم استيفاء قواعد العرض وإصلاحها
تحدّد قواعد العرض الشروط التي يجب استيفاؤها لعرض مكوّن في صفحة الدفع. إذا لم يتم استيفاء هذه الشروط أثناء جلسة دفع العميل، فلن يُعرض المكوّن.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف أخطاء عدم تطابق معرّف المكوّن وإصلاحها
يحتوي كل نوع مكوّن في محرر الدفع والحسابات على إعداد معرّف المكوّن. يجب أن يتطابق معرّف المكوّن في المحرر مع معرّف المكوّن الذي أنشأته في تطبيق Checkout Blocks. إذا لم تتطابق المعرّفات، فلن يُعرض المكوّن.
على سبيل المثال، إذا كان المكوّن الخاص بك يحتوي على معرّف مكوّن بقيمة 4 في تطبيق Checkout Blocks، فيجب أيضًا تعيين معرّف المكوّن الخاص به في محرر الدفع والحسابات إلى 4.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف أخطاء حقل معرّف مكوّن المعاينة الذي يحتوي على قيمة وإصلاحها
حقل معرّف مكوّن المعاينة (لأغراض الاختبار) في محرر الدفع والحسابات مخصص للاختبار فقط. إذا كان هذا الحقل يحتوي على قيمة بعد حفظ صفحة الدفع الخاصة بك، فيمكنه تجاوز قواعد عرض المكوّن الخاص بك والتسبب في سلوك غير متوقع.
الخطوات:
- من مسؤول Shopify، انتقل إلى الإعدادات > الدفع.
استكشاف أخطاء عرض مكوّن ذي أولوية أعلى بدلاً من ذلك وإصلاحها
إذا كان لديك عدة مكوّنات من نفس النوع بقواعد عرض متداخلة، فسيتم عرض المكوّن ذي الأولوية الأعلى فقط. تعرّف على المزيد حول أولوية المكوّن.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف أخطاء الوصول إلى الحد الأقصى للمكوّنات النشطة وإصلاحها
يدعم تطبيق Checkout Blocks ما يصل إلى 30 مكوّنًا نشطًا لكل نوع مكوّن. وإذا كان لديك أكثر من 30 مكوّنًا نشطًا من نوع واحد، مثل 35 مكوّنًا نشطًا للحقول المخصصة، فلن يتم عرض سوى أول 30 مكوّنًا في صفحة الدفع.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
يتم عرض المكوّن عدة مرات في صفحة الدفع
استكشاف أخطاء مكوّن تمت إضافته إلى قسم مشترك وإصلاحها
بناءً على المكان الذي تضيف فيه مكوّنًا داخل محرر الدفع والحسابات، فقد يُعرض في كل خطوة من خطوات الدفع. يتواجد قسم ملخص الطلب والمنطقة المرفقة بـ زر المتابعة أو العودة بشكل ثابت في جميع صفحات الدفع.
لعرض مكوّن في خطوة محددة فقط، أضف المكوّن إلى منطقة المحتوى الرئيسية لتلك الخطوة.
الخطوات:
- من مسؤول Shopify، انتقل إلى الإعدادات > الدفع.
استكشاف أخطاء تمت إضافة عدة مثيلات للمكوّن وإصلاحها
تحتاج بعض أنواع المكوّنات، مثل مكوّنات تعديل البند (Line item edit)، في العادة إلى إضافتها إلى صفحة الدفع مرة واحدة فقط. يعتمد المكوّن على قواعد العرض لعرض محتوى مختلف في سيناريوهات مختلفة. وإذا تم تكرار محتوى المكوّن، فقد تكون أضفت المكوّن عن طريق الخطأ مرات أكثر من اللازم.
الخطوات:
- من مسؤول Shopify، انتقل إلى الإعدادات > الدفع.
استكشاف الأخطاء التي تظهر عند إنشاء المكوّنات أو حفظها وإصلاحها
إذا تلقيت رسالة خطأ عند محاولة إنشاء مكوّن أو حفظه، فراجع الأقسام التالية.
استكشاف خطأ "حدثت بعض المشكلات في إرسال نموذجك" وإصلاحه
يشير هذا الخطأ عادةً إلى أن حساب الموظفين الخاص بك يفتقر إلى الصلاحيات المطلوبة لإنشاء المكوّنات في Checkout Blocks.
الصلاحيات المطلوبة:
- صلاحيات المتجر > المحتوى: يجب أن يتمتع الموظفون بصلاحيات عرض وإنشاء وتعديل تعريفات الكائنات التعريفية، بالإضافة إلى عرض وإنشاء وتعديل الإدخالات.
- صلاحيات المتجر > إعدادات المتجر: يجب أن يتمتع الموظفون بصلاحية إدارة الإعدادات.
- صلاحيات التطبيقات: يجب أن يتمتع الموظفون على الأقل بصلاحيات تطبيق Checkout Blocks.
الخطوات:
- من واجهة مسؤول Shopify، انتقل إلى الإعدادات > المستخدمون والصلاحيات.
- انقر على حساب الموظفين الذي يواجه الخطأ.
- ضمن صلاحيات المتجر، قم بتوسيع قسم المحتوى.
- تأكد من تحديد الصلاحيتين عرض وإنشاء وتعديل لـ تعريفات الكائنات الوصفية.
- تأكد من تحديد الصلاحيتين عرض وإنشاء وتعديل لـ الإدخالات.
- ضمن إعدادات المتجر، تأكد من تحديد إدارة الإعدادات.
- ضمن صلاحيات التطبيقات، تأكد من تحديد Checkout Blocks.
- انقر على حفظ.
إذا لم تكن لديك صلاحية لتعديل صلاحيات الموظفين، فتواصل مع مالك المتجر أو أحد الموظفين الذين لديهم صلاحيات إدارة المستخدمين.
استكشاف أخطاء الخصومات المخصصة وإصلاحها
الخصومات المخصصة المنشأة في Checkout Blocks قد لا تُطبّق كما هو متوقع بسبب عدة عوامل.
استكشاف خطأ الوصول إلى الحد الأقصى للخصومات التلقائية النشطة وإصلاحه
تسمح Shopify بحد أقصى يبلغ 25 خصمًا تلقائيًا نشطًا في الوقت نفسه، بما في ذلك الخصومات المستندة إلى التطبيقات من جميع التطبيقات المثبتة. ينطبق هذا الحد على متجرك بالكامل، وليس فقط على Checkout Blocks.
إذا حاولت تفعيل خصم تلقائي رقم 26، فلن يُطبّق في صفحة الدفع.
الخطوات:
- من مسؤول Shopify، انتقل إلى الخصومات.
- استخدم الفلتر لعرض الخصومات التلقائية فقط.
- احسب عدد الخصومات التلقائية النشطة حاليًا.
- إذا كان لديك 25 خصمًا تلقائيًا نشطًا أو أكثر، فقم بإلغاء تفعيل أو حذف الخصومات التي لم تعد بحاجة إليها قبل تفعيل خصومات جديدة.
تعرّف على المزيد حول القيود عند دمج الخصومات.
استكشاف خطأ الخصم غير نشط وإصلاحه
يجب تعيين الخصم المخصص إلى نشط حتى يُطبّق في صفحة الدفع. كما يجب ألا يكون الخصم منتهي الصلاحية بناءً على تواريخ البدء والانتهاء المكوّنة له.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف خطأ عدم استيفاء قواعد الخصم وإصلاحه
يمكن أن تحتوي الخصومات المخصصة في Checkout Blocks على قواعد شرطية مفصلة تحدد متى يُطبّق الخصم. إذا لم يتم استيفاء هذه الشروط أثناء جلسة دفع العميل، فلن يُطبّق الخصم.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف أخطاء تخصيصات طرق التسليم والدفع وإصلاحها
إذا لم يتم إخفاء طرق التسليم أو الدفع، أو إعادة تسميتها، أو إعادة ترتيبها كما هو متوقع، فراجع الأقسام التالية.
استكشاف خطأ التخصيص غير نشط وإصلاحه
يجب تعيين تخصيص طريقة التسليم أو الدفع إلى نشط حتى يُطبّق في صفحة الدفع.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف خطأ الوصول إلى الحد الأقصى لـ Functions النشطة وإصلاحه
تفرض Shopify Functions قيودًا على عدد الوظائف النشطة التي يمكنك امتلاكها لكل نوع. يمكنك تفعيل حد أقصى يبلغ 25 وظيفة لتخصيص الدفع في كل متجر. إذا تجاوزت هذا الحد، فقد تتلقى الخطأ التالي: Failed to enable customization. Please try again or contact support.
تساعد هذه القيود في ضمان حفاظ صفحة الدفع على أداء عالٍ. تحتاج إلى دمج التخصيصات أو إزالتها للبقاء ضمن الحد المسموح به.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
استكشاف خطأ عدم استيفاء قواعد التخصيص وإصلاحه
تعتمد تخصيصات طرق التسليم والدفع على قواعد تحدد متى يُطبّق التخصيص. إذا لم يتم استيفاء هذه الشروط أثناء جلسة دفع العميل، فلن يُطبّق التخصيص.
الخطوات:
- من مسؤول Shopify، انتقل إلى التطبيقات > Checkout Blocks.
التحقق من صحة تغييراتك باستخدام عملية دفع تجريبية
قبل الاعتماد على تخصيصات Checkout Blocks الخاصة بك في بيئة فعلية، يجب التحقق من أنها تعمل كما هو متوقع باستخدام عملية دفع تجريبية.
الخطوات:
- من متجرك الإلكتروني، أضف إلى سلة التسوق منتجات تطابق شروط الكتل، أو الخصومات، أو التخصيصات التي ترغب في اختبارها.
- تابع إلى صفحة الدفع ولكن لا تكمل عملية الشراء.
- راجع كل خطوة من خطوات الدفع وتحقق مما يلي:
- تُعرض الكتل في المواقع الصحيحة بالمحتوى الصحيح.
- تُطبّق الخصومات المخصصة عند استيفاء متطلبات الأهلية.
- تعمل تخصيصات طرق التسليم والدفع كما هو متوقع.
- إذا كنت تختبر قواعد العرض المستندة إلى إجمالي سلة التسوق، فجرّب قيمًا مختلفة لسلة التسوق لتأكيد ظهور الكتل واختفائها عند الحدود الصحيحة.
- إذا كنت تختبر قواعد العرض المستندة إلى العميل، فاختبر كلا السيناريوهين: الدفع كعميل مسجل الدخول والدفع كزائر.
الأسئلة الشائعة
ما عدد الكتل التي يمكن أن تكون نشطة في الوقت نفسه؟
يمكن أن يكون لديك ما يصل إلى 30 كتلة نشطة لكل نوع من أنواع الكتل. على سبيل المثال، يمكن أن يكون لديك 30 حقلًا مخصصًا نشطًا، و30 كتلة محتوى ديناميكي نشطة، و30 كتلة تعديل لعناصر السطر نشطة في الوقت نفسه. يمكنك إنشاء أكثر من 30 كتلة من أي نوع، ولكن يمكن عرض أول 30 كتلة نشطة فقط في صفحة الدفع.
لماذا أحتاج إلى صلاحيات موظفين محددة لاستخدام Checkout Blocks؟
يُنشئ تطبيق Checkout Blocks تعريفات الكائنات الوصفية لتخزين تكوينات المكوّنات. يحتاج الموظفون إلى أذونات لإنشاء وتعديل تعريفات وإدخالات الكائنات الوصفية لحفظ المكوّنات في التطبيق. بالإضافة إلى ذلك، يحتاج الموظفون إلى إذن إدارة الإعدادات ضمن إعدادات المتجر وأذونات التطبيق الصريحة لتطبيق Checkout Blocks.
هل يمكنني استخدام تطبيق Checkout Blocks إذا لم أكن مشتركًا في خطة Shopify Plus؟
يمكن للتجار المشتركين في خطة Basic أو خطة أعلى استخدام مكوّنات المحتوى الديناميكي والمحتوى الثابت في صفحتي "شكرًا لك" و"حالة الطلب" فقط. تتطلب جميع ميزات Checkout Blocks الأخرى، بما في ذلك الحقول المخصصة، والخصومات المخصصة، وتخصيصات طرق الدفع والتسليم، خطة Shopify Plus.
كيف أعرف معرّف المكوّن (Block ID) الذي يجب استخدامه؟
عند إنشاء مكوّن في تطبيق Checkout Blocks، يتم تخصيص معرّف مكوّن له (Block ID) (الافتراضي هو 0). عند إضافة نوع المكوّن هذا إلى صفحة الدفع في المحرّر، يجب عليك تعيين نفس معرّف المكوّن (Block ID) حتى يعرف المحرّر المكوّن المحدّد الذي يجب عرضه. إذا كنت ترغب في عرض مكوّنات مختلفة من نفس النوع في مواقع مختلفة، فخصص لكل مكوّن معرّف مكوّن (Block ID) فريدًا وطابق هذه المعرّفات في المحرّر. تعرّف على المزيد حول معرّفات المكوّنات (Block IDs).
هل يمكنني دمج خصومات تطبيق Checkout Blocks مع خصومات أخرى؟
الخصومات المخصصة المُنشأة في تطبيق Checkout Blocks هي خصومات تلقائية مدعومة بواسطة Shopify Functions. وهي تتبع نفس قواعد دمج الخصومات الخاصة بالخصومات التلقائية الأخرى. يمكنك تفعيل ما يصل إلى 25 خصمًا تلقائيًا نشطًا كحد أقصى في متجرك، بما في ذلك الخصومات المُنشأة في Checkout Blocks وتطبيقات أخرى.
قبل التواصل مع دعم Shopify بخصوص تطبيق Checkout Blocks
إذا جربت خطوات استكشاف الأخطاء وإصلاحها المذكورة أعلاه واستمرت المشكلة في Checkout Blocks، فيمكنك التواصل مع دعم Shopify للحصول على المساعدة. قبل التواصل مع دعم Shopify، اجمع المعلومات التالية الخاصة بتطبيق Checkout Blocks للمساعدة في حل مشكلتك بشكل أسرع:
- تفاصيل المكوّن: الاسم، والنوع (مثل الحقل المخصص، أو المحتوى الديناميكي، أو تعديل البند)، ومعرّف المكوّن (Block ID) للمكوّن الذي لا يعمل
- لقطات شاشة للتكوين: لقطات شاشة لإعدادات المكوّن في تطبيق Checkout Blocks، بما في ذلك أي قواعد عرض، وإعدادات نشر، وحالة المكوّن
- لقطات شاشة للمحرّر: لقطات شاشة لكيفية تكوين المكوّن في محرّر صفحة الدفع والحسابات، بما في ذلك حقلي معرّف المكوّن (Block ID) ومعرّف مكوّن المعاينة (Preview block ID)
- رسائل الخطأ: لقطات شاشة أو النص الدقيق لأي رسائل خطأ تتلقاها عند إنشاء المكوّنات، أو حفظها، أو معاينتها
- رابط اختبار لصفحة الدفع: رابط لصفحة دفع تجريبية أو عملية دفع متروكة حيث يمكن إعادة إنشاء المشكلة، بالإضافة إلى محتويات سلة التسوق المستخدمة لتشغيل قواعد العرض
- السلوك المتوقع مقابل السلوك الفعلي: وصف واضح لما كنت تتوقع حدوثه مقابل ما يحدث بالفعل في صفحة الدفع
- خطوات استكشاف الأخطاء وإصلاحها المكتملة: الأقسام التي راجعتها بالفعل من هذا الدليل والخطوات التي حاولت القيام بها
- أذونات الموظفين: تأكيد بأن حسابك يمتلك الأذونات المطلوبة للمحتوى (تعريفات وإدخالات الكائنات الوصفية)، وإعدادات المتجر (إدارة الإعدادات)، وأذونات التطبيق (Checkout Blocks)
يساعد تجهيز هذه المعلومات الخاصة بتطبيق Checkout Blocks دعم Shopify على تشخيص مشكلتك وحلها بكفاءة أكبر.