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

يوجِّهك هذا الدليل خلال عملية نقل بيانات تنفيذ analytics.js حالية في Universal 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 Analytics. تحتوي أداة التتبُّع على رقم تعريف القياس لأحد المواقع على "إحصاءات 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