تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

نظرة عامة

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

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

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

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

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

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

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

استبدِل مقتطف analytics.js بمقتطف gtag.js.
استبدِل رمز 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`