تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ملفات تعريف الارتباط وتعريف المستخدم باستخدام 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 بعدم قراءة ملفات تعريف الارتباط أو كتابتها إلى أن يتم تقديم موافقة من المستخدم. لمزيد من المعلومات، اطّلِع على ضبط سلوك العلامة استنادًا إلى الموافقة.