معرّفات المنتجات ومتغيراتها#
يجب أن يشير العنصر المستهدف في واجهة المتجر إلى المنتج نفسه الموجود في كتالوج التاجر. تبدأ معظم حالات فشل التكامل بعدم تطابق هاتين القيمتين.
اختر معرفًا مستقرًا#
استخدم productCode المعروض للمنتج المَعُد. في دليل Shopify يكون هذا هو SKU الخاص بمتغير المنتج. حقول طلبات Product Import API مُعرّفة في مرجع الاستيراد؛ لا تستبدل أسماء تلك الحقول بأسماء سمات الواجهة الأمامية.
حافظ على تطابق المعرفات حرفيًا بما في ذلك حالة الأحرف. لا تولّدها من أسماء عرض قابلة للتغيير، ولا تفترض أن معرف المنتج الداخلي للمنصة يساوي SKU.
ربط متغير المنتج المحدد#
| حالة الواجهة الإلكترونية | سلوك العنصر المستهدف |
|---|---|
| تم تحديد متغير منتج مُعدّ مسبقًا | اضبط productCode المطابق له بدقة |
| عند تغيير التحديد | حدّث الهدف ونظّف حالة SDK القديمة باستخدام دليل تكاملك |
| لا يوجد SKU أو منتج مطابق | أبقِ الزر المُنشأ يدويًا مخفيًا أو معطلاً |
| تشير بطاقة المنتج إلى متغير افتراضي | استخدم معرّف ذلك المتغير باستمرار |
بالنسبة إلى Shopify، اربط دالة المزامنة المساعدة الواردة في الدليل بدالة رد النداء الفعلية لتغيير متغير المنتج في قالبك. أما واجهات المتاجر الأخرى، فاتبع دليل الصفحات الديناميكية.
التحقق من صحة الربط#
اختر متغيرين بمنتجات مختلفة ظاهرِيًا. سجّل رموزهما في الكتالوج، وتفحّص كل data-product-code مُصاغ في أدوات مطوري المتصفّح، ثم افتح Viewer لكل منهما. كرر بعد التنقل من دون إعادة تحميل كامل للصفحة.
عند تغيير مُعرِّف في نظامك المصدر، يجب تنسيق استيراد الكتالوج وإصدار الواجهة الأمامية. إن استجابة استيراد HTTP الناجحة هي مجرد قبول؛ تفحص حالة المهمة وفشل العناصر قبل الاعتماد على الكود الجديد.