سكربتات القياس خارج الخيط الرئيسي: Partytown لمتجرك
باختصار: كثير من مواقع المتاجر والمطاعم والعيادات في الأردن تحمل في رأس الصفحة سكربتات من جهات خارجية: Google Tag Manager وبكسل فيسبوك وأدوات قياس أخرى. هذه السكربتات تعمل على الخيط الرئيسي للمتصفح، أي الخيط نفسه الذي يرسم الصفحة ويستجيب للمسات الزبون، فتنافس قائمة الطعام وزر الإضافة إلى السلة على وقت المعالج. مكتبة Partytown مفتوحة المصدر تقترح حلاً: تشغيل سكربتات مختارة داخل Web Worker بدل الخيط الرئيسي. في هذا المقال نشرح كيف تعمل، وكيف تفعّلها لسكربت واحد، ولماذا تناسب سكربتات القياس ولا تناسب أدوات المحادثة والنوافذ، وما الذي يجب اختباره قبل الاعتماد عليها.
المشكلة: سكربتات القياس تشارك صفحتك المعالج
المتصفح ينفذ جافاسكربت الصفحة في خيط رئيسي واحد. عندما يحمّل سكربت تتبع ضخماً ويحلله وينفذه، لا يستطيع المتصفح في اللحظة نفسها معالجة ضغطة الزبون على زر. على حاسوب قوي لا يلاحظ أحد. على جوال متوسط في يد زبون يتصفح قائمة مطعمك قبل أن يطلب، قد تشعر الصفحة بثقل أو تأخر في الاستجابة.
الحل الأول دائماً هو التنظيف: احذف السكربتات التي لم يعد أحد ينظر إلى تقاريرها. لكن بعد التنظيف تبقى سكربتات تحتاجها فعلاً لقياس الحملات الإعلانية. هنا يأتي سؤال نقلها خارج الخيط الرئيسي.
كيف تعمل Partytown
يشرح توثيق Partytown أن التواصل بين الخيط الرئيسي وخيط العامل يكون تقليدياً غير متزامن، أي لا يمكن استخدام استدعاءات تنتظر النتيجة. وسكربتات الجهات الخارجية مكتوبة على افتراض أنها تصل إلى DOM مباشرة وبشكل متزامن، لذلك لا تعمل عادة داخل Web Worker.
Partytown مختلفة بحسب توثيقها: تسمح للكود المنفذ في العامل بالوصول إلى DOM بشكل متزامن، فتستمر سكربتات الجهات الخارجية بالعمل كما كُتبت. وتعتمد على Web Workers وService Workers وJavaScript Proxies وطبقة تواصل بينها، مع طريقتين حالياً للتواصل المتزامن: طلبات XHR متزامنة مع Service Worker، أو Atomics.
التفعيل اختياري لكل سكربت
نقطة مهمة في التوثيق: Partytown لا تنقل كل السكربتات إلى العامل تلقائياً. تُفعّل فقط للسكربتات التي تحمل السمة type="text/partytown". هذه السمة تفعل أمرين: تمنع الخيط الرئيسي من تنفيذ السكربت، وتوفر محدداً تبحث به Partytown عن السكربتات التي ستشغلها.
مثال توضيحي لسكربت قياس في متجر:
<script type="text/partytown" src="https://example.com/analytics.js"></script>
بقية سكربتات موقعك تبقى كما هي. ويذكر التوثيق أيضاً خطوة نسخ ملفات المكتبة إلى موقعك، وقائمة تكاملات جاهزة لأطر وأنظمة مختلفة منها WordPress، فابدأ من الدليل الخاص بنظامك بدل الكتابة اليدوية.
تمرير الاستدعاءات: forward
سكربتات مثل Google Tag Manager وبكسل فيسبوك تضيف فور تحميلها متغيرات إلى window، مثل مصفوفة dataLayer ودالة fbq، وكود موقعك يستدعيها عند كل حدث مهم، كإضافة منتج إلى السلة. يوضح توثيق Partytown أنه بما أن هذه الخدمات تُحمّل في العامل، يجب تمرير هذه الاستدعاءات إليه، عبر إعداد forward الذي يحدد أي متغيرات window تُعدّل وتُمرر:
<script>
partytown = { forward: ['dataLayer.push', 'fbq'] };
</script>
ويذكر التوثيق أن قيم forward نصوص لا كائنات، كي يسهل تسلسل اسم الدالة وقيم معاملاتها وإرسالها إلى العامل.
المقايضات التي يذكرها التوثيق نفسه
صفحة المقايضات في توثيق Partytown صريحة، وهذه أهم نقاطها لصاحب موقع:
- طلبات proxytown في لوحة الشبكة: قد ترى مئات الطلبات بهذا الاسم. يوضح التوثيق أن Service Worker يعترضها ويعالجها محلياً، وأنها ليست طلبات HTTP خارجية.
- عمليات DOM أبطأ عمداً: عمليات DOM داخل العامل تُبطأ عمداً مقارنة بالخيط الرئيسي، لأن البيانات تُرسل وتُستقبل بين خيطين.
- السكربتات كثيفة الواجهة: السكربت الذي يبني تطبيقاً صغيراً داخل صفحتك، مثل نافذة منبثقة فيها نموذج، قد لا يناسب Partytown. وكذلك السكربتات التي تضيف عدداً كبيراً من العناصر إلى الصفحة.
- الأنسب لها: بحسب التوثيق، سكربتات مثل Google Tag Manager وبكسل فيسبوك، لأنها تتعامل مع أحداث المستخدم وترسل البيانات إلى خدماتها في الخلفية.
- سكربتات دون ترويسات CORS: ليست كل السكربتات ترسل ترويسات CORS الصحيحة، ولها قسم خاص في التوثيق عن تمرير الطلبات عبر وكيل.
- منع السلوك الافتراضي لا يعمل: إذا استدعى سكربت خارجي event.preventDefault() على حدث، فلن يكون له أثر.
- الإطارات من أصل آخر: إن أنشأت Partytown إطار iframe من أصل آخر، فلا تستطيع قراءة ملفات تعريف الارتباط والتخزين الخاصة به أو تعديلها.
ماذا تنقل وماذا تترك
قاعدة عملية مبنية على ما سبق:
- انقل: سكربتات القياس والبكسلات التي ترسل الأحداث فقط ولا تعرض شيئاً للزبون.
- اترك على الخيط الرئيسي: أداة المحادثة المباشرة، وأداة الحجز المضمنة، ونوافذ الاشتراك في القائمة البريدية، وأي سكربت يعرض عناصر للزبون أو يمنع سلوك الروابط.
خطوات تجربة آمنة
- اختر سكربت قياس واحداً فقط للبداية، لا كل السكربتات.
- فعّل Partytown على نسخة تجريبية من موقعك، لا على الموقع الحي مباشرة.
- افتح أداة المعاينة في خدمة القياس وتأكد أن زيارة الصفحة وإضافة منتج إلى السلة وإتمام الطلب تصل كلها.
- قارن أرقام الأحداث في التقارير يوماً كاملاً قبل التعديل وبعده؛ إن نقصت فهناك استدعاء لم يُمرر.
- قِس استجابة الصفحة على جوال متوسط قبل التعديل وبعده بدل افتراض التحسن.
أخطاء شائعة
- نقل كل السكربتات دفعة واحدة، ثم صعوبة معرفة أيها توقف عن العمل.
- نسيان إعداد forward، فتصل زيارات الصفحات ولا تصل أحداث الإضافة إلى السلة وإتمام الطلب، فتبدو الحملات الإعلانية فاشلة وهي ليست كذلك.
- إبقاء نسخة عادية من السكربت نفسه إلى جانب نسخة Partytown، فتُحسب الأحداث مرتين.
- الحكم على النتيجة من لوحة الشبكة وحدها والانزعاج من طلبات proxytown، بدل قياس استجابة الصفحة نفسها.
- تفعيل المكتبة دون إخبار من يدير الحملات الإعلانية، فيلاحظ تغيراً في الأرقام ولا يعرف سببه.
من يجب أن يكون في الصورة
نقل سكربتات القياس ليس قراراً تقنياً بحتاً. الشخص أو الوكالة التي تدير إعلاناتك تعتمد على هذه الأحداث لتقييم الحملات. أخبرهم بموعد التجربة، واطلب منهم مراجعة الأحداث معك في الأيام الأولى.
متى لا تحتاج Partytown أصلاً
إذا كان موقعك يحمل سكربت قياس واحداً خفيفاً، فقد لا يستحق الأمر طبقة إضافية من التعقيد. وإذا كانت مشكلتك صوراً ثقيلة أو خادماً بطيئاً، فلن تحلها Partytown. هي أداة لمشكلة محددة: سكربتات جهات خارجية تحتاجها، وتثقل الخيط الرئيسي، ولا تعرض شيئاً للزبون.
أسئلة شائعة
هل تنقل Partytown كل سكربتات موقعي إلى العامل؟
لا. بحسب توثيقها، تعمل فقط على السكربتات التي تحمل type="text/partytown".
هل يمكن نقل أداة المحادثة المباشرة إليها؟
التوثيق ينبه إلى أن السكربتات كثيفة الواجهة، مثل التي تعرض نافذة بنموذج، قد لا تناسبها. الأسلم إبقاء أدوات المحادثة على الخيط الرئيسي.
لماذا أرى طلبات كثيرة باسم proxytown؟
يوضح التوثيق أن Service Worker يعترضها ويعالجها محلياً، وأنها ليست طلبات خارجية.
هل ستبقى أحداث الحملات الإعلانية تصل؟
يجب أن تصل إن مررت الاستدعاءات بإعداد forward بشكل صحيح، لكن تحقق بنفسك من أداة المعاينة والتقارير قبل الاعتماد على ذلك.
إذا كانت سكربتات القياس والإعلانات تثقل موقعك على الجوال، اطلب منا مراجعة ما يُحمّل في صفحاتك.