ضبط ملفات تعريف الارتباط وتخصيصها

هذه الصفحة مخصّصة للمطوّرين الذين يريدون تخصيص إعدادات ملفات تعريف الارتباط باستخدام علامة Google أو أداة "إدارة العلامات من Google". إذا لم تكن متأكّدًا من أنّك بحاجة إلى ضبط ملفات تعريف الارتباط، اطّلِع على ملفات تعريف الارتباط وتعريف المستخدم.

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

إذا كنت تريد فقط تعديل إعدادات انتهاء صلاحية ملفات تعريف الارتباط أو تعديل ملفات تعريف الارتباط، يمكنك تغيير الإعدادات التلقائية لملفات تعريف الارتباط باستخدام واجهة "إحصاءات Google".

بالنسبة إلى معظم المواقع الإلكترونية والتطبيقات، يجب أيضًا أن يتم التحكّم في تخزين ملفات تعريف الارتباط بموجب موافقة المستخدم. تقدّم نظرة عامة على خصوصية المستخدِمين الخيارات المتاحة لإدارة موافقة المستخدِمين.

ملاحظة: إذا كنت تستخدِم علامة Google وكانت لديك منتجات متعدّدة في صفحة تشارك ملفات تعريف الارتباط، استخدِم أوامر gtag('set') بدلاً من gtag('config') لإعدادات ضبط ملفات تعريف الارتباط. يؤدي ذلك إلى تحقيق نتائج أكثر اتساقًا.

تغيير نطاق ملفات تعريف الارتباط

ملاحظة مهمة: يجب أن تكون القيمة cookie_domain أصلاً للنطاق الحالي، وإلا لن يتم ضبط ملف تعريف الارتباط. على سبيل المثال، إذا كان نطاقك هو one.two.three.root.com، يمكنك إعداد ملف تعريف الارتباط ليتم ضبطه على root.com، وليس على someotherdomain.com. قد يؤدي إعداد نطاق ملفات تعريف ارتباط غير صحيح إلى عدم إرسال أي بيانات.

عند استخدام الإعداد التلقائي لنطاق ملفات تعريف الارتباط، يتم قياس النشاط على مستوى النطاقات الفرعية بدون أي إعدادات إضافية.

لإجراء تغييرات على تهيئة نطاق ملفات تعريف الارتباط، اتبع الخطوات التالية:

gtag.js

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

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

إدارة العلامات

بالنسبة إلى علامة Google:

1. في مساحة العمل، افتح قائمة العلامات.
2. تعديل علامة Google حالية أو إنشاء علامة جديدة

3. في إعدادات الإعدادات، أضِف مَعلمة جديدة:

   • الاسم: cookie_domain
   • القيمة: my.example.com

4. احفظ العلامة وانشر الحاوية.

   بالنسبة إلى علامات إعلانات Google وFloodlight:

   يمكن تعديل إعدادات النطاق من علامة رابط الإحالة الناجحة:

   1. في أداة "إدارة العلامات من Google"، افتح علامة "رابط الإحالة الناجحة" الحالية أو أنشئ علامة إذا لم تكن العلامة متوفّرة في حاويتك.
   2. ضمن خيارات الربط، انقر على إلغاء إعدادات ملفات تعريف الارتباط (متقدمة).
   3. في حقل النطاق، أدخِل نطاق المستوى الأعلى الذي يجب السماح بتعيين ملف تعريف ارتباط له. يمكنك أيضًا تحديد مسار محدد في حقل المسار. ولا تستخدِم هذه الإعدادات إلا إذا كنت تريد تقييد ملفات تعريف الارتباط إلى نطاق فرعي أو دليل فرعي بمستوى أدنى.

بالنسبة إلى علامات Universal Analytics

1. في أداة "إدارة العلامات من Google"، افتح قائمة العلامات.
2. عدِّل علامة Universal Analytics الحالية أو أنشئ علامة جديدة.
3. أنشئ متغيّر إعدادات "إحصاءات Google" جديد. اختَر ضبط المتغيّر > المزيد من الإعدادات > الحقول المطلوب ضبطها.
4. عندما يتم توسيع قسم "الحقول المطلوب إعدادها"، انقر على إضافة صف.
5. في اسم الحقل، أدخِل cookieDomain.
6. بالنسبة إلى القيمة، أدخِل قيمة النطاق، مثل my.example.com.
7. احفظ العلامة وانشرها.

إعادة تسمية ملفات تعريف الارتباط

لتجنّب التعارضات مع ملفات تعريف الارتباط الأخرى، قد تحتاج إلى تغيير اسم ملف تعريف الارتباط.

ملاحظة مهمة: في حال تغيير إعدادات اسم ملفات تعريف الارتباط بعد زيارة المستخدمين لموقعك الإلكتروني لأول مرة، سيظهر هؤلاء الزوّار كزوّار جدد بسبب فقدان السياق المُخزَّن في ملفات تعريف الارتباط التي لم يتم تعديلها.

gtag.js

تضيف هذه الإعدادات example إلى بداية ملف تعريف الارتباط الذي يضبطه (على سبيل المثال، يصبح _ga example_ga أو _gcl_au يصبح example_gcl_au):

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

إدارة العلامات

بالنسبة إلى علامة Google:

1. في مساحة العمل، افتح قائمة العلامات.
2. تعديل علامة Google حالية أو إنشاء علامة جديدة

