نقل البيانات من analytics.js إلى gtag.js (Universal Analytics)

يرشدك هذا الدليل خلال عملية نقل بيانات تنفيذ analytics.jsUniversal Analytics حالي لاستخدام gtag.js.

نظرة عامة

تستخدم analytics.js آليتين رئيسيتين لإرسال البيانات إلى "إحصاءات Google":

  1. أدوات التتبّع

    تحدِّد أدوات التتبُّع الموقع الذي تقيسه.

  2. أنواع النتائج

    تحدّد أنواع النتائج نوع التفاعل الذي تقيسه.

يتم تحديد خصائص gtag.js من خلال الأمر config أو على أنها معلّمة لأحد الأوامر.

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

لنقل البيانات من analytics.js إلى gtag.js، اتّبع الخطوات التالية لكل صفحة ويب من موقعك الإلكتروني:

استبدال مقتطف 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', 'TAG_ID', 'auto');
  ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

باستخدام مقتطف gtag.js التالي:

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

  gtag('config', 'TAG_ID');
</script>

قياس مرات مشاهدة الصفحة على الويب

تستخدِم analytics.js أدوات التتبُّع لإرسال مرات مشاهدة الصفحة على الويب إلى "إحصاءات Google". يتوفّر للتتبّع رقم تعريف القياس لأي موقع في"إحصاءات Google". ترسل gtag.js مرات مشاهدة الصفحة إلى موقع على"إحصاءات Google"يتم تحديده من خلال TAG_ID في الأمر config.

قياس مرات مشاهدة الصفحة على الويب باستخدام أداة التتبُّع التلقائية

أزِل رمز analytics.js التالي الذي يستخدِم أداة التتبُّع التلقائية في مشاهدات send للصفحة على "إحصاءات Google":

// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');

// Uses the default tracker to send a pageview to the
// Google Analytics property with tag ID of 'TAG_ID'.
ga('send', 'pageview');

يرسل الرمز التالي في مقتطف gtag.js تلقائيًا مشاهدة صفحة على الويب إلى موقع"إحصاءات Google"برقم تعريف علامة TAG_ID:

gtag('config', 'TAG_ID');

قياس مرات مشاهدة الصفحة باستخدام برامج التتبُّع المحددة

استبدل رمز analytics.js التالي الذي يستخدم أداة التتبّع المحدّدة لإرسال مشاهدات الصفحة إلى "إحصاءات Google":

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');

باستخدام الأمر gtag.js event التالي:

gtag('event', 'page_view', { 'send_to': 'TAG_ID' });

قياس الأحداث

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

قياس الأحداث باستخدام أداة التتبُّع التلقائية

استبدِل رمز analytics.js التالي الذي يستخدم أداة التتبُّع التلقائية بأحداث send في "إحصاءات Google":

ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

باستخدام الأمر gtag.js event التالي:

gtag('event', eventName, eventParameters);

حيث eventName هو اسم الحدث الذي تريد تسجيله.

مثال:

analytics.js:

// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');

// Uses the default tracker to send the event to the
// Google Analytics property with a tag ID of `TAG_ID`.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

gtag.js:

// Sends the event to the Google Analytics property with a
// tag ID of `TAG_ID` set by the config command in
// the gtag.js snippet.
gtag('event', 'play', {
  'event_category': 'Videos',
  'event_label': 'Fall Campaign'
});

قياس الأحداث باستخدام أدوات تتبُّع محدّدة

استبدل رمز analytics.js التالي الذي يستخدم أداة التتبّع المحدّدة لإرسال الأحداث إلى "إحصاءات Google":

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

باستخدام الأمر gtag.js event التالي:

gtag('event', eventName, {
  'send_to': 'TAG_ID',
  'parameter1': 'value1',
  'parameter2': 'value2',
  // ...
});

مثال:

analytics.js:

// Creates a tracker named <b>clientTracker</b>.
ga('create', 'TAG_ID', 'auto', 'clientTracker');

