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