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

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

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

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