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

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

الجمهور

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

تستخدِم إما علامة 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': 'Travel Destinations',
  'currency': 'USD'
});
</script>

إذا أضفت أكثر من رقم تعريف علامة واحد إلى صفحتك، أضِف الأمر set بدلاً من تعديل الأمر config كي تكتسب جميع أرقام التعريف المَعلمات التي ضبطتها. ضَع الأمر 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 يتطلب بعض التهيئة الإضافية قبل أن تتمكن من استخدام التقرير. ويعرِض لك هذان التقريران الأحداث التي يبدؤها المستخدمون على موقعك الإلكتروني عند بدء الأحداث.

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

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

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

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