علامة Google (gtag.js) هي إطار عمل لوضع علامات JavaScript وواجهة برمجة تطبيقات تتيح لك إرسال بيانات الأحداث إلى "إحصاءات Google" و"إعلانات Google" و"منصة Google للتسويق". توضّح هذه الصفحة كيفية استخدام gtag.js لإعداد موقع إلكتروني من أجل "إحصاءات Google". بالنسبة إلى مستندات gtag.js العامة (أي المنتجات غير المحدّدة للمنتج)، اطّلِع على دليل مطوّري برامج gtag.js.
تثبيت علامة Google
لتثبيت علامة Google، انسخ الرمز التالي والصقه مباشرةً بعد علامة <head> في كل صفحة من موقعك الإلكتروني. استبدِل
GA_TRACKING_ID برقم تعريف موقع "إحصاءات Google" الذي تريد إرسال البيانات إليه. تحتاج إلى مقتطف واحد فقط لكل صفحة.
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_TRACKING_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){window.dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'GA_TRACKING_ID');
</script>
ويُحمِّل هذا المقتطف مكتبة gtag.js، وينشئ GA_TRACKING_ID باعتباره رقم تعريف الموقع التلقائي في "إحصاءات Google"، ويرسل نتيجة مشاهدة الصفحة على الويب إلى "إحصاءات Google".
إيقاف قياس مشاهدة الصفحة على الويب
السلوك التلقائي لهذا المقتطف هو إرسال نتيجة مشاهدة صفحة إلى "إحصاءات Google"
. هذا هو السلوك المطلوب في معظم الحالات، إذ يتم تسجيل مرات مشاهدة الصفحة تلقائيًا بعد إضافة المقتطف إلى كل صفحة في موقعك.
إذا كنت لا تريد أن يرسل المقتطف نتيجة مشاهدة صفحة إلى "إحصاءات Google"، اضبط المعلمة send_page_view على false:
gtag('config', 'GA_TRACKING_ID', { 'send_page_view': false });
ضبط مواقع "إحصاءات Google" الإضافية
يؤدي المقتطف تلقائيًا إلى ضبط موقع واحد على "إحصاءات Google". لضبط
موقع ثانٍ على "إحصاءات Google" باستخدام رقم تعريف التتبّع
GA_TRACKING_ID_2، أضِف أمر config إضافيًا:
gtag('config', 'GA_TRACKING_ID_2');