ابنِ باستخدام
SPREEAI.

تطبيق Shopify

استخدم التطبيق المُدار عندما يعمل المتجر على Shopify ولا يحتاج إلى نظام خلفي مُخصص. يربط مسار الإعداد الحالي المتجر بعد الاتفاقيات والاشتراك؛ ولا يتطلب نسخ مفاتيح واجهة برمجة التطبيقات (API) إلى شاشة الإعداد.

1. قم بتثبيت تطبيق SPREEAI الرسمي وأكمل عملية الموافقة المُدارة.
2. قم بمزامنة مجموعة الكتالوج الأولية ومراجعة حالات جاهزية المنتج.
3. قم بتخصيص موضع وشكل العناصر في قالب مكرر.
4. التحقق من المنتجات المؤهلة، والأنواع المختلفة، وسلوك المستخدم على الأجهزة المحمولة، وعملية الإضافة إلى سلة التسوق.
5. لا تنشر إلا بعد موافقة العلامة التجارية وضمان الجودة.

افتح دليل الإعداد الرسمي لـ Shopify

دليل البدء السريع لحزمة تطوير البرامج للويب

يستخدم @spreeai/web-sdk للتخصيص في وضع العناصر وتصميمها وأحداثها وتحديد أحجامها وسلوك سلة التسوق.

npm install @spreeai/web-sdk@3.0.0

import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";

// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });

if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "your-garment-id" }],
    enableAddToCart: true,
  });
}

قم بالتهيئة مرة واحدة، ثم اعرض فقط للمنتج المؤهل، واربط ردود الاتصال الموثقة للعميل بتحليلاتك الحالية. تأكد من الواجهة الحالية في المرجع الرسمي لواجهة برمجة تطبيقات Web SDK

الوصول إلى واجهة برمجة التطبيقات (API)

استخدم مرجع Swagger العام فقط لسير العمل على جانب الخادم الذي تمت الموافقة عليه أثناء عملية الإعداد. احتفظ بالبيانات السرية على خادمك، وافصل بين الوصول إلى بيئة الاختبار وبيئة الإنتاج، وحدد نطاق بيانات الاعتماد لأقل بيئة مطلوبة.

يجب التعامل مع نقاط نهاية REST المباشرة أو روابط الويب أو سلوكيات المصادقة غير الموجودة في المرجع العام المعتمد على أنها غير متاحة حتى يؤكدها قسم هندسة الشركاء.

افتح مرجع واجهة برمجة التطبيقات العامة المعتمدة

خط الأساس لأصول الملابس

• JPEG أو PNG؛ الحد الأدنى 2000 × 2000 بكسل، ويفضل أن يكون بدقة 4K تقريبًا.
• قطعة ملابس واحدة لكل صورة، متمركزة بحواف نظيفة وإضاءة محايدة ومتساوية.
• العرض الأمامي مطلوب؛ العرض الخلفي مُوصى به عند تفعيل هذه الخاصية.
• يتم تضمين رمز المنتج الثابت (SKU) أو النمط أو معرف الملابس في اسم الملف وسجل الكتالوج.
• ممنوع استخدام الأيدي، أو الشماعات، أو أدوات التصفيف، أو العلامات المائية، أو الملابس غير ذات الصلة التي تحجب المنتج.
• تم التحقق من مطابقة المتغيرات قبل تفعيل التجربة.

ضمان الجودة والإطلاق

• اختبر رحلة العميل الكاملة على متصفحات الجوال وأجهزة الكمبيوتر المكتبية الحالية.
• تحقق من مطابقة المنتج والخيارات، وجاهزية الملابس، وسلوك سلة التسوق.
• تحقق من إمكانية الوصول إلى لوحة المفاتيح، وترتيب التركيز، والأسماء التي يمكن الوصول إليها، وسلوك النسخ الاحتياطي.
• قم بقياس أداء صفحة المنتج قبل وبعد تمكين SPREEAI.
• حالات تحميل التمرين، فارغة، غير متوفرة، مهلة زمنية، وإعادة المحاولة.
• تأكيد لغة الموافقة والتعامل المعتمد مع صور العملاء.
• يجب الحصول على موافقة الهندسة والتجارة وضمان الجودة والعلامة التجارية قبل الإنتاج.

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

الزر لا يظهر

تأكد من تهيئة حزمة تطوير البرامج (SDK)، ومعرّف العميل، ومعرّف عنصر المضيف، وأهلية المنتج، وجاهزية الملابس، وتعيين المتغيرات. ثم تحقق من وحدة تحكم المتصفح وأخطاء الشبكة دون مشاركة الرموز المميزة.

يظهر المنتج أو النوع الخاطئ

قارن معرفات المنتج وأنواعه في واجهة المتجر بالسجلات المرسلة إلى SPREEAI. تأكد من أن الطلب المُقدّم يتغير عندما يُغيّر المتسوق الأنواع.

تجربة المستخدم بطيئة أو غير متاحة

اختبر منتجًا جاهزًا للاستخدام، وتحقق من بيئة التشغيل، وافحص الطلبات المحظورة، وقارنها بجلسة تصفح نظيفة. سجّل الطابع الزمني وتسلسل الأحداث القابل للتكرار لتقديم الدعم.

احصل على دعم المطورين

بريد إلكتروني support@spreeai.com مع تحديد البيئة، ومعرف المنتج أو الملابس، والمتصفح أو الجهاز، والطابع الزمني التقريبي، والسلوك المتوقع، وخطوات إعادة الإنتاج. لا تُدرج معلومات سرية أو صورًا للعملاء.