تكامل حزمة تطوير البرامج للويب
يستخدم @spreeai/web-sdk لمتجر ويب مخصص أو بدون واجهة مستخدم.
تستهدف هذه الأمثلة المنشور الإصدار 3.0.0 حزمة. اتصل init() مرة واحدة، واحفظ نتيجتها القابلة للإبطال. يتم حل الشريك من clientId؛ ممنوع المرور partnerId إلى الإصدار 3 init()ينبغي على عمليات التكامل الحالية من الإصدار الثاني اتباع دليل الترقية الرسمي قبل تغيير الإصدارات.
ثَبَّتَ
npm install @spreeai/web-sdk@3.0.0
# or
yarn add @spreeai/web-sdk@3.0.0
قم بتضمين ورقة أنماط SDK الموثقة لإصدار SDK المثبت.
التهيئة والعرض
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,
});
}
init() عمليات الإرجاع null عند فشل المصادقة، قم بحماية جميع استدعاءات العرض.
المقاسات
يُتيح الإصدار 3.0.0 إمكانية تحديد المقاسات داخل تجربة تجربة الملابس، بدلاً من عرضها بشكل منفصل. sdk.renderSizingButton() الطريقة. بالنسبة للملابس التي تحتوي على بيانات مقاسات معتمدة، قم بتمكين هذه العملية على زر التجربة:
await sdk?.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableSizingRecommendation: true,
});
قم بتفعيل خاصية تحديد المقاسات فقط بعد أن تصبح بيانات الملابس وإعدادات الشريك جاهزة.
الفعاليات
توثّق حزمة تطوير البرامج العامة (SDK) عمليات الاستدعاء من جانب العميل لزر "التجربة" وإجراءات "إضافة إلى السلة". اربط عمليات الاستدعاء بطبقات التحليلات وسلة التسوق الموجودة في واجهة المتجر. تجنّب وضع صور العملاء أو بيانات اعتمادهم أو أي بيانات شخصية غير ضرورية في حمولات التحليلات.
إرشادات الإنتاج
- قم بالتهيئة مرة واحدة لكل صفحة.
- العرض متاح فقط للملابس المؤهلة.
- مرر معرفات الكتالوج الثابتة.
- احرص على إبقاء أسرار العميل بعيدة عن شفرة المتصفح.
- اختبار تغييرات المتغيرات وانتقالات المسار في تطبيقات الصفحة الواحدة.
- حافظ على تركيز لوحة المفاتيح وعلامة يسهل الوصول إليها لنقطة الدخول.
- التحقق من صحة حالات التحميل والفشل وعدم التوفر.
- قم بمراقبة أداء صفحة المنتج قبل وبعد تفعيل التكامل.