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

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

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

يمكنك إضافة أحداث إلى JavaScript في أي مكان أسفل مقتطف "علامة تتبُّع من Google". لن تعالج Google البيانات من الأحداث التي تضعها فوق مقتطف &quot;علامة التتبُّع من Google&quot;. على سبيل المثال، يتضمّن رمز نموذجي الرمز التالي حدثًا مقترَحًا باسم 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
التالي
إضافة معلمات