كيفية تثبيت الوكيل على Shopify
أين يتم إدراج الكود في قالب Shopify، كيف يقرأ الوكيل كتالوج المتجر، التعامل مع سلة التسوق والدفع، وكيفية التحقق من التثبيت.
يحتوي Shopify بالفعل على كتالوج بتنسيق قابل للقراءة آليًا، مما يتيح للوكيل جمع المنتجات بدقة أكبر من أي مكان آخر: الأسعار، الخيارات، التوفر، والصور تأتي مباشرة من المتجر نفسه.
الخطوة 1. أدخل الرمز في القالب#
- في لوحة تحكم Shopify، افتح «المتجر عبر الإنترنت ← القوالب».
- بجانب القالب النشط، اضغط على … ← «تعديل الرمز».
- في قائمة الملفات، ابحث عن
layout/theme.liquid. - أدخل سطر الرمز من لوحة التحكم مباشرة قبل وسم الإغلاق
</body>. - احفظ.
بديل دون تعديل القالب: «المتجر عبر الإنترنت ← التفضيلات ← رمز مخصص» أو أي تطبيق لإدخال السكربتات. النتيجة واحدة.
<!-- Commerce Agents -->
<script src="https://comag.vibevox.pro/widget.js" data-slug="your-slug" async></script>
</body>
</html>احصل على السطر الدقيق من لوحة التحكم باستخدام زر «نسخ الرمز»: فهو يحتوي بالفعل على عنوان واجهة متجرك.
الخطوة 2. اجمع الكتالوج#
في الإعدادات، حدد عنوان المتجر وابدأ التحليل. يقرأ متتبع Shopify البيانات المنظمة للمنتجات: الاسم، السعر، العملة، التوفر، الوصف، والصور. تظهر الخيارات (مثل الأحجام والألوان) في بطاقة المنتج كخصائص.
يُحدّث التحليل المتكرر الأسعار والتوفر. ابدأه بعد التغييرات الكبيرة في تشكيلة المنتجات: الوكيل لا يتصل بقاعدة بياناتك مباشرة، بل يعمل بالكتالوج المجمع.
الخطوة 3. اترك الدفع للمتجر#
على Shopify، لا تحتاج إلى تفعيل الدفع في الدردشة. المخطط الصحيح هو:
- في إعدادات المتجر، حدد رابطًا لعربة التسوق — عادةً
https://your-domain/cart. - يختار الوكيل المنتج، يعرض بطاقته، وبواسطة الزر يوجه المشتري إلى عربة تسوق Shopify.
- تتم عملية الدفع والشراء بالطريقة المعتادة، مع جميع قواعد الشحن والضرائب الخاصة بك.
لمعرفة أي المحادثات تنتهي بعملية شراء، أدخل جزء بكسل الشراء في صفحة الشكر. في Shopify، هذا هو «الإعدادات ← الدفع ← صفحة حالة الطلب ← سكربتات إضافية». الجزء الذي يتضمن استبدال رقم الطلب والمبلغ موجود في لوحة التحكم، في قسم «الودجت والرابط».
المنتج يضاف إلى السلة دون مقاطعة المحادثة#
هنا، يتفوق Shopify على المنصات الأخرى. يعرض الوكيل بطاقات المنتجات مع صورة وسعر وزر، لكن الزر لا يوجه فقط إلى الصفحة — بل يضيف المنتج إلى عربة تسوق المتجر.
يعمل هذا على النحو التالي: يحتوي رابط منتج Shopify على معرف الخيار، وينقله الوكيل إلى عربة التسوق الخاصة بك عبر الواجهة القياسية /cart/add.js. لا تُعاد تحميل الصفحة، ولا تنقطع المحادثة، ويرى المشتري تأكيدًا قصيرًا ويستمر في الاختيار. المنتج يكون بالفعل في عربة تسوق Shopify — مع جميع قواعد الخصومات والضرائب والشحن الخاصة بك.
إذا لم يكن هناك خيار في الرابط، يفتح الوكيل بطاقة المنتج، ويضيفها المشتري بنفسه. لا شيء يتعطل، مجرد نقرة إضافية.
عندما يكون الشخص جاهزًا، يوجه زر «الانتقال إلى الدفع» إلى /cart، حيث يكون كل شيء جاهزًا. بعد ذلك — عملية دفع Shopify المعتادة.
وبشكل منفصل عن السياق: يقرأ الوكيل البيانات المنظمة للصفحة التي فُتحت عليها الدردشة. ينظر المشتري إلى منتج معين ويسأل «هل هو متوفر بمقاس L؟» — يفهم الوكيل ما يدور حوله الحديث دون الحاجة إلى إعادة السؤال.
- افتح المتجر في وضع التصفح المتخفي، وانتظر ظهور زر الدردشة.
- اسأل عن المنتج بالاسم — يجب أن تظهر بطاقة المنتج مع السعر.
- اضغط على «الانتقال إلى الدفع» — يجب أن تفتح عربة تسوق Shopify.
- أكمل طلبًا تجريبيًا وتأكد من تسجيل الشراء في «الطلبات».
الدردشة بلون الواجهة#
يحدد قالب Shopify طابع المتجر بأكمله، ويجب ألا تخرج الدردشة عن هذا الطابع. في إعدادات الودجت، توجد ثلاثة خيارات: فاتح، داكن، و«مثل الزائر»، والذي يتبع إعدادات جهاز المشتري.
للمتاجر ذات القالب الداكن، اضبط الوضع الداكن بشكل ثابت، وللمتاجر ذات القالب الفاتح، اضبط الوضع الفاتح. يبقى لون التمييز للأزرار خاصًا بك في كلتا الحالتين.
الخطوة 4. تحقق#
مشاكل متكررة#
اختفى الودجت بعد تغيير القالب. يعيش الرمز في ملف القالب. يؤدي تغيير القالب أو تحديثه إلى مسح التعديل — أدخل الرمز مرة أخرى أو استخدم «رمز مخصص» الذي لا يعتمد على القالب.
لم يُجمع الكتالوج بالكامل. يجمع المتتبع المنتجات من الصفحات العامة. المنتجات المخفية عن الكتالوج والمسودات لا تُدرج، وهذا صحيح.
أسعار الكتالوج قديمة. أعد تشغيل تحليل الموقع، وسيقوم بتحديث الأسعار والتوفر للبطاقات الموجودة.
الودجت يتعارض مع تطبيق الدردشة. اترك دردشة واحدة: نافذتان في زاوية واحدة تعيقان بعضهما البعض وتُربكان المشتري.
أسئلة متكررة#
هل أحتاج إلى تطبيق من Shopify App Store؟#
لا. يتصل الوكيل بسطر واحد من الرمز، ولا يلزم تثبيت أي تطبيق.
هل يمكن للوكيل عرض خيارات المنتج؟#
نعم، تظهر الخيارات في بطاقة المنتج كخصائص: الحجم، اللون، الحجم (الكمية). يختار المشتري الخيار المحدد في عربة تسوق Shopify.
ماذا عن العملات المتعددة؟#
يعرض الوكيل الأسعار بعملة الكتالوج التي يحددها أثناء التتبع. تعمل ميزة العملات المتعددة في Shopify لاحقًا، على جانب عربة التسوق والدفع.
هل سيعرف الوكيل عن المخزون المتبقي؟#
يُؤخذ التوفر في لحظة التحليل. بالنسبة للمنتجات التي تنفد غالبًا، قم بتشغيل التحليل بشكل متكرر أو أضف إلى الشروط جملة تفيد بأن التوفر يُحدد عند إتمام الطلب.
هل يؤثر الودجت على سرعة المتجر؟#
يتم تحميل السكربت بشكل غير متزامن ولا يحجب العرض. لا يؤثر هذا عمليًا على مقاييس Core Web Vitals.