اختبار البكسلات المخصصة

بعد إنشاء بكسل مخصص، يجب عليك اختباره للتأكد من أن البكسل يرسل البيانات بشكل صحيح عند وقوع أحداث على موقعك.

يمكنك استخدام Shopify Pixel Helper لاختبار ما إذا كانت أحداث البكسل تُحمّل وأنك اشتركت في أحداث Shopify بشكل صحيح. يتيح لك Shopify Pixel Helper اختبار البكسل المخصص في متجرك الإلكتروني لعرض الأحداث التي يتم تلقيها في الوقت الفعلي، إلى جانب البيانات الخاصة بتلك الأحداث.

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

يمكنك استخدام Shopify Pixel Helper في نفس جلسة المتصفح مثل أداة مساعدة البكسلات التابعة لجهة خارجية لاختبار الأحداث لكلتا المنصتين في نفس الوقت.

إليك برنامجًا نصيًا لبكسل مخصص سيُشغّل جميع الأحداث القياسية إلى بيئة الاختبار المحمية ويسجّل بيانات الحدث في وحدة التحكم. ستكون الأحداث القياسية مرئية في Shopify Pixel Helper. بالإضافة إلى ذلك، يمكنك الاشتراك في اشتراكات مجمّعة أخرى، all_events، وall_custom_events، وall_dom_events، لاكتشاف كل ما يمكن أن توفره بكسلات الويب. تفضل بزيارة واجهة برمجة تطبيقات Web Pixels للحصول على مزيد من المعلومات.

analytics.subscribe("all_standard_events", event => {
   console.log("Event data ", event?.data);
});

التأكد من اتصال البكسل المخصص

قبل اختبار البكسل المخصص، تأكد من اتصال البكسل المخصص.

الخطوات:

1. من مسؤول Shopify، انتقل إلى الإعدادات > أحداث العميل.

2. بجانب البكسل الذي تريد اختباره، تحقق من أن البكسل يعرض حالة متصل في عمود الحالة.

3. إذا لم يكن البكسل متصلاً، فنفّذ الإجراءات التالية:

   1. انقر على > عرض التفاصيل.
   2. اختياري: راجع رمز البكسل الخاص بك وحدّثه، ثم انقر على حفظ.
   3. انقر على اتصال.
   4. في مربع حوار التأكيد، انقر على اتصال.

اختبار بكسل مخصص باستخدام Shopify Pixel Helper

بعد التحقق من اتصال البكسل المخصص الخاص بك، يمكنك استخدام Shopify Pixel Helper لاختبار ما إذا كان البكسل المخصص يرسل البيانات ويتلقى بيانات متجرك.

راجع الاعتبارات التالية قبل استخدام Shopify Pixel Helper:

• يمكنك اختبار بكسل مخصص واحد فقط في كل مرة باستخدام Shopify Pixel Helper.
• لا يمكنك إجراء تغييرات على البكسل الذي يتم اختباره عندما يكون Shopify Pixel Helper قيد التشغيل. لاختبار التغييرات الجديدة، احفظ البكسل الخاص بك، وأغلق علامة تبويب Shopify Pixel Helper، ثم افتح Shopify Pixel Helper مرة أخرى.
• يتم مسح سجلات الأحداث عند الانتقال إلى صفحة جديدة. على سبيل المثال، إذا قمت بإضافة منتج إلى سلة التسوق الخاصة بك وسجل Shopify Pixel Helper حدث product_added_to_cart، فسيتم مسح هذا السجل عند الانتقال إلى صفحة منتج جديدة أو صفحة سلة التسوق.
• لا يحتوي Shopify Pixel Helper على زر إغلاق. لإيقاف الاختبار، يجب عليك إغلاق علامة التبويب التي فتحها Shopify Pixel Helper.
• لا يتوافق Shopify Pixel Helper مع متاجر التجارة غير المترابطة (headless commerce) أو المتاجر المحمية بكلمة مرور.
• إذا كان متجرك الإلكتروني محميًا بكلمة مرور، ففكر في إزالة كلمة مرور متجرك الإلكتروني لاستخدام Shopify Pixel Helper.

