التجارة الإلكترونية في "إحصاءات Google 4" (gtag.js): إرسال أحداث Universal Analytics و"إحصاءات Google 4"

يوضِّح هذا الدليل كيفية الحفاظ على عمليات تنفيذ التجارة الإلكترونية gtag.js Universal Analytics بشكل منفصل وإحصاءات Google 4.

يُرجى الانتقال إلى مركز نقل بيانات المطوّرين للاطّلاع على مراجع وأدلة الترقية الإضافية.

النتيجة

تتمثّل نتيجة اتّباع هذا الدليل في أنّك ستنفّذ أحداث التجارة الإلكترونية في "إحصاءات Google 4" لموقع جديد على "إحصاءات Google 4" بدون تغيير عملية تنفيذ التجارة الإلكترونية الحالية في Universal Analytics. ستُرسِل أحداث تجارة إلكترونية منفصلة إلى كلٍّ من موقع Universal Analytics وموقع "إحصاءات Google 4".

تجدر الإشارة إلى أنّه عند تنفيذ التجارة الإلكترونية لكلٍّ من Universal Analytics و"إحصاءات Google 4"، سيستخدِم موقعك على "إحصاءات Google 4" عملية تنفيذ التجارة الإلكترونية في "إحصاءات Google 4".

قبل البدء

  1. استخدِم أداة المساعدة في نقل بيانات التجارة الإلكترونية للتأكّد من أنّ ما يلي يصف عملية التنفيذ الحالية:

    • أنت تستخدم موقعًا على Universal Analytics
    • يستخدم موقعك الإلكتروني مكتبة gtag.js لإرسال أحداث التجارة الإلكترونية.

  2. راجِع خيارات الترقية لعمليات تنفيذ التجارة الإلكترونية للاطّلاع على المفاضلات بين كل خيار. أكِّد أنّك تريد اتّباع هذا الدليل وتوفُّر عمليتَي تنفيذ للإحصاءات: إحداهما لموقعك على Universal Analytics والأخرى لموقعك على "إحصاءات Google 4".

المفاضلات والاعتبارات

راجِع المعلومات الواردة أدناه وفكِّر فيها لفهم النتائج المترتبة على استخدام عمليتَي تنفيذ للتجارة الإلكترونية، أحدهما لموقعك على Universal Analytics والآخر لموقعك على "إحصاءات Google 4".

الإيجابيات السلبيات
  • يسمح لك بالاطّلاع على بيانات التجارة الإلكترونية في تقارير كلٍّ من "إحصاءات Google 4" وUniversal Analytics.
  • ما مِن تغيير في طريقة جمع بيانات التجارة الإلكترونية أو إعداد تقارير عنها في موقعك على Universal Analytics.
  • يضمن استخدام الأحداث والمَعلمات في "إحصاءات Google 4" إكمال تقارير التجارة الإلكترونية في "إحصاءات Google 4".
  • تتطلّب منك تنفيذ أحداث التجارة الإلكترونية على "إحصاءات Google 4".
  • يُرسِل موقعك الإلكتروني مجموعتَين من الأحداث: إحداهما لخدمة Universal Analytics والأخرى لخدمة "إحصاءات Google 4". وقد يؤثر ذلك في الأداء.

التنفيذ

1- إنشاء موقع جديد على "إحصاءات Google 4" وإعداده

أكمِل الخطوات التالية لإنشاء موقعك الجديد على إحصاءات Google 4 وضبطه:

  1. أنشئ موقعًا جديدًا على "إحصاءات Google 4".
    • استخدِم مساعِد إعداد "إحصاءات Google 4" لإنشاء موقع جديد على "إحصاءات Google 4" تلقائيًا ونسخ الإعدادات التالية من موقعك على Universal Analytics: اسم الموقع وعنوان URL للموقع الإلكتروني والمنطقة الزمنية وإعدادات العملة. مع ذلك، أزِل العلامة من المربّع تفعيل جمع البيانات باستخدام العلامات الحالية لإيقاف ميزة علامة الموقع الإلكتروني المرتبطة. بدلاً من ذلك، إذا كنت لا تريد نسخ أيّ إعدادات من موقعك على Universal Analytics، يمكنك إنشاء موقع على "إحصاءات Google 4" بدون مساعد إعداد "إحصاءات Google 4".
  2. ابحث عن رقم تعريف العلامة لموقع "إحصاءات Google 4". وستستخدِمها في الخطوة التالية لضبط موقعك على "إحصاءات Google 4"
  3. إضافة موقع "إحصاءات Google 4"
    • لضمان إرسال أحداث Universal Analytics إلى موقعك على Universal Analytics فقط وإرسال أحداث "إحصاءات Google 4" فقط إلى موقعك على "إحصاءات Google 4"، استخدِم وظيفة بيانات التوجيه المقدَّمة من خلال gtag.js.
    • أضِف موقع "إحصاءات Google 4" إلى مقتطف gtag.js الحالي. استخدِم الأمر config والمَعلمة groups مع رقم تعريف العلامة كي تتمكّن من توجيه الأحداث إلى موقعك على "إحصاءات Google 4" بشكل منفصل عن موقعك على Universal Analytics.

في ما يلي مثال على مقتطف gtag.js تم فيه إعداد موقع على Universal Analytics وموقع على "إحصاءات Google 4" تم تخصيصه لمجموعة GA4.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');  // Universal Analytics property
  gtag('config', 'TAG_ID', { 'groups': 'GA4' });  // Google Analytics 4 property
</script>

2. تنفيذ أحداث التجارة الإلكترونية على "إحصاءات Google 4" والمسار إلى موقعك على "إحصاءات Google 4"

بعد إنشاء موقعك الجديد على "إحصاءات Google 4" وإعداده، ستكون جاهزًا لتنفيذ أحداث التجارة الإلكترونية في "إحصاءات Google 4". للمساعدة في جعل عملية تنفيذ "إحصاءات Google 4" مشابهة لعملية تنفيذ Universal Analytics، استخدِم المراجع التالية:

يوضّح المثال التالي أحداث purchase منفصلة للتجارة الإلكترونية على Universal Analytics و"إحصاءات Google 4" يتم إرسالها إلى الموقعَين المعنيَين باستخدام مَعلمة send_to لأحداث "إحصاءات Google 4":

// Universal Analytics.
// The original UA implementation remains unchanged.
gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "currency": "USD",
  "shipping": 7.50,
  "tax": 1.80,
  "value": 33.30,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_name": "Search Results",
      "list_position": 1,
      "quantity": 2,
      "price": 12.00
    }
  ]
});


// The new Google Analytics 4 ecommerce implementation.
// Uses `send_to` to route data to the GA4 group defined in the tag config.
gtag('event', 'purchase', {
  "send_to": "GA4",
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "currency": "USD",
  "shipping": 7.50,
  "tax": 1.80,
  "value": 33.30,
  "items": [
    {
      "item_id": "P12345",
      "item_name": "Android Warhol T-Shirt",
      "item_brand": "Google",
      "item_category": "Apparel/T-Shirts",
      "item_variant": "Black",
      "quantity": 2,
      "price": 12.00
    }
  ],
});