3. في إعدادات الإعدادات، أضِف مَعلمة جديدة:

   • الاسم: cookie_prefix
   • القيمة: example

4. احفظ العلامة وانشر الحاوية.

بالنسبة إلى علامات Universal Analytics:

يمكن لعلامات Universal Analytics في أداة "إدارة العلامات من Google" استبدال اسم ملف تعريف الارتباط بـ cookieName من خلال متغيّر إعدادات "إحصاءات Google".

1. في أداة "إدارة العلامات من Google"، افتح متغيّر إعدادات "إحصاءات Google" واختَر ضبط المتغيّر > المزيد من الإعدادات > الحقول المطلوب إعدادها.
2. عندما يتم توسيع قسم "الحقول المطلوب إعدادها"، انقر على إضافة صف.
3. بالنسبة إلى اسم الحقل، أدخِل cookieName.
4. بالنسبة إلى القيمة، أدخِل اسم ملف تعريف الارتباط، مثل myCookie.
5. احفظ العلامة وانشرها.

ملاحظة: يغيّر نموذج علامة Universal Analytics في أداة "إدارة العلامات من Google" الاسم الكامل لملف تعريف الارتباط. ويختلف هذا السلوك عن السمة cookie_prefix ضمن علامة Google، التي تضيف نصًا إلى بداية الاسم التلقائي لملف تعريف الارتباط.

بالنسبة إلى علامات إعلانات Google وFloodlight:

يمكن تعديل إعدادات بادئة الاسم من علامة رابط الإحالة الناجحة:

1.  In Tag Manager, open your existing Conversion Linker tag, or create
    one if the tag doesn't yet exist in your container.

1. ضمن خيارات الربط، انقر على إلغاء إعدادات ملفات تعريف الارتباط (متقدمة).
2. في الحقل بادئة الاسم، أدخِل بادئة الاسم المطلوبة. ويجب أيضًا ضبط أيّ علامات تستخدِم ملفات تعريف الارتباط هذه (مثل علامات الإحالات الناجحة في "إعلانات Google") لاستخدام البادئة نفسها.

انتهاء صلاحية ملفات تعريف الارتباط

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

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

gtag.js

gtag('config', 'TAG_ID', {
  cookie_expires: 28 * 24 * 60 * 60 // 28 days, in seconds
});

إدارة العلامات

بالنسبة إلى علامة Google:

1. في مساحة العمل، افتح قائمة العلامات.
2. تعديل علامة Google حالية أو إنشاء علامة جديدة

3. في إعدادات الإعدادات، أضِف مَعلمة جديدة:

   • الاسم: cookie_expires
   • القيمة: 2419200
   ملاحظة: تساوي القيمة 2419200 28 يومًا، ولكن يمكنك تحديد المدة التي تريدها.

4. احفظ العلامة وانشر الحاوية.

بالنسبة إلى علامات Universal Analytics:

1. في مساحة العمل، افتح قائمة العلامات.
2. عدِّل علامة Universal Analytics حالية.
3. أنشئ متغيّر إعدادات "إحصاءات Google" جديد. اختَر ضبط المتغيّر > المزيد من الإعدادات > الحقول المطلوب ضبطها.
4. عندما يتم توسيع قسم "الحقول المطلوب إعدادها"، انقر على إضافة صف.
5. في اسم الحقل، أدخِل cookieExpires.
6. بالنسبة إلى القيمة، أدخِل عدد الثواني قبل انتهاء صلاحية ملف تعريف الارتباط. على سبيل المثال، لمدة 28 يومًا، أدخِل 2419200.
7. احفظ العلامة وانشر الحاوية.

ملاحظة: لا تتوافق ملفات تعريف الارتباط في إعلانات Google وFloodlight، التي تم ضبطها من خلال العلامة رابط الإحالة الناجحة، مع cookie_expires في الوقت الحالي. إذا كان دعم علامة cookie_expires مطلوبًا، استخدِم gtag.js لإعداد هذه العلامة.

تعديل ملفات تعريف الارتباط

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

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

gtag.js

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

إدارة العلامات

بالنسبة إلى علامة Google:

1. في مساحة العمل، افتح قائمة العلامات.
2. تعديل علامة Google حالية أو إنشاء علامة جديدة

3. في إعدادات الإعدادات، أضِف مَعلمة جديدة:

   • الاسم: cookie_update
   • القيمة: false

4. احفظ العلامة وانشر الحاوية.

   ملاحظة: لا تتوافق ملفات تعريف الارتباط في إعلانات Google وFloodlight، التي تم ضبطها من خلال علامة رابط الإحالة الناجحة، مع cookie_update في الوقت الحالي. في حال كان دعم العلامة cookie_update مطلوبًا، استخدِم gtag.js لإعداد هذه العلامة.

بالنسبة إلى علامات Universal Analytics:

1. في مساحة العمل، افتح قائمة العلامات.
2. عدِّل علامة Universal Analytics حالية.
3. أنشئ متغيّر إعدادات "إحصاءات Google" جديد. اختَر ضبط المتغيّر > المزيد من الإعدادات > الحقول المطلوب ضبطها.
4. عندما يتم توسيع قسم "الحقول المطلوب إعدادها"، انقر على إضافة صف.
5. في اسم الحقل، أدخِل cookieUpdate.
6. بالنسبة إلى القيمة، أدخِل قيمة منطقية، مثل false.
7. احفظ العلامة وانشر الحاوية.