الخطوات:

1. من مسؤول Shopify، انتقل إلى الإعدادات > أحداث العميل.

2. انقر على البكسل المخصص الذي تريد اختباره.

3. انقر على اختبار لفتح البكسل المخصص في موقعك الإلكتروني لاختباره.

4. اختياري: بناءً على إعدادات الموافقة في متجرك وإعدادات خصوصية العميل للبكسل المخصص، قد يعرض مربع الحوار مساعد البكسل رسالة البكسل في انتظار الموافقة. نفّذ أحد الإجراءات التالية لمتابعة الاختبار:

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

5. لعرض الأحداث التي يتم تحميلها، قم بزيارة كل صفحة تريد اختبار البكسل فيها، وراجع مربع الحوار مساعد البكسل لـ التأكد من الاشتراك في الحدث بنجاح ومن نجاح دالة الاستدعاء في قسم الأحداث المستلَمة:

   • انتقل إلى صفحة جديدة لاختبار حدث page_viewed.
   • انقر على منتج لاختبار حدث product_viewed.
   • أضف منتجًا إلى سلتك لاختبار حدث product_added_to_cart.
   • انتقل إلى صفحة الدفع لاختبار حدث checkout_started.
   • أدخل معلومات الشحن عند الدفع لاختبار أن حدث checkout_shipping_info_submitted يحل محل حدث checkout_started.
   • أكمل الدفع لاختبار أن حدث checkout_completed يحل محل حدث checkout_shipping_info_submitted. تعرف على المزيد حول إجراء طلب تجريبي.

6. لعرض بيانات الحدث المستلَمة، انقر على لتوسيع مربع حوار مساعد البكسل.

عرض قسم الأحداث المستلَمة

عند اختبار الأحداث التي يتم تحميلها في الخطوة 5، تظهر إحدى الحالات التالية في قسم الأحداث المستلَمة في مربع حوار مساعد البكسل:

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

analytics.subscribe("all_standard_events", event => {
  console.log("Event data ", event?.data);
  throw new Error("callback error");
});

throw new Error("top level error")

لمعرفة المزيد حول إصلاح أخطاء JavaScript، يُرجى زيارة استكشاف أخطاء JavaScript وإصلاحها.

استكشاف أخطاء البكسل المخصص وإصلاحها

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

مراجعة إعدادات خصوصية العميل

إذا لم يتم تحميل البكسل أو تشغيله أثناء الاختبار، فقد تكون هناك إعدادات لخصوصية العميل تمنعه من التحميل.

من مسؤول Shopify، انتقل إلى الإعدادات > خصوصية العميل للتحقق من إعدادات خصوصية العميل في مسؤول Shopify والتي قد تنطبق على جلستك. وبناءً على إعدادات خصوصية العميل لديك، اتخذ الخطوات التالية:

• إذا كانت لديك إعدادات لخصوصية العميل تتطلب الحصول على موافقة في منطقتك، فتأكد من تقديمك للموافقة من خلال لافتة ملفات تعريف الارتباط.
• إذا لم تكن لديك أي إعدادات لخصوصية العميل تمنع تحميل البكسل، فامسح ملفات تعريف الارتباط من متصفحك لإعادة تعيين لافتة ملفات تعريف الارتباط وتقديم الموافقة.
• إذا كنت تستخدم أداة تابعة لجهة خارجية لإدارة الموافقة، مثل تطبيق لافتة ملفات تعريف الارتباط، فيجب أن تقوم تلك الأداة بمزامنة الموافقة مع Shopify من خلال Customer Privacy API. إذا لم تتم مزامنة الموافقة مع Shopify، فقد لا يتم تشغيل البكسل الخاص بك حتى بعد أن يقدم العميل موافقته. تواصل مع مزوّد الجهة الخارجية للتأكد من مزامنة الموافقة مع Shopify، أو للحصول على دعم إضافي.

استكشاف أخطاء إضافية وإصلاحها

