انتقل إلى المحتوى
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويقالعودة للمتجر
القائمة

تمايز / معلومات تهمك

كيف تختبر Custom Pixel في Shopify داخل Sandbox؟

خطوات عملية لاختبار Custom Pixel في Shopify داخل Sandbox وفحص الأحداث وطلبات الشبكة وأخطاء CORS دون جمع بيانات غير لازمة.

يعمل Custom Pixel في Shopify داخل بيئة معزولة، ولذلك قد يفشل كود كان يعمل سابقًا عند لصقه مباشرة في القالب. سبب الفشل غالبًا ليس غياب الحدث؛ بل افتراض أن البيكسل يستطيع قراءة عناصر الصفحة أو الوصول إلى النافذة العليا أو إرسال طلب إلى نطاق لا يسمح بطلبات المتصفح. الاختبار الصحيح يبدأ من عقد البيانات الذي توفره Shopify، ثم يتتبع الحدث والطلب الشبكي والاستجابة، مع احترام موافقة العميل.

يمكن تنفيذ المراجعة ضمن خدمة إنشاء متجر Shopify. وقبل إضافة أي أداة، اقرأ المقال المكمل عن خصوصية العملاء والبيكسلات في Shopify، لأن وصول الحدث إلى الكود لا يعني دائمًا جواز إرساله.

لماذا يختلف البيكسل المخصص عن كود القالب؟

توضح وثائق Shopify الرسمية عن Web Pixels أن بيكسلات التطبيقات تعمل داخل Strict Sandbox، بينما يعمل Custom Pixel داخل Lax Sandbox مبني على إطار iframe. في الحالتين توجد حدود تمنع الاعتماد على الوصول الحر إلى DOM أو النافذة العليا. لذلك قد يعيد window.location عنوان البيئة المعزولة بدل عنوان صفحة المنتج، وقد لا يعمل كود يبحث عن زر بواسطة document.querySelector.

المصدر الموثوق هو حدث Shopify نفسه: اسم الحدث، الطابع الزمني، معلومات السياق، وعناصر السلة أو الطلب التي يتيحها الحدث. اجعل البيكسل يحول هذه البيانات إلى حمولة صغيرة وواضحة، ثم يرسلها إلى نقطة الجمع. لا تجمع حقولًا لمجرد أنها متاحة، ولا تسجل بيانات حساسة في Console.

كيف تبني حالة اختبار يمكن تكرارها؟

حدد جدولًا يربط كل إجراء متوقع بحدث واحد: مشاهدة المنتج، إضافة للسلة، بدء الدفع، وإتمام الطلب. لكل حدث اكتب الحقول المطلوبة، مثل معرف المنتج والكمية والعملة والقيمة. ثم حدد معيار نجاح مستقلًا: ظهور الحدث في سجل مؤقت، وخروج طلب شبكة واحد، واستجابة ناجحة من الخادم، وظهور الحدث في أداة الاختبار لدى المزود.

لا تستخدم أرقامًا أو بريدًا حقيقيًا. أنشئ منتجًا تجريبيًا وطلبًا في بيئة تسمح بالاختبار، واستخدم معرف اختبار واضحًا. كرر المسار مرة واحدة دون موافقة ومرة بعد الموافقة إذا كانت إعدادات المنطقة تتطلب ذلك، ثم قارن النتيجتين.

