ترحيل البكسلات

إذا أضفت سابقًا بكسل يدويًا إلى متجرك في مواقع مثل theme.liquid أو checkout.liquid (في خطة Shopify Plus فقط) أو النصوص البرمجية الإضافية في إعدادات الدفع أو صفحة التفضيلات، فيمكنك ترحيل بكسلاتك لتصبح متوافقة مع بكسل تطبيق Shopify أو بكسل مخصص. تتضمن بعض فوائد ترحيل بكسلاتك القديمة ما يلي:

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

تعرّف على المزيد حول مدير بكسل Shopify، والفوائد الكاملة للترحيل إلى بكسلات تطبيق Shopify أو البكسلات المخصصة.

ترحيل بكسلات Meta وGoogle من صفحة التفضيلات

تمت ترقية إعدادات إدارة بكسل Meta وGoogle Analytics في مسؤول Shopify الخاص بك من أجل الامتثال لأحدث معايير ولوائح الأمان الخاصة بمعيار أمان بيانات صناعة بطاقات الدفع (PCI DSS). يضمن هذا التغيير بقاء معلومات عملك وعملائك آمنة ضد اختراقات البيانات والاحتيال. تعرّف على المزيد حول كيفية مساعدة Shopify لمتجرك في البقاء متوافقًا مع الإصدار الرابع من معيار PCI DSS.

للحصول على أدق تتبع وأفضل أداء، قم بترحيل البكسل إلى إحدى القنوات التالية:

• ترحيل بكسل Meta إلى قناة Facebook & Instagram.
• ترحيل بكسل Google Analytics إلى قناة Google & YouTube.

ترحيل بكسل Google Analytics إلى تطبيق قناة Google & YouTube

إذا لم تقم بنقل علامتك إلى تطبيق قناة Google & YouTube، فقد تم تحويلها إلى بكسل مخصص لمحاولة استمرارية القياس. قد يؤدي هذا إلى تراجع في أداء وميزات القياس في Google Analytics. على وجه التحديد، يمكنك توقع التأثير التالي:

• قد تتغير البيانات المُبلَّغ عنها في Google Analytics (أو قد تُفقد في بعض الحالات) بسبب الاختلافات في قياس الأحداث وسلوك العلامة.
• قد لا تعمل الميزات الأساسية لـ Google Analytics، مثل القياس المُحسّن والقياس عبر النطاقات، بشكل صحيح.
• قد لا يعمل Tag Assistant، أو قد يُبلِغ عن علامة GA4 الخاصة بك بشكل غير صحيح.
• قد لا تتعرف Tag Diagnostics على علامة GA4 الخاصة بك بشكل صحيح، أو قد توصي بميزات لا تعمل لديك.
• سيتم حذف الإعدادات التي أضفتها سابقًا إلى قسم Additional Google Analytics Javascript.
• قد تتغير طريقة معالجة الموافقة لعلامة Google Analytics الخاصة بك.

ترحيل بكسل قديم من ملف theme.liquid أو checkout.liquid أو النصوص البرمجية الإضافية

يمكنك القيام بأي مما يلي عند ترحيل بكسل قديم من ملف theme.liquid أو checkout.liquid أو النصوص البرمجية الإضافية:

• ترحيل بكسل قديم ليكون متوافقًا مع بكسل تطبيق
• ترحيل بكسل قديم إلى بكسل مخصص

لتجنب تكرار أو فقدان أحداث العملاء، فكّر في ترحيل بكسلاتك خلال فترة أقل ازدحامًا في متجرك.

الاستعداد لترحيل البكسل

ضع ما يلي في الاعتبار عند تحديد سير عمل الترحيل:

