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

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

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

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

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

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

الجمهور

لقد أعددت "إحصاءات 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 الإضافي إلى الحدث.

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

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

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

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