سوق
سبري إيه آي للمطورين
ابنِ غرفة القياس
في كل شاشة.
ابدأ باستخدام Shopify، أو مجموعة أدوات تطوير الويب (Web SDK)، أو تكامل واجهة برمجة تطبيقات معتمد. ينقل هذا المركز فريقك من القرار الأول إلى إطلاق مجرب.
- 04
- مسار التكامل
- الإصدار 2.1
- حزمة تطوير البرمجيات الحالية للويب
- 01
- قائمة التحقق للإطلاق
اختر طريقك
ابدأ من حيث
مكدس التجارة على قيد الحياة.
اختر المسار الأسرع الذي يناسب واجهة متجرك. يمكنك الانتقال من تطبيق مُدار إلى مجموعة أدوات تطوير (SDK) مخصصة أو تكامل واجهة برمجة التطبيقات (API) مع نمو التجربة.
مباشرقريباً
أسرع مسار
تطبيق شوبيفاي
التثبيت، ومزامنة قطع الملابس، والتخصيص، والإطلاق بدون خادم خلفي مخصص.الأفضل لمتاجر شوبيفاي ↗ الإصدار 2.1.0ويب مخصص
مجموعة أدوات تطوير البرمجيات للويب
التحكم في موضع العناصر، والتصميم، والأحداث، والحجم، وسلوك زر "إضافة إلى السلة".جافا سكريبت + تايب سكريبت ↗ الوثائقتطبيق محلي
مجموعة تطوير نرمجيات آي أو إس
أدخل تجربة SPREEAI في رحلة التسوق الحالية على نظام iOS.فتح دليل نظام iOS ↗ الوثائقتطبيق محلي
حزمة تطوير البرمجيات لنظام أندرويد
دمج ميزة القياس الافتراضي في تجربة منتج على أندرويد باستخدام عناصر تحكم أصلية.دليل فتح أندرويد ↗ وصول الشريكأنظمة مخصصة
واجهات برمجة التطبيقات العامة
استخدم مرجع واجهة برمجة التطبيقات المعتمد لسسير عمل جانب الخادم والكتالوج.فتح مرجع واجهة برمجة التطبيقات ↗البدء السريع لـ Web SDK
من التثبيت إلى
زر يعمل.
مصادقة لمرة واحدة، ثم عرض التجربة الافتراضية أو تحديد المقاسات في أي مكان على الصفحة. استخدم بيانات اعتماد الاختبار الصادرة أثناء الإعداد ولا تضع أبداً سر العميل في كود المتصفح.
npm install @spreeai/web-sdk
# أو
yarn add @spreeai/web-sdkimport { init } from "@spreeai/web-sdk";
const sdk = await init({
clientId: "your-client-id",
partnerId: "your-partner-id",
});
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}events: {
onTryOnButtonClick: (event) => {
analytics.track("try_on_started", event);
},
onAddToCartClicked: async (event) => {
// الاتصال بخط عمل سلة التسوق الحالية لديك.
},
}نموذج التكامل
أربعة أنظمة.
لحظة عميل واحدة.
معرفات المنتجات، والمتغيرات، والصور، وسياق الترويج التجاري.
تنتقل الملابس عبر مراحل المعالجة والمراجعة والجاهزية.
تطلب واجهة متجرك التجربة لمنتج مؤهل.
قسِمه، واعثر على المقاس المناسب، وأكمل المظهر، ثم عد لإتمام الشراء.
مسار الإنتاج
خذ التكامل
عبر خط النهاية.
الإطلاق النظيف هو أكثر من مجرد زر يعمل. استخدم هذا التسلسل لمواءمة الوصول، والأصول، والسلوك، والجودة، والقياس.
- 01المالك · المنتج + التجارة
تحديد نطاق الرحلة الأولى
اختر قناة واحدة، ومجموعة كتالوج، ولحظة عميل، ومقياس نجاح.
- 02المالك · الهندسة
إعداد الوصول
تأكيد معرف الشريك، وبيانات اعتماد العميل المعتمدة، وصلاحيات واجهة المتجر، وبيئة الاختبار.
- 03المالك · فريق الكتالوج
تقديم أصول نظيفة
قطعة ملابس واحدة لكل صورة، ويُشترط عرض من الأمام، وعالية الدقة، وإضاءة نقية، وأسماء ملفات متوافقة مع رمز SKU.
- 04المالك · الواجهة الأمامية
دمج في مرحلة التجريب
العرض فقط على المنتجات المؤهلة، وربط المتغيرات وسلوك سلة التسوق، وملاءمة نقطة الدخول مع العلامة التجارية.
- 05المالك · ضمان الجودة + العلامة التجارية
إجراء ضمان جودة الإطلاق
اختبار الجوال سطح المكتب، تغطية المتصفحات، إمكانية الوصول، الأداء، الدقة البصرية وحالات الفشل.
- 06المالك · التجارة والتحليلات
تمكين وقياس
تفعيل المنتجات الجاهزة، ونشر التجربة المعدة، ومراقبة الإقبال، والإكمال، والتحويل.
خط الأساس للأصول
المدخلات الجيدة تصنع نتيجة أفضل.
- JPEG أو PNG
- بحد أدنى 2,000 × 2,000 بكسل
- مطلوب عرض أمامي
- يوصى بالرؤية الخلفية
- إضاءة محايدة ومتساوية
- رمز SKU أو معرف الطراز في اسم الملف
مرجع المطور
ابحث عن التالي
إجابة مفيدة.
ابدأ من هنا
البدء
تعرف على طرق الوصول والمنصات المدعومة والقرارات الأولى التي يتعين على فريقك اتخاذها.
مرجع رسمي التكامل المُدارإعداد متجر شوبيفاي
ثبّت التطبيق، وافق على الاتفاقيات، وازنِ الملابس، وقم بتخصيص الزر وابدأ البث المباشر.
مرجع رسمي مجموعة أدوات تطوير البرمجيات للويبواجهة برمجة التطبيقات
مراجعة التهيئة، وخيارات العرض، وتحجيم، والتخصيص، والواجهات المكتوبة.
مرجع رسمي واجهة برمجة تطبيقات الشركاءمرجع واجهة برمجة التطبيقات العامة
استكشف واجهة خادم الطرف الخلفي المعتمدة والمتاحة للشركاء المصادق عليهم.
مرجع سواغر ↗ جودةأصول الملابس
إعداد صور المنتجات والبيانات الوصفية التي تنتقل بسلاسة عبر مرحلتي الإدخال والمراجعة.
دليل SPREEAI إنتاجضمان الجودة والإطلاق
استخدم قائمة التحقق المشتركة للمتصفح والأداء وإمكانية الوصول والإطلاق.
دليل SPREEAI الدعماستكشاف الأخطاء وإصلاحها
حل المشكلات الأكثر شيوعاً المتعلقة بالمصادقة، والأهلية، والعرض، والأداء.
دليل SPREEAI توثيقأدلة التنفيذ
تصفح الأدلة السريعة العامة، ومعايير الأصول، وقوائم التحقق للإطلاق، وإرشادات استكشاف الأخطاء وإصلاحها.
فتح التوثيق ↗لا توجد موارد مطابقة للمطورين. جرب “Shopify” أو “SDK” أو “assets” أو “QA”.”
Build for production
The details that protect
the customer experience.
Security
Keep secrets server-side, use only issued environments and rotate credentials through the partner workflow.
خصوصية
Request customer imagery with clear consent and align data handling with your approved integration plan.
Performance
Load the experience where it is needed, test real devices and monitor product-page regressions.
Accessibility
Preserve keyboard access, focus order, accessible names and a usable path when the experience is unavailable.
Developer FAQ
Questions before
the first commit.
Which integration should we choose?
Use the Shopify App for the fastest managed path, the Web SDK for custom or headless web placement, the native SDKs for app experiences, and the approved API reference for server-side workflows agreed during onboarding.
Where do credentials come from?
SPREEAI issues the partner ID and approved credentials during onboarding. The browser SDK uses a client ID and partner ID. Never embed a client secret in front-end code.
Does the Shopify App require API keys?
The current Shopify App onboarding flow connects the store after the required agreements and subscription step; the managed app does not require copying keys into the setup screen.
Why does the Try-On button not appear?
Confirm the garment has completed processing, is enabled for Try-On, maps to the active product or variant, and that the app block or SDK container is present on the product template.
Which client events are available?
The documented SDK callbacks cover Try-On button clicks and add-to-cart interactions. Connect them to your analytics layer without including customer imagery or unnecessary personal data.
Are server webhooks available?
Server-push webhooks are not part of the currently published SDK documentation. Scope any server-side event requirement with Partner Engineering before relying on it.
Where do developers get help?
Use the technical support path provided during onboarding or email support@spreeai.com. Include the environment, product ID, browser or device, timestamp and a concise reproduction path—never send secrets.
When will Amazon Partner Network support be available?
The Amazon Partner Network integration is in development. It is intentionally marked Coming Soon until the onboarding and production interface are ready for external developers.
Ready to build?