رمز التتبّع: تتبّع الأحداث

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

طرق تتبع أحداث GATC

  • _trackEvent(category, action, opt_label, opt_value, opt_noninteraction)

تفاصيل الطريقة

_trackEvent()

    _trackEvent(category, action, opt_label, opt_value, opt_noninteraction)

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

    يمكنك استخدام أي من المَعلمات الاختيارية التالية: opt_label أو opt_value أو opt_noninteraction. إذا كنت تريد توفير قيمة فقط للمَعلمة الاختيارية الثانية أو الثالثة، عليك ضبط قيمة undefined للمَعلمة الاختيارية السابقة.

    المَعلَمات

      String   category فئة الحدث العامة (مثل "الفيديوهات")

      String
        action
      الإجراء المتعلّق بالحدث (مثل "تشغيل")

      String
        opt_label
      وصف اختياري للفعالية

      Int
           opt_value
      هي قيمة اختيارية مرتبطة بالفعالية. يمكنك الاطّلاع على قيم أحداثك في تقارير "نظرة عامة" و"الفئات" و"الإجراءات"، حيث يتم إدراجها حسب الحدث أو تجميعها في مختلَف الأحداث، استنادًا إلى طريقة عرض التقارير.

      Boolean  opt_noninteraction القيمة التلقائية هي false. ستؤثّر نتيجة الحدث المُرسَلة من _trackEvent() تلقائيًا في معدّل ارتداد الزائر. من خلال ضبط هذه المعلَمة على "صحيح"، لن يتم استخدام نتيجة الحدث هذه في عمليات احتساب معدل الارتداد.

      returns

        Boolean ما إذا تم إرسال الحدث بنجاح أم لا.