يوضّح هذا الدليل التوجيهي طريقة استخدام "إحصاءات Google" لتتبُّع استخدام إضافتك. إذا كنت تطوِّر تطبيقًا لنظام التشغيل، فراجع إحصاءات التطبيقات نظرًا لأن التطبيقات لها قيود مختلفة عن الإضافات.
المتطلّبات
يتوقع هذا البرنامج التعليمي أن تكون لديك بعض إضافات الكتابة المألوفة لمتصفّح Google Chrome. إذا كنت بحاجة إلى معلومات حول كيفية كتابة إضافة، يُرجى قراءة البرنامج التعليمي للبدء.
وستحتاج أيضًا إلى إعداد حساب على "إحصاءات Google" لتتبّع إضافتك. لاحظ أنّه عند إعداد الحساب، يمكنك استخدام أي قيمة في حقل "عنوان URL للموقع الإلكتروني"، لأنّ إضافتك لن يكون لها عنوان URL خاص بها.
تثبيت شفرة التتبع
يجلب مقتطف رمز التتبّع العادي في "إحصاءات Google" ملفًا باسم ga.js من عنوان URL محمي بطبقة المقابس الآمنة إذا تم تحميل الصفحة الحالية باستخدام بروتوكول https://. قد تستخدم إضافات Chrome وتطبيقاته
فقط الإصدار المحمي من طبقة المقابس الآمنة من ga.js. لا تسمح سياسة أمان المحتوى التلقائية في Chrome بتحميل بروتوكول ga.js عبر بروتوكول HTTP غير الآمن. يتطلب ذلك، بالإضافة إلى استضافة إضافات Chrome ضمن مخطط chrome-extension://، تعديلاً طفيفًا في مقتطف التتبّع المعتاد لسحب ga.js مباشرةً من https://ssl.google-analytics.com/ga.js بدلاً من الموقع التلقائي.
في ما يلي مقتطف معدَّل لواجهة برمجة التطبيقات للتتبّع غير المتزامن (الخط المعدّل بخط غامق):
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = 'https://ssl.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
عليك أيضًا التأكّد من إمكانية وصول الإضافة لتحميل المورد من خلال تخفيف
سياسة أمان المحتوى التلقائية. قد يبدو تعريف السياسة في manifest.json على النحو التالي:
{
...,
"content_security_policy": "script-src 'self' https://ssl.google-analytics.com; object-src 'self'",
...
}
في ما يلي صفحة منبثقة (popup.html) تُحمِّل رمز التتبّع غير المتزامن عبر ملف JavaScript خارجي (popup.js) وتتتبّع مشاهدة صفحة واحدة:
<!DOCTYPE html>
<html>
<head>
...
<script src="popup.js"></script>
</head>
<body>
...
</body>
</html>
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-XXXXXXXX-X']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = 'https://ssl.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
ضَع في اعتبارك أنّه يجب استبدال السلسلة UA-XXXXXXXX-X برقم حسابك على "إحصاءات Google".
تتبع مشاهدات الصفحات
سيتتبّع الرمز _gaq.push(['_trackPageview']); مشاهدة واحدة للصفحة. يمكن استخدام هذا الرمز على أي صفحة في إضافتك. وعند وضعه في صفحة خلفية، سيتم تسجيل مشاهدة مرة واحدة لكل جلسة في المتصفح. وعند وضعه في نافذة منبثقة، سيتم تسجيل عرض مرة واحدة في كل مرة يتم فيها فتح النافذة المنبثقة.
من خلال الاطّلاع على بيانات مشاهدة الصفحة لكل صفحة في الإضافة، يمكنك الحصول على فكرة حول عدد المرات التي يتفاعل فيها المستخدمون مع الإضافة في كل جلسة متصفّح:
رصد طلبات الإحصاءات
لضمان إرسال بيانات التتبّع من إضافتك إلى "إحصاءات Google"، يمكنك فحص صفحات إضافتك في نافذة "أدوات المطوّرين" (اطّلع على البرنامج التعليمي لتصحيح الأخطاء للاطّلاع على مزيد من المعلومات). كما يبيّن الشكل التالي، من المفترض أن تظهر لك طلبات لملف باسم __utm.gif في حال تم إعداد كل شيء بشكلٍ صحيح.
تتبُّع الأحداث
من خلال ضبط ميزة تتبُّع الأحداث، يمكنك تحديد أجزاء الإضافة التي يتفاعل معها المستخدمون أكثر من غيرها. على سبيل المثال، إذا كان لديك ثلاثة أزرار يمكن للمستخدمين النقر عليها:
<button id='button1'>Button 1</button>
<button id='button2'>Button 2</button>
<button id='button3'>Button 3</button>
كتابة دالة ترسِل أحداث النقرات إلى "إحصاءات Google":
function trackButton(e) {
_gaq.push(['_trackEvent', e.target.id, 'clicked']);
};
واستخدمه كمعالج أحداث لكل نقرة على زر:
var buttons = document.querySelectorAll('button');
for (var i = 0; i < buttons.length; i++) {
buttons[i].addEventListener('click', trackButtonClick);
}
ستقدّم لك صفحة النظرة العامة حول تتبُّع الأحداث في "إحصاءات Google" مقاييس بشأن عدد مرات النقر على كل زر فردي:
وباستخدام هذا النهج، يمكنك معرفة الأجزاء التي يتم استخدامها بشكل كافٍ أو زائد عن الحد. يمكن أن تساعد هذه المعلومات في توجيه القرارات المتعلقة بعمليات إعادة تصميم واجهة المستخدم أو الوظائف الإضافية المطلوب تنفيذها.
لمزيد من المعلومات عن استخدام تتبع الأحداث، اطّلع على وثائق مطوّري البرامج في Google Analytics.
نموذج التعليمات البرمجية
تتوفّر في مستودع النماذج مثال للإضافة التي تستخدم هذه الأساليب.