إضافة gtag.js إلى موقعك الإلكتروني

علامة 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');