لو عندك متجر شوبيفاي في السعودية أو الإمارات اتعمله تخصيص من كام سنة، فغالباً كود تتبع المبيعات كان محطوط في صفحة الشكر. الكود ده بطّل يشتغل، وممكن تكون إعلاناتك بتصرف من غير ما تعرف أنهي إعلان جاب الطلب. الحل اسمه البكسل المخصص (Custom Pixel)، وهنبنيه خطوة بخطوة.
بصراحة: هذا المقال مبني على توثيق شوبيفاي الرسمي وعلى تجربة مطوّر منشورة، لا على متجر جرّبناه بأنفسنا. الأكواد منقولة كما هي من المصدر، فاختبرها في وضع الدفع التجريبي قبل الاعتماد عليها.
لماذا توقف كود التتبع القديم؟
كانت المتاجر تضع كود التتبع في أحد مكانين: داخل ملف checkout.liquid (لمتاجر Plus)، أو في مربع «السكربتات الإضافية» (Additional Scripts) في صفحة الشكر. شوبيفاي ألغت الاثنين لصالح نظام توسعة صفحة الدفع (Checkout Extensibility):
| ما توقف | لمن | التاريخ |
|---|---|---|
checkout.liquid في خطوات البيانات والشحن والدفع | متاجر Plus | 13 أغسطس 2024 |
| السكربتات في صفحة حالة الطلب | متاجر Plus | 28 أغسطس 2025 |
| السكربتات في صفحة حالة الطلب | بقية المتاجر | 26 أغسطس 2026 |
بحسب توثيق شوبيفاي للمطوّرين، البديل نوعان: إضافات واجهة لما يظهر للعميل، ووحدات البكسل (Web Pixels) لكل ما يخص التحليلات وقياس التحويلات. أي أن المعركة انتهت، وكل متجر الآن على النظام الجديد سواء انتقل بإرادته أم لا.
قبل أن تكتب كوداً: هل تحتاج بكسلاً مخصصاً أصلاً؟
إذا كانت الأداة التي تتبعها منصة كبيرة مثل Google Ads أو Meta أو TikTok أو Snapchat، فابحث أولاً عن تطبيقها الرسمي في متجر تطبيقات شوبيفاي. بكسل التطبيق يُثبَّت بلا كود ويحدّثه صاحبه، وشوبيفاي نفسها توصي بمراجعة التطبيقات المتاحة قبل بناء بكسل مخصص.
البكسل المخصص مكانه ما لا يغطيه أي تطبيق: إرسال الطلبات إلى نظامك الداخلي أو إلى ERP، أو إلى أداة تحليل محلية، أو إلى خادم تملكه. وهو متاح ضمن خطط شوبيفاي العادية لا في Plus وحدها، فلا اشتراك إضافياً تدفعه.
تنبيه: شوبيفاي لا تقدم دعماً فنياً للبكسل المخصص، وتعتبر صاحب المتجر مسؤولاً عن الكود وأمانه وتوافقه مع قوانين الخصوصية. إن لم يكن في فريقك من يكتب JavaScript، فالتطبيق الجاهز أوفر.
كيف يختلف البكسل عن السكربت القديم؟
ستجد وحدات البكسل في لوحة التحكم تحت الإعدادات ← أحداث العملاء (Customer Events)، ومنها تضيف بكسلاً مخصصاً فيفتح لك محرر كود وإعدادات خصوصية. الفرق الجوهري في نقطتين:
- البكسل يعمل في بيئة معزولة (Sandbox). لا يرى عناصر صفحة الدفع ولا يعدّلها، فلا يوجد
document.querySelectorيقرأ الإجمالي من عنوان في الصفحة. تحصل على بيانات الحدث فقط. - البكسل يستمع للأحداث. بدل أن يعمل مرة عند تحميل الصفحة، تشترك في أحداث قياسية مثل
page_viewedوproduct_added_to_cartوcheckout_startedوcheckout_completed.
المعنى العملي: أي سكربت قديم كان يلمس الصفحة نفسها، كاستبيان بعد الشراء أو قراءة رقم من عنصر HTML، لن ينجح نسخه كما هو. ما يظهر للعميل صار مكانه إضافات واجهة الدفع أو كتل التطبيقات في صفحة الشكر.
خطوات بناء بكسل تتبع المشتريات في شوبيفاي
Shopify Custom Pixel
5 خطوات لتتبع المشتريات بلا تكرار
دوّن الحقول القديمة
رقم الطلب والإجمالي والعملة والمنتجات، فهي خطة الاختبار.
اكتب البكسل
اشترك في checkout_completed وأرسل البيانات بـ keepalive.
اضبط الخصوصية
الإذن وبيع البيانات بما يطابق شريط الموافقة وقوانين سوقك.
امنع التكرار
فهرس فريد على order_id في خادم الاستقبال.
اختبر بطلب تجريبي
نافذة خاصة، كوبون، عملة ثانية، وإعادة تحميل صفحة الشكر.
1. دوّن ما كان يرسله الكود القديم
قبل أن تحذف شيئاً، افتح السكربت القديم واكتب قائمة بالحقول التي كان يرسلها: رقم الطلب، والإجمالي، والعملة، وربما قائمة الـ SKU. هذه القائمة هي خطة الاختبار التي ستقارن بها لاحقاً.
2. اكتب البكسل
هذا بكسل بسيط يرسل كل عملية شراء إلى نقطة استقبال تملكها، كما نشره كاتب المصدر:
analytics.subscribe("checkout_completed", (event) => {
const checkout = event.data.checkout;
const payload = {
order_id: checkout.order && checkout.order.id,
value: checkout.totalPrice && checkout.totalPrice.amount,
currency: checkout.currencyCode,
items: (checkout.lineItems || []).map((li) => ({
sku: li.variant && li.variant.sku,
quantity: li.quantity,
price: li.variant && li.variant.price && li.variant.price.amount,
})),
sent_at: event.timestamp,
};
fetch("https://collect.example.com/purchase", {
method: "POST",
keepalive: true,
headers: { "Content-Type": "application/json" },
body: JSON.stringify(payload),
});
});
ثلاث ملاحظات على هذا الكود:
- كل حقل محميّ بفحص وجوده، لأن الطلب الرقمي بلا شحن، والطلب المجاني قد يكون إجماليه صفراً، والتوثيق الرسمي يصف حقلي
orderوvariantبأنهما قد يكونان فارغين. - الخيار
keepalive: trueيسمح للطلب بالاكتمال حتى لو أغلق العميل الصفحة فور ظهور صفحة الشكر. - لا مفاتيح سرية داخل البكسل. الكود يصل إلى متصفح العميل ويمكن لأي أحد قراءته. إن احتاج خادمك للتحقق، فافحص الطلبات عنده بالمصدر وحدود المعدل بدل إرسال مفتاح API.
ملاحظة: بحسب توثيق شوبيفاي، الحدث
checkout_completedيُطلق مرة واحدة لكل عملية دفع، وعادة في صفحة الشكر. لكن إن كان متجرك يعرض عرضاً إضافياً بعد الشراء (Upsell)، فالحدث يُطلق في أول صفحة عرض لا في صفحة الشكر. ضع هذا في حسابك عند الاختبار.
3. اضبط إعدادات الخصوصية
لكل بكسل مخصص إعداد تحت خصوصية العميل ← الإذن يحدد متى يعمل بالنسبة لموافقة الزائر على ملفات تعريف الارتباط. البكسل الجديد يُضبط افتراضياً على فئتي «التسويق» و«التحليلات»، وهناك إعداد منفصل هو بيع البيانات يُعتبر فيه البكسل الجديد افتراضياً من بيع البيانات.
طابق هذه الإعدادات مع شريط الموافقة في متجرك ومع قوانين البلد الذي تبيع فيه. في السعودية مثلاً يوجد نظام حماية البيانات الشخصية الذي تشرف عليه SDAIA، وفي الإمارات قانون اتحادي لحماية البيانات، وإن كنت تبيع لأوروبا فهناك GDPR. لا نفسّر هنا أياً منها: اسأل مستشارك القانوني، واعلم أن اختيار الإعداد الأشد قد يقلل عدد المشتريات المسجّلة لأن من يرفض الموافقة لن يُتتبع.
4. امنع تكرار الطلب على الخادم
لا تفترض أن كل طلب يصلك عملية بيع جديدة. العميل قد يعيد تحميل الصفحة، والمتصفح قد يعيد المحاولة، وقد يكون لديك بكسل تطبيق يبلغ عن الطلب نفسه. الحل أن تجعل نقطة الاستقبال تتمتع بخاصية عدم التكرار (Idempotency): الطلب برقم سبق تسجيله يُرفض بهدوء.
هذا مخطط مبسّط بأسلوب Flask من المصدر:
# collector (Flask-style sketch)
seen = set() # use a database table with a unique index in production
@app.post("/purchase")
def purchase():
data = request.get_json(force=True)
oid = str(data.get("order_id") or "")
if not oid:
return ("missing order id", 400)
if oid in seen:
return ("duplicate", 200)
seen.add(oid)
save_purchase(data)
return ("ok", 201)
في بيئة الإنتاج استبدل المجموعة seen بجدول في قاعدة البيانات عليه فهرس فريد (Unique Index) على order_id، فيؤدي المهمة نفسها ويبقى بعد إعادة تشغيل الخادم.
في ووردبريس: إن كان لديك متجر WooCommerce أيضاً، فالمنطق نفسه ينطبق هناك: أي كود يرسل الطلب من صفحة الشكر قد يُنفَّذ مرتين عند إعادة التحميل، فاعتمد على رقم الطلب لمنع التكرار في الجهة المستقبِلة.
5. اختبر كأنك عميل
- فعّل وسيلة دفع تجريبية، كبوابة شوبيفاي التجريبية أو وضع الاختبار لدى مزود الدفع.
- افتح المتجر في نافذة خاصة، واقبل أو ارفض ملفات تعريف الارتباط كما يفعل زائر حقيقي، ثم أتمّ طلباً.
- افتح أدوات المطوّر (DevTools) وفلتر تبويب Network باسم نطاق خادمك. البكسل يعمل داخل إطار معزول، فالفلترة بالرابط أسهل من البحث بين الإطارات.
- قارن ما أُرسل بالقائمة التي دوّنتها في الخطوة الأولى: رقم الطلب، والإجمالي، والعملة، والمنتجات.
- أعد تحميل صفحة الشكر وتأكد أن خادمك سجّل «مكرر» لا عملية بيع ثانية.
- كرر التجربة بكوبون خصم، وبعملة ثانية إن كنت تبيع بالريال السعودي والدرهم الإماراتي عبر Shopify Markets، ومن متصفح موبايل.
لا تحذف مراجع الكود القديم من توثيقك أو من Tag Manager إلا بعد أن تتطابق الأرقام.
ثلاثة أخطاء تكلفك أرقاماً خاطئة
- نسخ السكربت القديم سطراً بسطر. أي جزء كان يقرأ من الصفحة أو يضيف لها عنصراً لن يعمل داخل البيئة المعزولة.
- نسيان الأسواق الأخرى. متجر يبيع في السعودية والإمارات والكويت يتعامل بأكثر من عملة، والأسعار ورمز العملة يتغيران حسب السوق. اختبر عملة غير الافتراضية مرة على الأقل.
- بكسل بلا مسؤول. البكسل الذي لا يراقبه أحد يتعطل بصمت. أضف فحصاً يومياً يقارن عدد المشتريات التي استقبلها خادمك بعدد الطلبات في تقارير شوبيفاي.
اقرأ أيضًا
الأسئلة الشائعة
س: هل أحتاج Shopify Plus لاستخدام البكسل المخصص؟
ج: لا. البكسل المخصص متاح تحت «أحداث العملاء» في الخطط العادية أيضاً. ما يقتصر على Plus هو تخصيص خطوات الدفع نفسها بالتطبيقات والإضافات.
س: هل يستطيع البكسل المخصص تغيير ما يراه العميل في صفحة الدفع؟
ج: لا. البكسل يراقب الأحداث فقط داخل بيئة معزولة. أي تغيير مرئي يحتاج محرر الدفع أو كتل التطبيقات أو إضافات واجهة الدفع.
س: لماذا تظهر مبيعاتي مضاعفة في أداة التحليل؟
ج: غالباً لأن الطلب يُرسل من أكثر من مصدر، كبكسل تطبيق وبكسل مخصص معاً، أو لأن صفحة الشكر أُعيد تحميلها. امنع التكرار برقم الطلب في الجهة المستقبِلة.
س: هل أحتفظ بكود التتبع القديم احتياطاً؟
ج: الكود لم يعد يعمل في صفحة الدفع، وبقاؤه يربك أي شخص يراجع المتجر لاحقاً. احفظ نسخة منه في مستودع الكود ثم احذفه.
س: ما علاقة البكسل بواجهات Conversion API الخاصة بمنصات الإعلانات؟
ج: الاثنان يكمّلان بعضهما. أرسل رقم الطلب نفسه من البكسل ومن الخادم، لتتمكن منصة الإعلانات من حذف التكرار بينهما.
الخلاصة
البكسل المخصص ليس نسخة جديدة من السكربت القديم، بل طريقة مختلفة: يستمع لحدث checkout_completed داخل بيئة معزولة، ويرسل الطلب إلى خادم يمنع التكرار برقم الطلب. القرار بسيط: لمنصات الإعلانات الكبرى استخدم تطبيقها الرسمي، وللباقي ابنِ بكسلاً مخصصاً واختبره بطلب تجريبي.
افتح «أحداث العملاء» في متجرك النهارده، وشوف إيه اللي لسه بيتتبع وإيه اللي وقف من غير ما تحس.
مراجع إضافية: checkout_completed — Shopify Web Pixels API، Order status script tags — Shopify Developers، إنشاء رمز بكسل مخصص — مركز مساعدة Shopify
مرجع المقال (بالإنجليزية): After checkout.liquid: rebuilding Shopify purchase tracking as a custom pixel
المقال ده مش ترجمة حرفية: متكيّف للقارئ العربي ومضاف عليه سياق ووردبريس وElementor وJetEngine.


