يوضّح لك هذا الدليل كيفية إعداد مَعلمات للأحداث المقترَحة و الأحداث المخصّصة على موقعك الإلكتروني لتتمكّن من جمع المزيد من المعلومات من أحداثك. لمزيد من المعلومات عن كيفية إضافة مَعلمات على مستوى المنتج أو الخدمة، اطّلِع على مقالة قياس التجارة الإلكترونية.
الجمهور
تريد جمع المزيد من المعلومات عن نشاط المستخدِمين من خلال الأحداث التي سبق لك إعدادها.
تستخدِم إما علامة Google (gtag.js) أو أداة "إدارة العلامات من Google" على موقعك الإلكتروني. إذا أردت إعداد مَعلمات أحداث لتطبيق متوافق مع الأجهزة الجوّالة، اطّلِع على مقالة تسجيل الأحداث.
قبل البدء
قبل استخدام هذا الدليل، يجب أن تكون قد نفّذت الإجراءات التالية:
- إنشاء حساب وموقع على "إحصاءات Google"
- إنشاء مصدر بيانات لموقعك الإلكتروني
- وضع مقتطف علامة التتبُّع من 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هما قيَم مَعلمتَي الحدث
ملاحظة مهمة: تسجيل المَعلمات المخصّصة
إنّ إرسال مَعلمات مخصّصة في الرمز هو الخطوة الأولى فقط. لكي تعرض "إحصاءات Google" البيانات من أي مَعلمات مخصّصة وتسمح لك بتحليلها في التقارير والاستكشافات العادية، عليك تسجيلها كسمات أو مقاييس مخصّصة ضِمن واجهة "إحصاءات Google". بدون هذا التسجيل، يتم جمع بيانات المَعلمات ولكن لا تتوفّر لإعداد التقارير.
إعداد مَعلمات لكل حدث
تستخدِم الأمثلة في القسم السابق الأمر 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 يتطلّب بعض الإعدادات الإضافية قبل أن تتمكّن من استخدامه.
ومع ذلك، للاطّلاع على قيَم أي مَعلمات مخصّصة تُرسِلها وتحليلها ضِمن واجهة إعداد التقارير الأوسع في "إحصاءات Google" (مثل الاستكشافات أو التقارير العادية)، عليك أولاً تسجيلها كسمات أو مقاييس مخصّصة. بعد تسجيل سمة أو مقياس مخصّص، قد يستغرق ظهور البيانات في تقاريرك مدة تصل إلى 48 ساعة.
مزيد من المعلومات عن المقاييس والسمات المخصّصة.
التأكّد في DebugView
عند استخدام تقرير DebugView ، يتم تطبيق المَعلمات التي تم تحديدها باستخدام gtag('set') على جميع طلبات gtag('event') اللاحقة على الصفحة. للتأكّد من ذلك،
احرص على تنفيذ الأمر gtag('set') قبل بدء الحدث.
بعد ذلك، اختَر حدثًا في DebugView واطّلِع على علامة التبويب المَعلمات للاطّلاع على القائمة المدمَجة للمَعلمات، بما في ذلك المَعلمات التي تم ضبطها على مستوى العالم.
تتم تعبئة السمات والمقاييس المنشأة مسبقًا في "إحصاءات Google" ببعض المَعلمات تلقائيًا. على سبيل المثال، تتم تعبئة السمات والمقاييس المنشأة مسبقًا بالمَعلمات في أحداث القياس المحسّن والأحداث المجمّعة تلقائيًا، وكذلك المَعلمات المطلوبة والاختيارية التي تُرسِلها مع الأحداث المقترَحة.
تتطلب المَعلمات الأخرى إنشاء سمات ومقاييس مخصَّصة للاطّلاع على قيَم المَعلمات في "إحصاءات Google".
الخطوات التالية
أنشِئ سمات ومقاييس مخصّصة لمَعلمات الحدث المخصّص.