نقل البيانات من 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'
});

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

استبدِل أي أمر analytics.js send في صفحات الويب يرسل سمات مخصّصة إلى "إحصاءات 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" الخاص بك.

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

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

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

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

Client-ID وUser-ID

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