// Uses tracker clientTracker to send the event to the
// Google Analytics property with a tag ID of TAG_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');

gtag.js:

// Send the event to the Google Analytics property
// with a tag ID of 'TAG_ID'.
gtag('event', 'play', {
  'send_to': 'TAG_ID',
  'event_category': 'Videos',
  'event_label': 'Fall Campaign'
});

إرسال مقاييس وسمات مخصّصة

استبدِل أي أمر send على analytics.js في صفحاتك على الويب التي ترسل سمات مخصّصة إلى "إحصاءات Google":

ga('send', 'hitType', { 'dimension&lt;Index&gt;':  'dimension_value'});

باستخدام رمز gtag.js التالي:

gtag('config', 'TAG_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});

استبدِل TAG_ID برقم تعريف"إحصاءات Google"الخاص بك.

استبدِل أي أمر send على analytics.js في صفحات موقعك الإلكتروني التي ترسل مقاييس مخصّصة إلى "إحصاءات Google":

ga('send', 'hitType', { 'metric<Index>':  'metric_value'});

باستخدام رمز gtag.js التالي:

gtag('config', 'TAG_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});

استبدِل TAG_ID بمعرّف العلامة.

قياس توقيتات المستخدم

استبدل أي أمر send analytics.js في صفحات الويب التي تتتبّع توقيتات المستخدم:

ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');

باستخدام الأمر gtag.js event التالي:

gtag('event', 'timing_complete', {
  'name': 'timingVar',
  'value': timingValue,
  'event_category': 'timingCategory',
  'event_label': 'timingLabel'
});

قياس الاستثناءات

استبدِل أي أمر send على analytics.js في صفحات الويب التي تتبِّع الاستثناءات:

ga('send', 'exception', {
  'exDescription': 'error_message',
  'exFatal': false  // set to true if the exception is fatal
});

باستخدام الأمر gtag.js event التالي:

gtag('event', 'exception', {
  'description': 'error_message',
  'fatal': false  // set to true if the exception is fatal
});

ربط حقول analytics.js بمعلّمات gtag.js

تربط الجداول التالية حقول analytics.js بمعلمات gtag.js المقابلة.

الأحداث

حقل analytics.js مَعلمة gtag.js
eventAction event_action
eventCategory event_category
eventLabel event_label
eventValue value

المكوّنات والمقاييس المخصصة

حقل analytics.js مَعلمة gtag.js
dimension<Index> dimension<Index>
metric<Index> metric<Index>

حيث <Index> هو عدد صحيح غير سالب يمثل فهرس البُعد أو المقياس المخصّص.

أوقات المستخدم

حقل analytics.js مَعلمة gtag.js
timingCategory event_category
timingLabel event_label
timingValue value
timingVar name

قياس الاستثناءات

حقل analytics.js مَعلمة gtag.js
exDescription description
exFatal fatal

بيانات إجراءات التجارة الإلكترونية المحسَّنة

حقل analytics.js مَعلمة gtag.js
id transaction_id
affiliation affiliation
revenue value
tax tax
shipping shipping
coupon coupon
list list_name
step checkout_step
option checkout_option

بيانات العرض الترويجي

حقل analytics.js مَعلمة gtag.js
creative creative_name
position (مرّة الظهور، المنتج) list_position
position (عرض ترويجي) creative_slot

إجراءات المنتجات والعروض الترويجية

حقل analytics.js حدث gtag.js
add add_to_cart
checkout (الخطوة الأولى) begin_checkout
checkout (أي خطوة لاحقة) checkout_progress
checkout_option set_checkout_option
click select_content (بدون عروض ترويجية)
detail view_item
promo_click select_content (مع العروض الترويجية)
purchase purchase
refund refund
remove remove_from_cart

معرِّف العميل ورقم تعريف المستخدم

حقل analytics.js مَعلمة gtag.js
clientId client_id
userId user_id