تشكّل هذه المقالة جزءًا من دليل نقل البيانات في Universal Analytics إلى إحصاءات Google 4. راجع دليل نقل بيانات جدول المحتوى.

[GA4←UA] نصائح للترقية من analytics.js إلى gtag.js

هذه المقالة موجّهة لمالكي المواقع الإلكترونية الذين يريدون فهم كيفية ربط مقتطف analytics.js لموقع على Universal Analytics‏ (UA) بمقتطف gtag.js لموقع على "إحصاءات Google"‏ 4 ويريدون أيضًا الحصول على إرشادات تنفيذ تفصيلية. وتفترض هذه المقالة أنه سبق لك إنشاء موقع على "إحصاءات Google"‏ 4. وإذا كنت بحاجة إلى إضافة رمز القياس الأساسي إلى صفحتك، اطّلِع على هذه التعليمات بدلاً من ذلك.
في هذه المقالة:

لمحة عن مقتطف 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".

وفي بعض أمثلة الرموز والمستندات، قد تلاحظ أنّه يُشار إلى كليهما برقم التعريف "GA_Measurement_ID".

جمع البيانات الأساسية

يسمح تفعيل جمع البيانات الأساسية لأحد المواقع على "إحصاءات Google"‏ 4 بجمع ما يلي:

لتفعيل جمع البيانات الأساسية لموقعك على "إحصاءات Google"‏ 4، أضِف مقتطف gtag.js (علامة الموقع الشاملة) إلى قسم <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', 'MEASUREMENT_ID', 'auto');

ga('send', 'pageview');

</script>

موقع "إحصاءات Google"‏ 4 (gtag.js)

<script async src="https://www.googletagmanager.com/gtag/js?id=MEASUREMENT_ID"></script>

<script>

window.dataLayer = window.dataLayer || [];

function gtag(){dataLayer.push(arguments);}

gtag('js', new Date());

gtag('config', 'MEASUREMENT_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 على "صحيح" ولا يكون قابلاً للضبط في موقع على "إحصاءات Google"‏ 4. وبناءً على ذلك، يتم حجب عنوان IP تلقائيًا باستخدام الحدث العادي للموقع على "إحصاءات Google"‏ 4 ("G-XXXXXXXX").
  • عندما يلزم تطبيق الإعدادات العمومية على كل المواقع التي تم ضبطها، يجب استخدام أمر "set" لتطبيق كل أرقام تعريف القياس و/أو أرقام تعريف المواقع.
  • انتبِه بوجهٍ خاص إلى الميزات الإعلانية وميزات تخصيص الإعلانات في مقتطف 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', 'GA_MEASUREMENT_ID', 'auto', {

userId: USER_ID

});

ga('send', 'pageview');

gtag.js

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

ضبط إعدادات ملفات تعريف الارتباط

analytics.js

ga('create', 'GA_MEASUREMENT_ID', {

'cookieName': 'gaCookie',

'cookieDomain': 'blog.example.co.uk',

'cookieExpires': 60 * 60 * 24 * 28 // Time in seconds.

});

gtag.js

gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_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'});

هناك نوعان من التنبيهات:

  1. يجب تسجيل المعلّمات في واجهة المستخدم حتى تظهر في التقارير. وهذه عملية مماثلة لتسجيل المكوّنات المخصّصة في Universal Analytics (تنطبق الحدود السارية). ولن تحتاج إلى تسجيلها إذا كنت تطّلع فقط على البيانات التي تم تصديرها أو كنت تستخدِم المعلمة فقط لتفعيل الجمهور.
  2. يكون نطاق المعلّمات المخصّصة دائمًا على مستوى الحدث، ويمكن مقارنته بنطاق النتيجة. وينطبق هذا أيضًا على المكوّنات المخصّصة التي تُترجَم تلقائيًا إلى المعلّمات (لعمليات تنفيذ gtag.js بالتنسيق "UA-XXXXXXXX")، بشكلٍ مستقل عن إعداد نطاق المكوّن المخصّص الأصلي.

ينطبق الربط والاعتبارات نفسها على المقاييس المخصّصة، باستثناء أنه يتم احتسابها ضمن حدود المعلّمات الرقمية بدلاً من حدود المعلّمات النصية عند تسجيلها في إعداد التقارير.

من الناحية النظرية، تربط المقاييس والمكوّنات المخصّصة لنطاق متنوع في موقع على Universal Analytics بموقع على "إحصاءات Google"‏ 4 على النحو التالي:

  • المكوّن المخصّص على نطاق النتيجة: المعلّمة (يتم تسجيل 25 معلّمة إجمالاً بحدٍ أقصى لكل حدث أثناء جمع البيانات، ويتم تسجيل 50 مكوّنًا مخصّصًا/50 مقياسًا مخصّصًا بحدٍ أقصى)
    يُرجى ملاحظة أن الأحداث والمعلّمات المجمَّعة تلقائيًا قد تغطي حاليًا بعض حالات الاستخدام التي كانت تتم فيها الاستعانة بمكوّنات مخصّصة على نطاق النتيجة في السابق.
  • المكوّن المخصّص على نطاق المستخدم: user-properties (تسجيل 25 بحدٍ أقصى لإعداد التقارير من خلال واجهة المستخدم). ولا يتم احتساب خصائص المستخدمين المجمَّعة تلقائيًا ضمن هذا الحدّ.
  • المكوّن المخصّص على مستوى الجلسة: بلا مكافئ في الموقع على "إحصاءات Google"‏ 4، انظر إلى المعلّمات المخصّصة أو خصائص المستخدمين بدلاً من ذلك.

أفضل ممارسات خصائص المستخدمين

تشبه خصائص المستخدمين المكوّنات المخصّصة على نطاق المستخدم. وهذا يعني أنها تتقيّد بالمستخدم على مستوى الأنظمة الأساسية المختلفة (على سبيل المثال، في جميع أنواع مصادر البيانات)، وبالتالي يجب عدم استخدامها إلا إذا كانت البيانات تنطبق على مستوى المستخدم.

يجب عدم استخدام خصائص المستخدمين للبيانات على مستوى الجلسة أو البيانات على مستوى الجهاز (مثل حجم الشاشة).

مثال على موقع "إحصاءات Google"‏ 4

gtag('set', 'user_properties', {

favorite_composer: 'Mahler',

favorite_instrument: 'double bass',

season_ticketholder: 'true'

});

هل كان ذلك مفيدًا؟
كيف يمكننا تحسينها؟
بحث
محو البحث
إغلاق البحث
تطبيقات Google
القائمة الرئيسية
مركز مساعدة البحث
true
69256
false