[GA4←UA] كيفية ربط gtag.js لموقع على Universal Analytics بموقع على "إحصاءات Google"‏ 4

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

في هذه المقالة:

• لمحة عن مقتطف gtag.js
• جمع البيانات الأساسية
• إعدادات ضبط مقتطف gtag.js
• الأحداث
• المقاييس والمكوّنات المخصّصة

لمحة عن مقتطف gtag.js وأرقام تعريف المواقع

يتماثل بشكلِ جوهري مقتطفا gtag.js لكلٍّ من المواقع على Universal Analytics والمواقع على "إحصاءات Google"‏ 4. ويتسم كلا المقتطفين بالبنية التالية:

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>

السطر 1: إذا كنت قد نفَّذت أحد مواقع Universal Analytics من خلال مقتطف gtag.js، من المحتمل أن يكون سطر الرمز هذا مُدرَجًا في موقعك الإلكتروني. وبدلاً من <Some Property ID A>، سترى الجزء "-UA" متبوعًا بسلسلة من الأرقام. وفي حال تنفيذ مقتطف gtag.js من أجل "إعلانات Google" أو منتج آخر من "منصة Google للتسويق"، قد يكون سطر الرمز هذا أيضًا مُدرَجًا في موقعك الإلكتروني، إلا أن الجزء <Some Property ID A> سيبدأ بـ "-AW" أو "-DC".

جدير بالذكر أنّ رقم تعريف الموقع (أو رقم تعريف العلامة، لمواقع "إحصاءات Google‏ 4")، المُشار إليه من خلال <Some Property ID A>، "يتحكّم" في مقتطف gtag.js هذا. وهذا أمر مهم للأسباب التالية:

1. إذا كان هذا السطر موجود، لا يتطلب الأمر تنفيذه مرة أخرى. ستحتاج فقط إلى إضافة سطر "config" لتحديد رقم تعريف العلامة.
2. رقم تعريف الموقع في هذا السطر هو "عنصر التحكّم" في مقتطف gtag.js. إذا كان رقم تعريف أحد المواقع على Universal Analytics (مثل "UA-XXXXXXXX") يتحكّم في العلامة، ستتمكّن من استخدام علامات المواقع الإلكترونية المرتبطة لإرسال بيانات القياس إلى أحد المواقع على "إحصاءات Google"‏ 4، بدون الحاجة إلى إضافة أي رمز جديد إلى الصفحة.

السطر 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>.

يعمل الأمر gtag config على تفعيل القياس الأساسي.

• بالنسبة إلى أحد مواقع Universal Analytics، يُرسِل الأمر "config" مع رقم تعريف موقع Universal Analytics نتيجة مشاهدة صفحة.
• بالنسبة إلى أحد المواقع على "إحصاءات Google‏ 4"، يعمل الأمر "config" مع رقم تعريف العلامة على جمع أحداث page_view (كحدث مجمّع تلقائيًا) عند تحميل هذا الأمر على إحدى الصفحات.

أرقام تعريف المواقع

تستخدِم أرقام تعريف مواقع Universal Analytics التنسيق "UA-XXXXXXXX". ويُشار إليها أحيانًا باسم "رقم تعريف التتبع". وفي هذا الدليل، سنُشير إليه على أنه رقم تعريف موقع UA.

تستخدِم مصادر بيانات المواقع الإلكترونية للمواقع على "إحصاءات Google‏ 4" رقم تعريف علامة بالتنسيق "G-XXXXXXXX".

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

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

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

• أحداث page_view
• الأحداث المُجمَّعة تلقائيًا
• أحداث القياس المحسّن (في حال تفعيلها في واجهة المستخدم)

إذا كان موقعك الحالي على Universal Analytics يستخدِم تنفيذ مقتطف gtag.js، يمكنك تفعيل جمع البيانات الأساسي لموقعك على "إحصاءات Google"‏ 4 عن طريق:

• الخيار 1: إضافة توجيه "config" جديد باستخدام رقم تعريف العلامة الملائم.
  أو
• الخيار 2: تفعيل علامات المواقع الإلكترونية المرتبطة (إذا كان تنفيذ مقتطف gtag.js الحالي مؤهَّلاً).

بغض النظر عن خيارك، لن يتأثر موقعك الحالي على Universal Analytics وسيستمر في جمع البيانات.

الخيار 1: إضافة أمر "config" جديد

في حال وجود رمز gtag.js حالي في الصفحة، ما عليك سوى إدراج أمر "config" إضافي باستخدام رقم تعريف قياس موقع "إحصاءات Google"‏ 4 الملائم. وفي المثال التالي، تمت إضافة السطر 8 إلى تنفيذ رمز gtag.js حالي. وهو يشير مرجعيًا إلى رقم تعريف قياس موقع "إحصاءات Google"‏ 4. وسيؤدي هذا إلى إرسال أحداث page_view إلى ذلك الموقع على "إحصاءات Google"‏ 4. كما أنه يفعِّل أيضًا الأحداث المجمَّعة تلقائيًا وأحداث القياس المحسّن (في حال تفعيل القياس المحسّن) في ذلك الموقع على "إحصاءات Google"‏ 4.

