يرشدك هذا الدليل خلال عملية نقل بيانات تنفيذ 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". يتوفّر للتتبّع رقم تعريف القياس لأي موقع في"إحصاءات 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 |