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

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

ضبط إعدادات حقل ملفات تعريف الارتباط

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

ولتغيير أي من هذه القيم، عليك تعديل سمة 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.

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

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

ضبط سلوك العلامة استنادًا إلى الموافقة

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