إضافة 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');