Skip to main content

نظرة عامة

افتراضيًا، يتولى Upcart وظائف سلة Shopify، مما قد يمنع تطبيقات الجهات الخارجية مثل Klaviyo من اكتشاف تحديثات السلة. لحسن الحظ، هناك طريقتان موثوقتان لاستعادة تتبع الإضافة إلى السلة (ATC) في Klaviyo مع إبقاء Upcart نشطًا. قبل أن تبدأ، تأكد من تهيئة Klaviyo Onsite Tracking بشكل صحيح. يمكنك اتباع دليل الإعداد الخاص بهم هنا:
👉 دليل إعداد Klaviyo Onsite Tracking

الخيار 1: استخدام توافق AJAX (أسرع إعداد)

يتضمن Upcart إعدادًا يستعيد التوافق مع التطبيقات الأخرى من خلال إتاحة سلوك تحديث السلة الأصلي في Shopify. عند تفعيل هذا، يمكن لـ Klaviyo الاستماع مرة أخرى لأحداث الإضافة إلى السلة.

كيفية التفعيل:

  1. انتقل إلى Upcart > Cart Editor > Settings > Cart settings
  2. مرر إلى Advanced Settings ووسّعه
  3. حدد Enhanced Ajax API compatibility
  4. انقر على Save واختبر النتيجة
⚠️ مهم: مفاضلات Enhanced AJAX API Compatibility
هذا الإعداد معطّل افتراضيًا لمعظم المتاجر. فعّله فقط إذا كان متجرك يستخدم واجهة AJAX cart API غير قياسية ولم يكن Upcart يعترض أحداث الإضافة إلى السلة. عند تفعيله، تكتسب التطبيقات الأخرى مزيدًا من التحكم في سلوك السلة، مما قد يسبب حلقات إعادة توجيه أو يرسل العملاء إلى صفحة سلة Shopify بدلاً من فتح درج Upcart. إذا تسبب تفعيل هذا الإعداد في عمليات إعادة توجيه، فعطّله وانتقل إلى الخيار 2 بدلاً من ذلك، باستخدام واجهة Upcart API اليدوية (upcartRegisterAddToCart).
للحصول على إرشادات كاملة حول هذا الإعداد، راجع Enhanced AJAX API Compatibility.
تمنحك هذه الطريقة أفضل ما في العالمين، يبقى Upcart متحكمًا بالكامل، ويستمر تتبع Klaviyo في العمل.

الخطوات:

  1. افتح Upcart > Cart Editor > Settings
  2. مرر لأسفل إلى قسم Custom HTML
  3. من القائمة المنسدلة، اختر Scripts (Before Load)
  4. الصق السكربت التالي:
واجهة API الحديثة (موصى بها):
الصق الكتلة كاملة، بما في ذلك دالة TrackATC. المشترك يستدعيها، لذا فإن مقتطفًا يحتوي فقط على سطري upcartSubscribe… يطلق Uncaught ReferenceError: TrackATC is not defined عند كل إضافة إلى السلة ولا يرسل شيئًا إلى Klaviyo.
واجهة API القديمة (لا تزال تعمل ولكنها مهملة):

ما يفعله هذا:

  • يرسل حدث “Added to Cart” إلى Klaviyo في أي وقت يُضاف فيه منتج أو عرض بيع إضافي (upsell) باستخدام Upcart
  • يضيف رسالة تأكيد (Klaviyo ATC) إلى وحدة تحكم المتصفح حتى تعرف أنه يعمل

كيفية اختبار الإعداد

للتأكد من أن تكامل Klaviyo الخاص بك يعمل بشكل صحيح: إذا كنت لا تزال لا ترى بيانات التتبع، فتأكد من تثبيت سكربتات Klaviyo داخل الموقع وتفعيلها. للحصول على المساعدة، اتصل بـ مركز مساعدة Klaviyo.

الملخص

إذا كنت تستخدم Klaviyo وUpcart معًا، فمن المفترض أن يساعدك هذا الدليل في تتبع الأحداث بسلاسة مع الحفاظ على تجربة درج السلة سليمة.
هل تحتاج إلى مزيد من المساعدة؟ تواصل معنا عبر الدعم داخل التطبيق.