إذا كان لا يزال من غير الواضح ما إذا كان البكسل المخصص الخاص بك مشتركًا بشكل صحيح في حدث العميل، فجرب تدابير استكشاف الأخطاء وإصلاحها التالية:

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

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

اختبار مساعد بكسل تابع لجهة خارجية

تحتوي حزمة SDK (مجموعة تطوير البرامج) للبكسل على أدوات لجمع معلومات حول سلوك العميل. يمكنك استخدام مساعد البكسل من مزوّد البكسل التابع لجهة خارجية لاختبار السلوكيات التالية للبكسل الخاص بك والتأكد من أن حزمة SDK للبكسل تعمل كما هو متوقع:

• اختبار ما إذا كان قد تم تحميل حزمة SDK التابعة لجهة خارجية للبكسل
• اختبار ما إذا كان قد تمت تهيئة حزمة SDK التابعة لجهة خارجية للبكسل وتتلقى أحداثًا

اختبار ما إذا كان قد تم تحميل حزمة SDK التابعة لجهة خارجية للبكسل

تعتمد خطوات التحقق من علامة تبويب الشبكة (Network) على متصفح الويب الذي تستخدمه. على سبيل المثال، لمعرفة كيفية التحقق من علامة تبويب الشبكة في Google Chrome، راجع وثائق Chrome للمطورين بعنوان فحص نشاط الشبكة.

لاختبار تحميل حزمة SDK التابعة لجهة خارجية للبكسل، تحتاج أولاً إلى استرداد رمز المزوّد التابع لجهة خارجية لعنوان URL لحزمة SDK بحيث يمكنك إضافته إلى رمز البكسل الخاص بك. للحصول على الدعم، اتصل بمزوّد البكسل التابع لجهة خارجية.

الخطوات:

1. من مسؤول Shopify، انتقل إلى الإعدادات > أحداث العميل.

2. انقر على البكسل المخصص الذي تريد اختباره.

3. في قسم الرمز، أدخل حزمة SDK للبكسل التي قدمها مزوّد الجهة الخارجية في نهاية رمز البكسل الخاص بك.

4. انقر على حفظ.

5. قم بزيارة متجرك الإلكتروني، ثم تحقق من علامة تبويب الشبكة للتأكد من أنه يتم تنزيل عنوان URL لحزمة SDK الخاصة بمزوّد الجهة الخارجية.

6. اختياري: إذا لم يتم تحميل حزمة SDK التابعة لجهة خارجية للبكسل، فتحقق من أخطاء وقت تشغيل JavaScript في بيئة العزل (sandbox). على سبيل المثال، يمكنك في Chrome تحديد iFrame معيّن لمراجعة سجلات وحدة التحكم (console) الخاصة به، ثم تضييق نطاق السجلات لتقتصر على البكسل المحدد الذي تختبره. لمعرفة المزيد حول التحقق من أخطاء وقت تشغيل JavaScript في Chrome، راجع وثائق Chrome بعنوان تصحيح أخطاء JavaScript.

إذا لم يتم تحميل حزمة SDK التابعة لجهة خارجية للبكسل أثناء الاختبار، فتواصل مع مزوّد البكسل التابع لجهة خارجية للحصول على الدعم.

اختبارات أخرى لحزم SDK التابعة لجهة خارجية للبكسل

لاختبار ما إذا كان قد تمت تهيئة حزمة SDK التابعة لجهة خارجية للبكسل أو أنها تجمع الأحداث، راجع وثائق مزوّد البكسل التابع لجهة خارجية.

لاختبار ما إذا كانت حزمة SDK للبكسل تجمع الأحداث، قد يُطلب منك التحقق من علامة تبويب الشبكة في متصفحك. تعتمد خطوات التحقق من علامة تبويب الشبكة على متصفح الويب الذي تستخدمه. على سبيل المثال، لمعرفة كيفية التحقق من علامة تبويب الشبكة في متصفح Google Chrome، راجع وثائق Chrome للمطورين بعنوان فحص نشاط الشبكة.