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

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

يوضّح لك هذا الدليل كيفية إعداد الأحداث المقترَحة والأحداث المخصّصة على موقعك الإلكتروني باستخدام علامة 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 الخاص بك .

يمكنك إضافة أحداث إلى JavaScript في أيّ مكان أسفل مقتطف علامة Google. لن تعالج Google البيانات من الأحداث التي تضعها فوق علامة Google. المقتطف. على سبيل المثال، يتضمن الرمز النموذجي التالي حدثًا يسمى screen_view في علامة <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 event is sent when the page loads. You could
      *   wrap the event in a JavaScript function so the event is
      *   sent when the user performs some action.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
    </script> 
</body>
</html>

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

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

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

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