الوسم من جانب الخادم لمتجر Shopify أو WooCommerce: ما الذي يُطلَق، وما الذي لا يُطلَق، وما الذي تثبّته

يحدد GA4 سبعة أحداث لمسار الشراء: view_item_list و view_item و add_to_cart و remove_from_cart و begin_checkout و add_payment_info و purchase. الأسماء أسماء GA4 لا أسماء أي منصة — السبعة نفسها تعمل مع Shopify وWooCommerce ومتجر بنيته بنفسك.

ما تتشاركه هو الآلية. كل واحد منها دفعٌ إلى dataLayer الصفحة، بهذا الاسم بالضبط، يحمل كائن ecommerce بشكل GA4. مشغّل في Tag Manager يستمع للاسم؛ ووسم حدث GA4 يقرأ كائن ecommerce ويرسله. أخطئ في كتابة الاسم، أو ضع الكائن في مستوى أعمق بدرجة، أو ادفعه في الصفحة الخطأ، فيبقى الوسم ساكنًا إلى الأبد دون خطأ. هكذا يبدو دفع الشراء:

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: 'ORD-10442',
    value: 89.90,
    currency: 'EUR',
    items: [
      { item_id: 'SKU-118', item_name: 'Trail jacket', price: 89.90, quantity: 1 }
    ]
  }
});

دفع ecommerce: null أولًا ليس زينة. من دونه، قد تتسرّب عناصر الحدث السابق إلى الحدث التالي، فيظهر view_item من ثلاث صفحات مضت داخل purchase.

الحاوي المثبّت في قالب Shopify يُحمَّل في واجهة المتجر — صفحات المنتجات والمجموعات والسلة. ولا يُحمَّل في صفحة الدفع ولا في صفحة الشكر، اللتين تقدّمهما Shopify من نطاقها الخاص وبقوالبها الخاصة. لذا يمكن لحاوي مثبّت في القالب أن يرسل view_item و add_to_cart، ولن يرسل أبدًا، بأي إعداد كان، begin_checkout أو add_payment_info أو purchase.

هذه الثلاثة تأتي من Custom Pixel. تكشف بيئة البكسل المعزولة في Shopify أحداث الدفع (checkout_started و payment_info_submitted و checkout_completed) وتتيح للبكسل أن يدفع إلى dataLayer خاص به — وسكربت صغير يربط كل واحد منها باسم حدث GA4 وشكله المذكورين أعلاه. أحداث واجهة المتجر تظل تأتي من القالب، فالإعداد الكامل يضم الاثنين: تطبيق dataLayer أو مقطع في القالب لنصف التصفح، وCustom Pixel لنصف الدفع.

قرار آخر. قناة Google وYouTube في Shopify تستطيع إرسال أحداث GA4 مباشرة خارج أي حاوي. إن ربطت هناك عقار GA4 ومرّرت العقار نفسه عبر حاويك، فسيُحتسب كل شراء مرتين. اختر مسارًا واحدًا. إن كان الهدف هو الجمع من الطرف الأول، فالمسار هو الحاوي، ويبقى اتصال Analytics في القناة مغلقًا.

WooCommerce بذاته لا يكتب أي dataLayer. تفعل ذلك إضافة — وGTM4WP هي ما يلجأ إليه معظم الناس — وخيار التجارة الإلكترونية GA4 فيها ينتج الأحداث السبعة بالشكل الصحيح في الصفحات الصحيحة: view_item في المنتج، و add_to_cart عند الزر، و begin_checkout في صفحة الدفع، و purchase في صفحة استلام الطلب.

العطل الكلاسيكي في WooCommerce هو شراء مضاعف، وله سبب محدد: صفحة استلام الطلب تُعاد تحميلها. يحدّثها الزائر، أو يعود إليها من مزوّد الدفع، أو يعيد القالب التوجيه عبرها مرتين، فيُدفع purchase مجددًا بنفس transaction_id. يزيل GA4 تكرار المشتريات بحسب transaction_id داخل الجلسة، وهذا يلتقط معظم الحالات، لكنه لا يلتقط إعادة تحميل في اليوم التالي. إعداد الإضافة «الإطلاق مرة واحدة فقط لكل طلب» يستحق التفعيل؛ فهو يحتفظ بالعلامة في جانب الخادم حيث لا تستطيع إعادة التحميل تصفيرها.

أخبر المعالج بأن الموقع متجر، فيضيف إلى حاوي الويب لديك مشغّل حدث مخصص ووسم حدث GA4 لكل من الأحداث السبعة — أربع عشرة كيانًا، كلها بالبادئة SH حتى لا تتعارض أبدًا مع ما لديك. كل وسم يرسل كائن ecommerce مباشرة من dataLayer، فتمرّ items و value و currency و transaction_id دون متغير لكل حقل، وكل وسم يسمّي معرّف القياس الخاص بك صراحةً بدلًا من وراثته.

لا يُثبَّت شيء في متجرك. المشغّلات تستمع؛ والدفعات من الإضافة أو البكسل. اختيار «لا متجر إلكتروني» يترك الكيانات الأربعة عشر جانبًا ولا يغيّر شيئًا آخر — مشاهدات الصفحات و scroll وبقية الأحداث القياسية تمر عبر الحاوي في كل الأحوال.

في جانب الخادم لا يوجد شيء لكل حدث. وسم GA4 في حاوي الخادم يمرّر كل حدث يتلقاه مهما كان اسمه، فالحدث الجديد في موقعك لا يحتاج إلى أي تغيير في جانبنا. وجهتا Meta Conversions API وTikTok Events API، إن ربطتهما، تربطان الأسماء السبعة نفسها بنفسيهما؛ فيصبح purchase هو Purchase لدى Meta و CompletePayment لدى TikTok، من الدفعة نفسها.

أنشئ طلبًا حقيقيًا في وضع الاختبار، أو طلبًا رخيصًا تسترد ثمنه لاحقًا، وراقب قائمة الأحداث في صفحة الحاوي. ينبغي أن ترى بالتسلسل view_item و add_to_cart و begin_checkout و add_payment_info و purchase — كلٌّ مرة واحدة. غياب purchase في Shopify يعني أن Custom Pixel غير مثبّت أو لا يدفع؛ وغياب begin_checkout في WooCommerce يعني عادةً أن حدث الدفع في الإضافة معطّل.

إن كنت تمرّر تحويلات Google Ads عبر الحاوي، فإن purchase هو حدث التحويل، وتُقرأ قيمته وعملته ومعرّف معاملته من كائن ecommerce نفسه. دفعة شراء بلا value تسجّل تحويلًا لا قيمة له — وهو رقم حقيقي في التقرير، والرقم الخاطئ.