يوجِّهك هذا الدليل خلال عملية نقل بيانات تنفيذ analytics.js
حالية في Universal 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 في صفحتك على الويب:
<!-- 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<Index>': '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 |