قياس الأحداث

يوضّح هذا الدليل كيفية قياس الأحداث باستخدام analytics.js.

نظرة عامة

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

إذا لم تكن على دراية بالأحداث في "إحصاءات Google"، عليك أولاً قراءة المقالة لمحة عن الأحداث في مركز مساعدة "إحصاءات Google".

التنفيذ

يمكن إرسال نتائج الحدث باستخدام الأمر send وتحديد hitType لـ event. يتضمن الأمر send التوقيع التالي لنوع نتيجة event:

ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

حقول الأحداث

يلخّص الجدول التالي حقول الأحداث:

اسم الحقل	نوع القيمة	مطلوبة	الوصف
`eventCategory`	text	نعم	عادةً ما يكون الكائن الذي تم التفاعل معه (مثل `'Video'`)
`eventAction`	text	نعم	نوع التفاعل (مثل `'play'`)
`eventLabel`	text	لا	مفيد لتصنيف الأحداث (مثل `'Fall Campaign'`)
`eventValue`	عدد صحيح	لا	قيمة رقمية مرتبطة بالحدث (مثلاً `42`)

للحصول على وصف أكثر تفصيلاً لكل حقل من هذه الحقول، يمكنك الاطّلاع على تحليل الحدث في مركز مساعدة "إحصاءات Google".

أمثلة:

يؤدي الأمر التالي إلى إرسال حدث إلى "إحصاءات Google" يشير إلى أنّه تم تشغيل الفيديو الترويجي لحملة الخريف:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

يُرجى ملاحظة أنّه كما هو الحال مع جميع أوامر send، يمكن أيضًا تحديد الحقول التي تم تمريرها في المَعلمات الملائمة في fieldsObject. يمكن إعادة كتابة الأمر أعلاه على النحو التالي:

ga('send', {
  hitType: 'event',
  eventCategory: 'Videos',
  eventAction: 'play',
  eventLabel: 'Fall Campaign'
});

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

قياس الروابط الخارجية والنماذج

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

يمكن قياس الروابط الصادرة وأحداث النماذج عن طريق إرسال الأحداث وتحديد عنوان URL المقصود في أحد حقول الأحداث. يمكن استخدام وظيفة معالج الأحداث التالية لإرسال أحداث النقرات على الروابط الخارجية إلى "إحصاءات Google":

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href
  });
}

قد يكون قياس الروابط الصادرة والنماذج أمرًا صعبًا لأن معظم المتصفحات ستتوقف عن تنفيذ JavaScript في الصفحة الحالية بعد بدء تحميل صفحة جديدة. أحد حلول هذه المشكلة هو ضبط الحقل transport على beacon:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href,
    transport: 'beacon'
  });
}

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

الأحداث بلا تفاعل

في بعض الحالات، قد تحتاج إلى إرسال حدث باعتباره حدثًا غير تفاعُل. ولإجراء ذلك، حدِّد الحقل nonInteraction على أنّه true في fieldsObject من الأمر send:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign', {
  nonInteraction: true
});

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