التجارة الإلكترونية في "إحصاءات Google 4" (analytics.js - التجارة الإلكترونية العادية): إرسال أحداث التجارة الإلكترونية على "إحصاءات Google 4"

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

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

النتيجة

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

هناك مرحلتان من عملية نقل البيانات:

قبل البدء

  1. تأكّد من أنّ ما يلي يصف عملية التنفيذ الحالية:

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

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

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

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

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

الإيجابيات السلبيات
  • عرض بيانات التجارة الإلكترونية في تقارير "إحصاءات Google 4" وUniversal Analytics.
  • سيؤدّي نقل البيانات إلى حدث purchase على "إحصاءات Google 4" إلى تقديم تقارير كاملة عن التجارة الإلكترونية في Universal Analytics.
  • أعمال إضافية مطلوب نقلها من analytics.js إلى gtag.js. ننصحك بنقل جميع القياسات المخصّصة من analytics.js إلى gtag.js (مثل الأحداث ومرات مشاهدة الصفحة على الويب والتوقيت، وما إلى ذلك).

التنفيذ

1- نقل قياس Universal Analytics من analytics.js إلى gtag.js

لإرسال أحداث التجارة الإلكترونية في "إحصاءات Google 4"، عليك نقل البيانات من مقتطف analytics.js إلى gtag.js، بما في ذلك أي عمليات قياس مخصّصة.

بوجه عام، ستشمل خطوات إكمال عملية النقل ما يلي:

  1. أزِل مقتطف analytics.js.
  2. ثبِّت علامة Google (gtag.js) واضبطها باستخدام رقم تعريف التتبّع في موقعك على Universal Analytics.
  3. انقل رمز القياس المخصّص من analytics.js إلى gtag.js. تصف الأقسام أدناه كيفية نقل معاملة تجارة إلكترونية عادية. اطّلِع على نقل بيانات القياس للحصول على مساعدة عامة بشأن نقل بيانات حالات القياس الأخرى.

قبل: علامة analytics.js

<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');    // Universal Analytics property.
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

بعد: علامة Google (gtag.js)

<!-- 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.
</script>

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

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

يوضِّح المثال التالي كيفية نقل حدث معاملة تجارة إلكترونية عادية في analytics.js إلى حدث purchase مكافئ للتجارة الإلكترونية على "إحصاءات Google 4"، ويكون متوافقًا مع Universal Analytics.

قبل: معاملة التجارة الإلكترونية العادية (analytics.js)

يوضّح المثال التالي تنفيذ التجارة الإلكترونية العادية analytics.js لمعاملة ذات عنصرين:

// Add the transaction.
ga('ecommerce:addTransaction', {
  id: '1234',     // Transaction ID.
  affiliation: 'Google Store',
  revenue: '29.97',
  shipping: '5.25',
  tax: '2.42'
});

// Add the items belonging to the transaction.
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Android Warhol T-Shirt',
  sku: 'P12345',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '12.99',
  quantity: '2'
});
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Flame challenge T-Shirt',
  sku: 'P67890',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '3.99',
  quantity: '1'
});
ga('ecommerce:send');

بعد: عملية الشراء من خلال التجارة الإلكترونية في "إحصاءات Google 4" (gtag.js)

عند نقل حدث معاملة analytics.js إلى حدث purchase على "إحصاءات Google 4"، تكون الاختلافات الرئيسية هي:

  • تحتوي "إحصاءات Google 4" على حدث purchase واحد يتضمّن جميع التفاصيل والعناصر ذات الصلة بالمعاملة. وينفّذ analytics.js العديد من أوامر التجارة الإلكترونية ga() للحصول على المعلومات نفسها.
  • تحتوي "إحصاءات Google 4" على حقل transaction_id واحد للحدث بالكامل. ويتطلب analytics.js تضمين معرّف المعاملة مع كل عنصر.
  • تحتوي "إحصاءات Google 4" على حقول متعدّدة لفئات السلع. تستخدِم مقتطف analytics.js حقل فئة واحدًا مع محدِّد / لوصف التدرّجات الهرمية. في المقابل، ستعمل أحداث "إحصاءات Google 4" التي تتضمّن حقولاً متعدّدة لفئة السلع لموقعك على Universal Analytics بسبب ترجمة مَعلمات الفئة.
 gtag('event', 'purchase', {
   currency: 'USD',
   transaction_id: '1234',    // Transaction ID.
   value: 29.97,
   affiliation: 'Google Store',
   shipping: 5.25,
   tax: 2.42,
   items: [
    {
      item_id: 'P12345',     // Item ID.
      item_name: 'Android Warhol T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 12.99,
      quantity: 2
    },
    {
      item_id: 'P67890',    // Item ID.
      item_name: 'Flame challenge T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 3.99,
      quantity: 1
    }
  ]
});

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

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

الخيار 1: استخدام مساعِد إعداد "إحصاءات Google 4" وتفعيل علامات المواقع الإلكترونية المرتبطة

سيعمل مساعِد إعداد "إحصاءات Google 4" تلقائيًا على إنشاء موقع جديد على "إحصاءات Google 4" ونسخ الإعدادات التالية من موقعك على Universal Analytics: اسم الموقع وعنوان URL للموقع الإلكتروني والمنطقة الزمنية وإعدادات العملة. ويمكن أن يؤدي ذلك أيضًا إلى تفعيل ميزة علامة الموقع الإلكتروني المرتبطة لإعادة استخدام عملية تنفيذ مقتطف gtag.js من Universal Analytics الحالي لتحميل موقعك الجديد على "إحصاءات Google 4".

اتّبِع الخطوات الموضّحة في مساعِد إعداد "إحصاءات Google 4" لإنشاء موقع جديد على "إحصاءات Google 4" وإعداده. تأكّد من وضع علامة على الخيار تفعيل جمع البيانات باستخدام العلامات الحالية لاستخدام ميزة علامة الموقع الإلكتروني المرتبطة.

الخيار 2: تعديل مقتطف gtag.js

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

في ما يلي مثال على مقتطف gtag.js تم ضبط موقع على Universal Analytics و"إحصاءات Google 4" فيه.

<!-- 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');  // Google Analytics 4 property.
</script>

4. (اختياري) قياس أحداث التجارة الإلكترونية الإضافية

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

إذا كنت تستخدِم إعدادات مقتطف gtag.js التلقائي، سيتم إرسال أحداث "إحصاءات Google 4" إلى كلٍّ من مواقعك على Universal Analytics و"إحصاءات Google 4". وستتم ترجمة أحداث "إحصاءات Google 4" المُرسَلة إلى موقعك على Universal Analytics على النحو المحدّد في مرجع توافق الأحداث. إذا كنت تفضّل سلوكًا مختلفًا، يمكنك استخدام وظيفة بيانات المجموعات والمسار في مقتطف gtag.js للتحكّم في الأحداث التي يتمّ إرسالها إلى موقعك على Universal Analytics و"إحصاءات Google 4". على سبيل المثال، يمكنك إرسال الحدث purchase إلى كلٍّ من موقعك على Universal Analytics وموقعك على "إحصاءات Google 4"، ولكن يمكنك إرسال أحداث التجارة الإلكترونية الأخرى على "إحصاءات Google 4" فقط إلى موقعك على "إحصاءات Google 4".