إعداد الأحداث

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

أنواع الأحداث

يتم تجميع أحداث "إحصاءات Google" في أربع فئات:

نوع الحدث رابط هل يجب إعدادها؟ الوصف وحالة الاستخدام
الأحداث التي يتم جمعها تلقائيًا مزيد من المعلومات لا يتم جمعها تلقائيًا عند إعداد علامة "إحصاءات Google" على موقعك الإلكتروني أو تطبيقك. وتشمل الأمثلة first_visit وsession_start وuser_engagement.
القياس المحسَّن مزيد من المعلومات لا (عادةً) يتم جمعها تلقائيًا عند تفعيل القياس المحسَّن في واجهة مستخدِم "إحصاءات Google". يقيس التفاعلات الشائعة على الويب، مثل scroll وclick وfile_download.
الأحداث المُقترَحة مرجع الأحداث المُقترَحة نعم أحداث موحّدة لقطاعات مختلفة من الأنشطة التجارية (مثل البيع بالتجزئة والسفر والألعاب) تتيح لوحات إعداد التقارير الجاهزة. أمثلة: purchase وlogin وsign_up.
الأحداث المخصّصة مزيد من المعلومات نعم أحداث تحدّدها بنفسك لأنّه ليس هناك حدث تلقائي أو محسّن أو مُقترَح يناسب احتياجاتك. يمكن الوصول إليها باستخدام التقارير المخصّصة.

يوضّح لك هذا الدليل كيفية إعداد الأحداث المُقترَحة والأحداث المخصّصة على موقعك الإلكتروني باستخدام "علامة التتبُّع من Google"‏ (gtag.js) أو أداة "إدارة العلامات من Google". ليس عليك إعداد أحداث يتم جمعها تلقائيًا والقياس المحسَّن.

الجمهور

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


قبل البدء

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

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

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

نظرة عامة على "علامة التتبُّع من Google"‏ (gtag.js)

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

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

في هذا المثال، تتضمّن الدالة gtag() ما يلي:

  • أمر event يُعلم Google بأنّك تُرسِل حدثًا
  • اسم الحدث المُقترَح أو المخصّص
  • (اختياري) مجموعة من المَعلمات التي توفّر معلومات إضافية عن الحدث

على سبيل المثال، في ما يلي حدث مُقترَح باسم screen_view يتضمّن مَعلمتَين:

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

إضافة أحداث إلى JavaScript

gtag() هي دالة JavaScript، لذا عليك إضافة الدالة إلى JavaScript على صفحة الويب. على سبيل المثال، يمكنك إضافة الدالة ضمن علامتَي <script> أو في ملف JavaScript منفصل تستورده إلى صفحة HTML page.

يمكنك إضافة الأحداث إلى JavaScript في أي مكان أسفل مقتطف "علامة التتبُّع من Google". لن تعالج Google البيانات من الأحداث التي تضعها أعلى مقتطف "علامة التتبُّع من Google". على سبيل المثال، يتضمّن نموذج الرمز التالي حدثًا مُقترَحًا باسم screen_view وحدثًا مخصّصًا باسم signup_newsletter ضمن علامة <script>:

<!DOCTYPE html>
<html lang="en">
<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');
    </script>

    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Title of the page</title>
</head>
<body>
    <p>Welcome to my website!</p>
    
    <script>
      /**
      *   The following events are sent when the page loads. You send
      *   recommended and custom events the same way. You could wrap
      *   the events in JavaScript functions so they are sent when
      *   users perform specific actions.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
      gtag('event', 'signup_newsletter', {
        'method': 'web'
      });
    </script> 
</body>
</html>

إذا كنت تريد إرسال الحدث استنادًا إلى نقرة على زر (أو إجراء آخر من قِبل المستخدِم)، يمكنك إضافة بعض JavaScript الإضافية إلى الحدث.

إعداد أحداث متعدّدة

يتطلّب تتبُّع تفاعلات المستخدِمين المختلفة تنفيذ طلبات متعدّدة gtag('event', ...) في JavaScript الخاص بموقعك الإلكتروني، ويتم تشغيل كل منها من خلال إجراء أو شرط معيّن. تستخدِم الأمثلة كلاً من الأحداث المُقترَحة والأحداث المخصّصة.

على سبيل المثال، لتتبُّع أنشطة مختلفة، مثل عمليات تسجيل دخول المستخدِمين ومشاركة المحتوى وإكمال البرامج التعليمية، نفِّذ طلبات منفصلة من gtag('event', ...) calls:

مثال: تتبُّع عمليات تسجيل الدخول

سيتم تضمين هذا المقتطف في دالة JavaScript التي تعالج عمليات تسجيل دخول المستخدِمين الناجحة.

// Send a 'login' event when a user signs in
gtag('event', 'login', {
  method: 'Email' // Example parameter indicating login method
});

مثال: تتبُّع عمليات مشاركة المحتوى

سيتم ربط هذا المقتطف بحدث ناتج عن النقر على زر المشاركة.

// Send a 'share' event when a user clicks a share button
gtag('event', 'share', {
  method: 'Facebook',
  content_type: 'Article',
  item_id: 'C12345' // Example parameter for the shared item
});

مثال: تتبُّع حدث مخصّص

سيتم استدعاء هذا المقتطف عندما يُكمل المستخدِم بنجاح برنامجًا تعليميًا على الموقع الإلكتروني.

// Send a custom event
gtag('event', 'tutorial_complete', {
  tutorial_name: 'Introduction to GA4'
});

يمكنك تضمين طلبات gtag('event', ...) هذه في نقاط مختلفة من رمز موقعك الإلكتروني لجمع البيانات في الوقت المناسب. يتم إرسال كل حدث إلى "إحصاءات Google" عند وقوعه. ليس هناك بنية خاصة أو طلب واحد لتحديد أو إرسال أنواع مختلفة من الأحداث في دفعة باستخدام gtag.js، عليك استدعاء gtag('event', ...) لكل حدث تريد إرساله.

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

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

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

السابق
Web
التالي
إضافة معلمات