ملفات تعريف الارتباط وتعريف المستخدم باستخدام gtag.js

تستخدم علامة gtag.js ملفات تعريف الارتباط لتحديد المستخدمين الفريدين على مستوى جلسات التصفُّح. تشرح هذه الصفحة طريقة تخصيص إعدادات ملفات تعريف الارتباط.

يعرض الجدول التالي القيم التلقائية لحقل ملف تعريف الارتباط التي تستخدِمها مقتطف gtag.js:

اسم الحقل نوع القيمة القيمة التلقائية
cookie_domain string auto
cookie_expires integer 63072000 (عامان بالثواني)
cookie_prefix string _ga
cookie_update boolean true
cookie_flags string

لتغيير أي من هذه القيم، عدِّل config لموقعك لتحديدها في قائمة المعلَمات. مثال:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

بشكلٍ تلقائي، يتم تفعيل إعداد نطاق ملفات تعريف الارتباط تلقائيًا في gtag.js. وعند تفعيله، سيضبط gtag.js ملفات تعريف الارتباط على أعلى نطاق مستوى ممكن. على سبيل المثال، إذا كان عنوان موقعك الإلكتروني هو blog.example.com، ستضبط gtag.js ملفات تعريف الارتباط على النطاق example.com. إذا اكتشفت gtag.js أنك تشغِّل خادمًا محليًا (مثل localhost)، ستضبط cookie_domain تلقائيًا على 'none'، ما سيؤدي إلى إعداد gtag.js لملفات تعريف الارتباط باستخدام النطاق الكامل من موقع المستند.

لإيقاف الإعداد التلقائي لنطاق ملفات تعريف الارتباط، عدِّل config لموقعك لتحديد قيمة للمَعلمة cookie_domain:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_domain': 'blog.example.com'
});

ولتجنُّب التعارضات مع ملفات تعريف الارتباط الأخرى، قد تحتاج إلى تغيير بادئة ملف تعريف الارتباط التي ستتم إلحاقها سابقًا بملفات تعريف الارتباط التي تم ضبطها من خلال gtag.js. على سبيل المثال، الاسم التلقائي لملف تعريف الارتباط لرقم التعريف الذي تستخدمه "إحصاءات Google" هو _ga. سيؤدي هذا الرمز إلى تسمية ملف تعريف الارتباط example_ga بدلاً من ذلك:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

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

في حال ضبط القيمة cookie_expires على 0 (صفر) ثوانٍ، سيتحول ملف تعريف الارتباط إلى ملف تعريف ارتباط مستند إلى الجلسة وتنتهي صلاحيته بعد انتهاء جلسة المتصفِّح الحالية.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_expires': 0
});

عند ضبط cookie_update على true (القيمة التلقائية)، ستعدِّل مقتطف gtag.js ملفات تعريف الارتباط عند كل تحميل للصفحة. سيؤدّي هذا إلى تحديث تاريخ انتهاء صلاحية ملفّ تعريف الارتباط الذي سيتمّ إعداده مقارنةً بآخر زيارة إلى الموقع. على سبيل المثال، إذا تم ضبط تاريخ انتهاء صلاحية ملف تعريف الارتباط على أسبوع واحد، وكان أحد المستخدمين يزور الموقع نفسه كل خمسة أيام، فسيتم تحديث تاريخ انتهاء صلاحية ملف تعريف الارتباط في كل زيارة، وبالتالي لن تنتهي صلاحيته أبدًا.

وعند ضبط هذه السياسة على false، لا يتم تعديل ملفات تعريف الارتباط عند كل تحميل للصفحة. ويحدث هذا بسبب انتهاء صلاحية ملفّ تعريف الارتباط بالنسبة إلى أوّل مرّة زار فيها المستخدِم الموقع الإلكتروني.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

تُستخدَم لإلحاق علامات إضافية بملفّ تعريف الارتباط عند إعداده. يجب فصل الأعلام باستخدام أشكال متشابكة.

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

ضبط رقم تعريف المستخدم

رقم تعريف المستخدم هو سلسلة رقم تعريف فريدة وثابتة وغير محدِّدة للهوية الشخصية تمثل مستخدمًا. وتمكّن تحليل مجموعات من الجلسات عبر الأجهزة. لمعرفة السبب الذي يدفعك إلى تنفيذ User ID، اطّلع على مزايا استخدام ميزة User ID.

لتنفيذ رقم تعريف المستخدم باستخدام gtag.js، عدِّل config لموقعك لإعداد رقم تعريف المستخدم:

gtag('config', 'GA_MEASUREMENT_ID', {
  'user_id': 'USER_ID'
});

يمكنك ضبط gtag.js بحيث لا تقرأ ملفات تعريف الارتباط أو تكتبها إلى أن يتم منح المستخدم الموافقة. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل سلوك العلامة استنادًا إلى الموافقة.