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

ابدأ بالخطوة الفاشلة في تكامل Visualizer SDK لديك: تحميل SDK، مطابقة منتج، أو استيراد بيانات. حافظ على سياق الطلب متاحًا دون مشاركة بيانات الاعتماد.

زر الواجهة الإلكترونية لا يظهر#

1. تحقق من لوحة Network لـ https://sdk.ideal.house/sdk.js وتفقد أي فشل تحميل.
2. أكد وجود مَحمّل واحد بـ Shop ID و Publishable Key صحيحين.
3. افتح لوحة التحكم → الإعدادات. أكد أن Allowed Origins (CORS) يتضمن نقطة أصل الواجهة الأمامية الدقيقة التي تختبرها، وانقر حفظ بعد أي تغييرات، ثم أعد تحميل الواجهة الأمامية. أيضًا تحقق من data-product-code الدقيق للهدف. اطّلع على تكوين نقطة الأصل.
4. تحقق من جاهزية المنتج ومن ربط متغير المنتج المحدد بالمنتج المقابل في الكتالوج.
5. بالنسبة إلى الأزرار المُنشأة يدويًا، تحقق من أن أنماطك تسمح للحالة النشطة المؤكدة بأن تصبح مرئية.

لا تجبر زر غير مُعتمد على الظهور لتجاوز الأهلية. اتبع دليل المنصة ودليل التعيين.

المنتج الخطأ يفتح#

افحص الهدف بعد تغيير المتغير، أو فتح عرض سريع، أو التنقل دون إعادة تحميل. نظّف سمات SDK القديمة وفق الصفحات الديناميكية وأكد أن دالة رد النداء في منصتك يعمل فعلًا.

تم قبول الاستيراد لكن المنتجات مفقودة#

رد 202 Accepted يبدأ عملاً غير متزامن. اطّلع على حالة المهمة، وفحص فشل العناصر، واستخدم الأخطاء وإعادة المحاولة. تُرجع نقطة نهاية الحالة مهمة المتجر الحالية أو الأخيرة؛ وليست بحث سجل بأي معرف مهمة عشوائي.

ماذا ترسل للدعم#

استخدم قناة الدعم المقدمة أثناء الإعداد الأولي أو خيار التواصل في حسابك. أرفق URL واجهة المتجر المتأثرة، وShop ID عند الاقتضاء، ورمز المنتج أو معرّف مهمة الاستيراد، والوقت التقريبي، والمتصفح، والنتيجة المتوقعة، واستجابة الخطأ بعد إزالة المعلومات الحساسة منها. احذف Client Secret ومفاتيح API والرموز المميزة وصور العملاء الخاصة قبل مشاركة السجلات أو لقطات الشاشة.