إعداد مَعلمات الأحداث

يوضّح لك هذا الدليل كيفية إعداد مَعلمات الأحداث المقترَحة والأحداث المخصّصة على موقعك الإلكتروني حتى تتمكّن من جمع المزيد من المعلومات من أحداثك. للحصول على معلومات حول كيفية إضافة مَعلمات على مستوى المنتج أو الخدمة، اطّلِع على مقالة قياس التجارة الإلكترونية.

الجمهور

تريد جمع المزيد من المعلومات عن نشاط المستخدمين من خلال الأحداث التي سبق أن أعددتها.

استخدام "علامة التتبُّع من Google"‏ (gtag.js) أو أداة "إدارة العلامات من Google" على موقعك الإلكتروني إذا كنت تريد إعداد مَعلمات أحداث لتطبيق على الأجهزة الجوّالة، اطّلِع على مقالة تسجيل الأحداث.


قبل البدء

قبل استخدام هذا الدليل، يجب أن تكون قد نفّذت الإجراءات التالية:

يجب أن يكون لديك أيضًا ما يلي:

  • لديك الإذن بالوصول إلى رمز المصدر الخاص بموقعك الإلكتروني
  • دور المحرِّر (أو دور أعلى) في حساب "إحصاءات Google"

ننصحك أيضًا بقراءة مقالة إعداد الأحداث قبل قراءة هذا الدليل.

التعرّف على مَعلمات الأحداث

توفّر المَعلمات معلومات إضافية عن طُرق تفاعل المستخدِمين مع موقعك الإلكتروني. على سبيل المثال، عندما يطّلع مستخدم على منتج تبيعه، يمكنك تضمين مَعلمات تصف المنتج الذي اطّلع عليه، مثل اسمه وفئته وسعره.

تتضمّن أحداث القياس المحسّن والأحداث المجمّعة تلقائيًا مَعلمات بشكلٍ تلقائي. توفّر Google أيضًا مجموعة من المَعلمات المطلوبة والاختيارية لتضمينها مع كل حدث مقترَح. إضافةً إلى ذلك، يمكنك تضمين المزيد من مَعلمات الأحداث عند الحاجة.

إعداد مَعلمات الأحداث

تتضمّن الأحداث البنية التالية، حيث تمثّل <event_parameters> مَعلمات الحدث، وهي مكتوبة في صورة أزواج مفاتيح/قيم:

gtag('event', '<event_name>', {
  <event_parameters>
});

انظر المثال التالي:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

في هذا المثال:

  • app_name وscreen_name هما اسما مَعلمتَي الحدث
  • myAppName وHome هما قيمتَا مَعلمة الحدث

إعداد مَعلمات لكل حدث

تستخدِم الأمثلة الواردة في القسم السابق الأمر event في الدالة gtag() لإرسال مَعلمات لحدث واحد. يمكنك أيضًا تعديل الأمر config في مقتطف علامة تتبُّع من Google (في علامة HTML الخاصة بـ <head>) لإرسال المَعلمات مع كل حدث على الصفحة.

يؤدّي ما يلي إلى ضبط عنوان الصفحة ثم إرسال المَعلمة مع كل حدث على الصفحة:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());

gtag('config', 'G-XXXXXXXXXX', {
  'page_title': 'Contact Us',
  'currency': 'EUR'
});
</script>

في حال إضافة أكثر من رقم تعريف علامة واحد إلى صفحتك، استخدِم الأمر set للمَعلمات الشاملة الموثّقة (مثل user_id وpage_title وcurrency) لكي تكتسب جميع أرقام التعريف القيم. ضَع الأمر set أعلى الأمر config.

gtag('set', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
// Place your config commands after the set command like follows
gtag('config', 'G-XXXXXXXXXX-1');
gtag('config', 'G-XXXXXXXXXX-2');
gtag('config', 'G-XXXXXXXXXX-3');

الاطّلاع على أحداثك في "إحصاءات Google"

يمكنك الاطّلاع على أحداثك ومَعلماتها باستخدام تقريرَي الوقت الفعلي وDebugView. يُرجى العِلم أنّ تقرير DebugView يتطلّب بعض الإعدادات الإضافية قبل أن تتمكّن من استخدامه. يعرض لك هذان التقريران الأحداث التي يبدأها المستخدمون على موقعك الإلكتروني أثناء حدوثها.

التحقّق في DebugView

عند استخدام تقرير DebugView، يتم تطبيق المَعلمات المحدّدة باستخدام gtag('set') على جميع استدعاءات gtag('event') اللاحقة على الصفحة. للتأكّد من ذلك، احرص على تنفيذ الأمر gtag('set') قبل إطلاق الحدث. بعد ذلك، اختَر حدثًا في DebugView وافحص علامة التبويب المَعلمات للاطّلاع على قائمة المَعلمات المدمَجة، بما في ذلك المَعلمات التي تم ضبطها على مستوى العالم.

تتم تعبئة السمات والمقاييس المنشأة مسبقًا في "إحصاءات Google" ببعض المَعلمات تلقائيًا. على سبيل المثال، تتم تعبئة المقاييس والسمات التي تم إنشاؤها مُسبقًا بالمَعلمات في أحداث القياس المحسَّن والأحداث المجمَّعة تلقائيًا، وكذلك المَعلمات المطلوبة والاختيارية التي تُرسِلها مع الأحداث المقترَحة.

تتطلّب المَعلمات الأخرى إنشاء سمات ومقاييس مخصّصة للاطّلاع على قيم المَعلمات في "إحصاءات Google".

الخطوات التالية

أنشِئ سمات ومقاييس مخصّصة لمَعلمات الأحداث المخصّصة.

السابق
إعداد الأحداث
التالي
إرسال أرقام تعريف المستخدمين