• إذا كنت تريد تقليل احتمالية فقدان أي أحداث للعملاء، فقم بتوصيل البكسل المخصص الجديد قبل إزالة البكسل القديم.
• إذا كنت ترغب في تجنب تكرار تتبع أحداث العملاء، فقم بتوصيل البكسل المخصص الجديد بعد إزالة البكسل القديم.
• لكي تتمكن من ترحيل بكسل قديم، يجب عليك العثور على كود البكسل القديم لتتمكن من إزالته أو تعديله. تحتوي معظم البكسلات على مكونين ستحتاج إلى العثور عليهما:
  • Javascript SDK الأساسي: غالبًا ما يتم وضع Javascript SDK في ترويسة الموقع (header)، ويمكن العثور عليه في ملف theme.liquid وفي النصوص البرمجية الإضافية ضمن إعدادات الدفع.
  • كود البكسل القديم لجمع أحداث العملاء: يمكنك عادةً العثور على هذا الكود في ملفات liquid الخاصة بقالبك، وفي النصوص البرمجية الإضافية ضمن إعدادات الدفع. ارجع إلى وثائق مزوّد البكسل التابع لجهة خارجية لمعرفة كيفية تحديد مواقع أحداث العملاء حتى تعرف ما الذي تبحث عنه. على سبيل المثال، يحتوي بكسل Meta على طريقة تُسمى fbq()، وغالبًا ما تستخدم بكسلات Google كلًا من gtag() أو dataLayer.push().

ترحيل بكسل قديم ليكون متوافقًا مع بكسل تطبيق

قد ترغب في ترحيل بكسل قديم ليكون متوافقًا مع بكسل تطبيق في حال انطبق كلا الشرطين التاليين:

• قمت بتثبيت بكسل تطبيق Shopify يجمع أحداث العملاء تلقائيًا.
• أضفت أيضًا بعض الأكواد الإضافية لأحداث مخصصة لا يتم تتبعها بواسطة بكسل التطبيق.

في هذه الحالة، يجب عليك اتباع تعليمات مطور التطبيق لترحيل البكسل القديم.

ترحيل بكسل قديم إلى بكسل مخصص

قد ترغب في ترحيل بكسل قديم إلى بكسل مخصص في حال انطبق كلا الشرطين التاليين:

• أن يكون لديك بكسل تم تثبيته مسبقًا قمت بكتابة الكود الخاص به يدويًا، دون تثبيت أي تطبيق Shopify.
• ألا يوجد بكسل تطبيق Shopify يلبي متطلباتك.

يمكنك توصيل البكسل المخصص الجديد قبل أو بعد إزالة كود البكسل القديم.

الخطوات:

1. قم بإنشاء بكسل مخصص يشترك في أحداث العملاء القياسية والمخصصة المطلوبة.
2. أزِل، أو استبدل أي رمز بكسل تمت إضافته سابقًا من ملفات Liquid أو النصوص البرمجية الإضافية في إعدادات الدفع. قد يتضمن هذا رمز البكسل القديم الذي يتضمن Javascript SDK، أو يجمع الأحداث القياسية، أو يجمع الأحداث غير القياسية.
3. أضف البكسل المخصص إلى متجرك.
4. اربط البكسل المخصص الخاص بك.

إزالة رمز البكسل القديم أو استبداله

عند عثورك على رمز البكسل القديم، ستحتاج إما إلى إزالته، أو استبداله بطريقة Shopify.analytics.publish() الخاصة بـ Shopify، وذلك بناءً على نوع الحدث الذي يتتبعه البكسل:

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

هذا مثال على رمز بكسل قديم يتتبع حدث عميل غير قياسي:

<script>fbq("trackCustom", "my_custom_event");</script>

هذا مثال على الرمز المكافئ الذي يجب استبداله به:

<script>Shopify.analytics.publish("my_custom_event");</script>

إذا كنت تُنشئ بكسل مخصصًا، فيجب عليك تضمين رمز يشترك في الحدث المخصص، كما في هذا المثال:

analytics.subscribe("my_custom_event", event => {
  fbq("trackCustom", "my_custom_event");
});

استكشاف الأخطاء وإصلاحها بعد الترحيل

بعد الترحيل إلى بكسلات الويب، قد تلاحظ اختلافات في عدد الأحداث التي تم تتبعها مقارنة بإعدادك السابق. نظرًا لأن بعض برامج الروبوت (bots) لا تقوم بتشغيل بيئة وضع الحماية لبكسل الويب، فمن المتوقع حدوث انخفاضات بنسبة مئوية من رقم واحد في أعداد الأحداث. إذا كنت ترى تفاوتات أكبر، فراجع هذا القسم لمعرفة الأسباب المحتملة.

استخدم قائمة التحقق التالية للمساعدة في تحديد مصدر التفاوت:

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

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