لمحة عن مقتطف gtag.js
إذا كنت تستخدم مقتطف analytics.js لموقعك الحالي على Universal Analytics، ستحتاج إلى إضافة مقتطف gtag.js لموقعك الجديد على "إحصاءات Google" 4. ويتسم مقتطف gtag.js بالبنية التالية:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Some Property ID A>');
08:
09: gtag('config', '<Some Property ID B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Some Property ID B>' });
14:
15: </script>
السطر7: يُفعل الأمر gtag "config" جمع البيانات للموقع المرتبط بـ <Some Property ID A>. على سبيل المثال، ستؤدي إضافة هذا الأمر مع رقم تعريف العلامة إلى موقع "إحصاءات Google 4" إلى إرسال أحداث page_view إلى ذلك الموقع.
قد يمثّل رقم تعريف الموقع منتجات مختلفة من Google، بما في ذلك مواقع Universal Analytics ("UA-XXXXXXXX")، أو مواقع "إحصاءات Google 4" ("G-XXXXXXXX") أو "إعلانات Google" ("AW-XXXXXXXX") أو Floodlight ("DC-XXXXXXXX").
السطر 11: سيُرسِل الأمر gtag "event" حدثًا. وفي المقتطفات التي تتضمّن أوامر "config" متعددة لمواقع متعددة، سيتم إرسال الحدث إلى كل المواقع.
في هذا المثال، تتمثل المعلّمة "sign_up" في اسم الحدث. وتتمثل المعلّمة الأخيرة في كائن يحتوي على مجموعة من معلّمات الأحداث. وفي هذه الحالة، تتمثل "method" في معلّمة تحتوي على قيمة "email".
السطر 13: يحتوي الحدث هنا على "send_to" كمعلّمة. وهذه معلّمة خاصة تعمل على "توجيه" الحدث المرتبط إلى موقع محدّد. وبعبارة أخرى، لن يتم إرسال هذا الحدث إلا إلى الموقع المُشار إليه من خلال <Some Property ID B>.
يتم تفعيل جمع البيانات الأساسي لأحد المواقع على "إحصاءات Google" 4 من خلال الأمر gtag "config"، وتعمل هذه الطريقة على تفعيل جمع أحداث page_view كحدث مجمَّع تلقائيًا عند تحميل هذا الأمر على إحدى الصفحات.
يمكن تعديل نتيجة مشاهدة الصفحة أو حدث page_view أو حظرهما باستخدام معلّمات معيّنة.
أرقام تعريف المواقع
تستخدِم أرقام تعريف مواقع Universal Analytics التنسيق "UA-XXXXXXXX". ويُشار إليها أحيانًا باسم "رقم تعريف التتبع". سنُشير إلى هذا الدليل على أنّه معرّف موقع UA.
تستخدم مصادر بيانات المواقع الإلكترونية لمواقع "إحصاءات Google 4" رقم تعريف علامة تنسيقه "G-XXXXXXXX".
في بعض أمثلة الرموز والمستندات، قد تلاحظ أنّه يُشار إلى كلٍّ منهما بالاسم "TAG_ID".
جمع البيانات الأساسية
يسمح تفعيل جمع البيانات الأساسية لأحد المواقع على "إحصاءات Google" 4 بجمع ما يلي:
- أحداث page_view
- الأحداث المُجمَّعة تلقائيًا
- أحداث القياس المحسّن (إذا كانت مفعلة في واجهة المستخدم)
لتفعيل جمع البيانات الأساسي لموقعك على "إحصاءات Google 4"، أضف مقتطف gtag.js (علامة Google) إلى قسم <head> في كل صفحة.
مقتطف gtag.js مقارنةً بمقتطف analytics.js
يخدم مقتطف gtag.js لأحد المواقع على "إحصاءات Google" 4 غرضًا مشابهًا لمقتطف analytics.js لأحد المواقع على Universal Analytics.
يتمثل الفارق الأكبر بين هذين المقتطفين في أن رمز analytics.js يتضمّن طلب "إرسال مشاهدة الصفحة" منفصلاً، في حين أن رمز gtag.js لا يتضمّن ذلك الطلب. وفي رمز gtag.js، تكون مشاهدة الصفحة عبارة عن حدث مجمَّع تلقائيًا مع الأمر "config".
موقع Universal Analytics (analytics.js)
<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>
موقع "إحصاءات Google 4" (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>
إعدادات ضبط مقتطف gtag.js
يمكنك ضبط مقتطف gtag.js الأساسي للتحكّم في إعدادات جمع البيانات مثل إخفاء عناوين IP، وعمليات تخصيص ملفات تعريف الارتباط، وإشارات Google، بما يشبه مقتطف analytics.js. ويمكنك إجراء ذلك من خلال الأمر "config" أو الأمر "set" في مقتطف gtag.js (مقابل الأوامر "set" و"create" و"request" في مقتطف analytics.js).
تتيح المواقع على "إحصاءات Google" 4 ("G-XXXXXXXX") تنفيذ إعدادات الضبط هذه من خلال مقتطف gtag.js. وهناك اختلافات بين هذه الإعدادات لكلٍّ من المواقع على Universal Analytics والمواقع على "إحصاءات Google" 4. ويُرجى مراعاة الاعتبارات التالية:
- يتم توحيد عملية إخفاء عناوين IP على "true" ولا تكون قابلة للضبط في موقع "إحصاءات Google 4". وبناءً على ذلك، يتم إخفاء عنوان IP تلقائيًا باستخدام الحدث العادي لموقع "إحصاءات Google 4" ("G-XXXXXXXX").
- عندما يجب تطبيق الإعدادات العامة على كل المواقع التي تم ضبطها، يجب استخدام الأمر "set" في مقتطف gtag.js لتطبيق كل أرقام تعريف العلامات و/أو أرقام تعريف المواقع.
- يجب التركيز بوجهٍ خاص على الميزات الإعلانية وميزات تخصيص الإعلانات في مقتطف analytics.js، والتي عادةً ما يتم تنفيذها مع السطر "set".
إذا كنت تستخدم أوامر "set" و"create" و"require" في تنفيذ مقتطف analytics.js الحالي، راجِع الإعدادات التي تم ضبطها تلقائيًا في أحد المواقع على "إحصاءات Google" 4 والإعدادات التي يجب تحديدها في رمز المواقع على "إحصاءات Google" 4 (ربط المعلّمات).
في ما يلي بعض أمثلة عمليات الضبط مع نماذج الرموز في مقتطف analytics.js (لمواقع UA) ومقتطف gtag.js (لمواقع "إحصاءات Google" 4):
تفعيل جمع البيانات الأساسي، ضبط User-ID
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
ضبط إعدادات ملفات تعريف الارتباط
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Time in seconds.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 days, in seconds
});
حظر حدث page_view
إذا لم تكن بحاجة إلى إرسال حدث page_view عند تحميل رمز الضبط (على سبيل المثال، إذا كان لديك إطار iframe قيد التحميل)، يمكنك تعديل إعداد الضبط على حظر حدث page_view. وضع في اعتبارك سيناريو يتم فيه إرسال حدث page_view، متبوعًا بتسجيل دخول المستخدم إلى الموقع الإلكتروني. وبالنسبة إلى تفاعل تسجيل الدخول، يمكنك استخدام أمر "config" لتحديد رقم تعريف المستخدم، ولكنك لن تريد إرسال حدث page_view آخر. ويوضّح الرمز التالي كيفية منع إرسال حدث page_view.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
أسماء العلامات
يتم استخدام أسماء العلامات (المعروفة باسم "أدوات التتبّع") إذا كنت تريد إرسال البيانات إلى مواقع Universal Analytics مختلفة في مقتطف analytics.js. وفي مقتطف analytics.js، تُحدِّد أدوات التتبّع الموقع الذي تريد إرسال البيانات إليه. ولم تعد النتائج بعد نتيجة "إنشاء" المبدئية بحاجة إلى تحديد رقم تعريف موقع Universal Analytics، بل اسم أداة التتبّع فقط.
في مقتطف gtag.js، لا تتوفّر أدوات التتبّع لأيٍّ من المواقع على "إحصاءات Google 4" أو المواقع على Universal Analytics. وإذا كنت تريد إرسال جميع النتائج إلى مواقع متعددة (مصادر بيانات مختلفة في أحد مواقع "إحصاءات Google 4")، يمكنك تحديد جميع معرّفات العلامات أو المواقع في السطر "config".
الأحداث
ارجع إلى دليل نقل بيانات الأحداث.المقاييس والمكوّنات المخصّصة
يتم استخدام المقاييس والمكوّنات المخصّصة لتوسيع المعلومات التي يتم قياسها على الموقع الإلكتروني، ولاستيراد البيانات بلا اتصال بالإنترنت من أنظمة إدارة علاقات العملاء (CRM) مثلاً. وفي المواقع على Universal Analytics (التي تستخدِم التنسيق "UA-XXXXXXXX")، يجب إنشاء المقاييس والمكوّنات المخصّصة في واجهة المستخدم، ويتم تعيين رقم تعريف لها، ويمكن بعد ذلك تنفيذها أو استيرادها. ويمكن إنشاؤها باستخدام أربعة نطاقات مختلفة: النتيجة، والجلسة، والمستخدم، والمنتج.
في أحد المواقع على "إحصاءات Google" 4 (التي تستخدم التنسيق "G-XXXXXXXX")، يتم تنفيذ حالة استخدام المقاييس والمكوّنات المخصّصة بطريقة مختلفة. وعلاوةً على ذلك، فإن قيم المقاييس والمكوّنات المخصّصة في مواقع UA، التي تم تنفيذها من خلال مقتطف analytics.js، يجب إعادة تنفيذها كمعلّمات في أحد المواقع على "إحصاءات Google" 4.
يمكن تنفيذ مكوّن مخصّص لأحد مواقع Universal Analytics من خلال مقتطف analytics.js على النحو التالي:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
أو
ga('set', 'dimension5', 'custom data');
يمكن ترجمة هذه المكوّنات المخصّصة إلى أحد المواقع على "إحصاءات Google" 4 من خلال مقتطف gtag.js على النحو التالي:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
أو
gtag('set', {'dimension5': 'custom data'});
هناك نوعان من التنبيهات:
- يجب تسجيل المعلّمات في واجهة المستخدم حتى تظهر في التقارير. وهذه عملية مماثلة لتسجيل المكوّنات المخصّصة في Universal Analytics (تنطبق الحدود السارية). ولن تحتاج إلى تسجيلها إذا كنت تطّلع فقط على البيانات التي تم تصديرها أو كنت تستخدِم المعلمة فقط لتفعيل الجمهور.
- يكون نطاق المعلّمات المخصّصة دائمًا على مستوى الحدث، ويمكن مقارنته بنطاق النتيجة. وينطبق هذا أيضًا على المكوّنات المخصّصة التي تُترجَم تلقائيًا إلى المعلّمات (لعمليات تنفيذ gtag.js بالتنسيق "UA-XXXXXXXX")، بشكلٍ مستقل عن إعداد نطاق المكوّن المخصّص الأصلي.
ينطبق الربط والاعتبارات نفسها على المقاييس المخصّصة، باستثناء أنه يتم احتسابها ضمن حدود المعلّمات الرقمية بدلاً من حدود المعلّمات النصية عند تسجيلها في إعداد التقارير.
من الناحية النظرية، تربط المقاييس والمكوّنات المخصّصة لنطاق متنوع في موقع على Universal Analytics بموقع على "إحصاءات Google" 4 على النحو التالي:
- السمة المخصصة على مستوى النتيجة: المَعلمة (يتم تسجيل 25 مَعلمة إجمالاً بحدٍ أقصى لكل حدث أثناء جمع البيانات، ويتم تسجيل 50 سمة مخصّصة/50 مقياسًا مخصصًا بحدٍ أقصى)
جدير بالذكر أنّ الأحداث والمَعلمات المجمَّعة تلقائيً اقد تغطي حاليًا بعض حالات الاستخدام التي كانت يتم فيها استخدام سمات مخصّصة على مستوى النتيجة في السابق. - السمة المخصّصة على مستوى المستخدم: خصائص المستخدمين (تسجيل 25 بحدٍ أقصى لإعداد التقارير من خلال واجهة المستخدم). ولا يتم احتساب سمات المستخدمِين المجمَّعة تلقائيًا ضمن هذا الحدّ.
- السمة المخصّصة على مستوى الجلسة: ليس هناك مكافئ في موقع "إحصاءات Google 4"، انظر إلى المَعلمات المخصّصة أو مواقع المستخدمِين بدلاً من ذلك.
أفضل ممارسات مواقع المستخدمِين
تتقيّد مواقع المستخدمِين بمستخدِم على مستوى المنصات المختلفة (على سبيل المثال، في جميع أنواع مصادر البيانات)، وبالتالي يجب عدم استخدامها إلا إذا كانت البيانات تنطبق على مستوى المستخدِم. يجب عدم استخدام مواقع المستخدمِين للبيانات على مستوى الجلسة أو البيانات على مستوى الجهاز (مثل حجم الشاشة).
مثال على موقع "إحصاءات Google" 4
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});