1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>

2: <script>

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

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

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

6:

7: gtag('config', '<Some Property ID A>');

8: gtag('config', 'G-XXXXXXXX');

9: </script>

الخيار 2: تفعيل علامات المواقع الإلكترونية المرتبطة

يمكنك استخدام علامة الموقع الإلكتروني المرتبطة في الحالات التالية:

• كان يتم التحكّم في مقتطف gtag.js الحالي على الصفحة، التي تريد قياس تفاعلات المستخدم فيها، بواسطة موقع Universal Analytics (أي أن رقم التعريف المُشار إليه في هذا السطر من مقتطف gtag.js يبدأ بـ "-UA"):

<script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>

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

• وكذلك كان لديك إذن وصول إداري إلى موقع Universal Analytics الذي يشير إليه رقم التعريف في المقتطف.

في حال تنفيذ كلٍّ من علامة gtag.js وحاوية GTM في صفحتك، يجب وضع علامة gtag.js أعلى حاوية GTM حتى تعمل علامات المواقع الإلكترونية المرتبطة.

إعدادات ضبط مقتطف gtag.js

يمكنك ضبط مقتطف gtag.js الأساسي للتحكّم في إعدادات جمع البيانات مثل إخفاء هوية عناوين IP، وعمليات تخصيص ملفات تعريف الارتباط، وإشارات Google. ويمكنك إجراء ذلك من خلال أمر "config" أو أمر "set" في مقتطف gtag.js.

تتيح كلٌّ من المواقع على Universal Analytics (بالتنسيق "UA-XXXXXXXX") والمواقع على "إحصاءات Google"‏ 4 (بالتنسيق "G-XXXXXXXX") تنفيذ إعدادات الضبط هذه من خلال مقتطف gtag.js. ومع ذلك، هناك بعض الاختلافات بين هذه الإعدادات لكلٍّ من المواقع على Universal Analytics والمواقع على "إحصاءات Google"‏ 4. 

• يتم توحيد إخفاء هوية عناوين IP على "صحيح" ولا يكون قابلاً للضبط في موقع على "إحصاءات Google"‏ 4. وبناءً على ذلك، يتم حجب عنوان IP تلقائيًا باستخدام الحدث العادي للموقع على "إحصاءات Google"‏ 4 ("G-XXXXXXXX").

• عندما يلزم تطبيق الإعدادات العمومية على كل المواقع التي تم ضبطها، يجب استخدام الأمر "set" لتطبيق كل أرقام تعريف القياس و/أو أرقام تعريف المواقع، بما في ذلك ما تم تنفيذه من خلال علامات المواقع الإلكترونية المرتبطة.
• انتبِه بوجهٍ خاص إلى ميزات إيقاف تخصيص الإعلانات، والتي عادةً ما يتم تنفيذها مع سطر "config".
• عند استخدام علامات المواقع الإلكترونية المرتبطة: لا يتم تطبيق أي عمليات ضبط في رمز gtag.js باستخدام الأمر "config" إلا على الموقع المرتبط برقم تعريف القياس في ذلك السطر من الرمز، ولن يتم إرسالها تلقائيًا إلى المواقع على "إحصاءات Google"‏ 4. وإذا كنت تريد تطبيق الضبط على الموقع المرتبط على "إحصاءات Google"‏ 4،
  • عليك إنشاء أمر "config" منفصل وتطبيقه على الموقع الملائم على "إحصاءات Google"‏ 4 من خلال الإشارة إلى رقم تعريف القياس
    أو
  • عليك ضبط الإعداد باستخدام أمر "set"، وفي هذه الحالة سيتم تطبيق الضبط على جميع المواقع التي تم ضبطها.

أمثلة الضبط

تفعيل جمع البيانات الأساسي، ضبط User-ID

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

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

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

});

الأحداث

ارجع إلى دليل نقل بيانات الأحداث.

المقاييس والمكوّنات المخصّصة

يمكن استخدام المقاييس والمكوّنات المخصّصة لتوسيع المعلومات واستيراد البيانات بلا اتصال بالإنترنت، من أنظمة إدارة علاقات العملاء (CRM) مثلاً.

عند استخدام علامة Google ‏(gtag.js) تتم ترجمة قيم المقاييس والسمات المخصّصة إلى معلّمات تلقائيًا في حال استخدام علامات المواقع الإلكترونية المرتبطة أو أحد المواقع على "إحصاءات Google‏ 4" (مثل "G-XXXXXXXX").

اطّلِع على مزيد من المعلومات عن المقاييس والمكوّنات المخصّصة.