خطوات اختبار Custom Pixel في Shopify

  1. فعّل سجلًا مؤقتًا محدودًا: سجّل اسم الحدث ومعرف الاختبار فقط، ثم افتح أدوات المطور وتأكد أن الاشتراك يعمل في الصفحات المتوقعة.
  2. افحص تبويب Network: ابحث عن نطاق نقطة الجمع، وتأكد أن كل إجراء يرسل طلبًا واحدًا، وأن الحمولة تحمل الاسم والقيمة والعملة والمعرف الصحيح.
  3. راجع CORS والاستجابة: تشرح وثائق MDN الرسمية عن CORS أن المتصفح يقيد الطلبات بين النطاقات، وقد يرسل طلب OPTIONS تمهيديًا قبل الطلب الحقيقي. يجب أن يسمح الخادم بالأصل والطريقة والرؤوس المطلوبة.
  4. اختبر التسلسل والخصوصية: نفّذ رحلة كاملة، وراقب أن حدث الشراء يأتي بعد نجاح الطلب، وأن الكود لا يرسل قبل الموافقة المطلوبة.
  5. أوقف السجل المؤقت: بعد النجاح احذف أي تسجيل تشخيصي، واحتفظ فقط بمراقبة أخطاء لا تكشف بيانات العميل.

استخدام mode: "no-cors" ليس حلًا عامًا؛ فهو يعطي استجابة مبهمة ويقيد الرؤوس والطرق، وقد يخفي المشكلة بدل إصلاحها. اضبط نقطة الجمع لتعيد رؤوس CORS الصحيحة، أو استخدم تكامل تطبيق مناسبًا عندما تحتاج صلاحيات أوسع.

كيف تفسر الأخطاء الشائعة؟

إذا ظهر الحدث في Console ولم يظهر طلب شبكة، فراجع الشرط الذي يمنع الإرسال وصيغة عنوان النقطة. إذا خرج OPTIONS وفشل، فالمشكلة غالبًا في إعدادات CORS. إذا وصل الطلب بقيمة صفرية، فقارن نوع الحقول: قد تكون القيمة نصًا أو قد تكون العملة غير موجودة في الحدث الذي اخترته. وإذا وصل الشراء مرتين، فافحص وجود بيكسل تطبيق وبيكسل مخصص يرسلان الحدث نفسه.

لا تعتمد على إعادة تحميل صفحة الشكر مرات متعددة؛ بعض منصات القياس قد تستقبل الحدث مجددًا. استخدم معرف طلب ثابتًا كمرجع لإزالة التكرار لدى الوجهة إذا كانت تدعم ذلك. وراقب الاختلاف بين بيئة المعاينة والمتجر الفعلي، خصوصًا في سياسات المتصفح والكوكيز.

مثال افتراضي وقائمة مراجعة

مثال افتراضي: متجر أضاف Custom Pixel يرسل checkout_completed إلى نقطة خارجية. ظهر الحدث في السجل، لكن Network أظهر فشل OPTIONS. اكتشف الفريق أن الخادم يسمح بطريقة POST ولا يجيب عن الطلب التمهيدي. بعد ضبط رؤوس CORS للأصل المحدد، وصل طلب واحد بقيمة الطلب وعملته. ثم اختُبر المسار دون موافقة فبقي الإرسال متوقفًا كما تتطلب الإعدادات. هذا اختبار تنفيذ، وليس ضمانًا لدقة الإسناد لدى منصة إعلانية.

قائمة مراجعة:

  • [ ] كل حدث مرتبط بإجراء واضح.
  • [ ] الحقول المطلوبة موثقة قبل كتابة الكود.
  • [ ] لا توجد قراءة مباشرة غير ضرورية من DOM.
  • [ ] الطلب الشبكي يخرج مرة واحدة فقط.
  • [ ] CORS يسمح بالأصل والطريقة والرؤوس المطلوبة.
  • [ ] القيمة والعملة ومعرف المنتج صحيحة.
  • [ ] الموافقة تمنع الإرسال عند الحاجة.
  • [ ] حُذفت السجلات التي قد تكشف بيانات.
  • [ ] اختُبر البيكسل مع إضافات القياس الأخرى لمنع التكرار.

النجاح الحقيقي هو مسار يمكن إعادة اختباره: إجراء معروف، حدث صحيح، طلب واحد، واستجابة قابلة للتفسير.

المراجع والمصادر

محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.

نسمعك

اكتب سؤالك أو ملاحظتك. يُنشر التعليق بعد المراجعة، ويبقى البريد خاصًا.