التهيئة

يسرد هذا المستند جميع حقول الضبط في "إحصاءات Google".

ملاحظة: لا تستخدِم أيًّا من الحقول المدرَجة في هذه الصفحة كأسماء للمَعلمات المخصّصة.

allow_google_signals

لإيقاف الميزات الإعلانية استنادًا إلى معرّفات الإعلانات التابعة لجهات خارجية، اضبط allow_google_signals على false.

اسم الحقل	النوع	القيمة التلقائية
allow_google_signals	boolean	صحيح

مثال

الضبط على مستوى الحساب

gtag('set', 'allow_google_signals', true);

ضبطها لبثّ واحد

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

يمكنك ضبط هذه المَعلمة على false لإيقاف ميزات تخصيص الإعلانات.

اسم الحقل	النوع	القيمة التلقائية
allow_ad_personalization_signals	boolean	صحيح

مثال

الضبط على مستوى الحساب

gtag('set', 'allow_ad_personalization_signals', true);

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

campaign_content

يتمّ استخدامها لاختبارات A/B والإعلانات التي تستهدف المحتوى. استخدِم campaign_content لتمييز الإعلانات أو الروابط التي تشير إلى عنوان URL نفسه.

اسم الحقل	النوع	القيمة التلقائية
campaign_content	string	undefined

مثال

ملاحظة: سيؤدّي ضبط هذه القيمة إلى إلغاء مَعلمة طلب البحث utm_content.

ضبط الإعدادات على مستوى العالم

gtag('set', 'campaign_content', 'logolink');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

تُستخدَم لتحديد الحملة التي تشير إليها هذه الإحالة. استخدِم campaign_id لتحديد حملة معيّنة.

اسم الحقل	النوع	القيمة التلقائية
campaign_id	string	undefined

مثال

ملاحظة: سيؤدّي ضبط هذه القيمة إلى تجاهل مَعلمة طلب البحث utm_id.

ضبط الإعدادات على مستوى العالم

gtag('set', 'campaign_id', 'abc.123');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

استخدِم campaign_medium لتحديد وسيط مثل البريد الإلكتروني أو تكلفة النقرة.

اسم الحقل	النوع	القيمة التلقائية
campaign_medium	string	undefined

مثال

ملاحظة: سيؤدّي ضبط هذه القيمة إلى تجاهل مَعلمة طلب البحث utm_medium.

الضبط على مستوى الحساب

gtag('set', 'campaign_medium', 'cpc');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

تُستخدَم لتحليل الكلمات الرئيسية. استخدِم campaign_name لتحديد ترويج منتج معيّن أو حملة استراتيجية معيّنة.

اسم الحقل	النوع	القيمة التلقائية
campaign_name	string	undefined

مثال

ملاحظة: سيؤدّي ضبط هذه القيمة إلى تجاهل مَعلمة طلب البحث utm_name.

ضبط الإعدادات على مستوى العالم

gtag('set', 'campaign_name', 'spring_sale');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

استخدِم campaign_source لتحديد محرّك بحث أو اسم نشرة إخبارية أو مصدر آخر.

اسم الحقل	النوع	القيمة التلقائية
campaign_source	string	undefined

مثال

ملاحظة: سيؤدّي ضبط هذه القيمة إلى تجاهل مَعلمة طلب البحث utm_source.

الضبط على مستوى الحساب

gtag('set', 'campaign_source', 'google');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

تُستخدَم لنتائج البحث المدفوعة. استخدِم campaign_term لتمييز الكلمات الرئيسية لهذا الإعلان.

اسم الحقل	النوع	القيمة التلقائية
campaign_term	string	undefined

مثال

ملاحظة: سيؤدّي ضبط هذه القيمة إلى تجاهل مَعلمة طلب البحث utm_term.

الضبط على مستوى الحساب

gtag('set', 'campaign_term', 'running+shoes');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

حملة

عنصر يحتوي على جميع قيم الحملات التي يمكن ضبطها

يتم توفير عنصر campaign لدعم عمليات التنفيذ القديمة، ولا يُنصح باستخدامه في معظم الحالات. بدلاً من ذلك، يجب استخدام الإصدار الذي يتضمّن البادئة campaign لكل حقل:

• campaign_id
• campaign_source
• campaign_medium
• campaign_name
• campaign_term
• campaign_content

ملاحظة مهمة: استخدِم النسخة التي تحتوي على البادئة campaign_ لكل قيمة حملة بدلاً من هذا الحقل.

اسم الحقل	النوع	القيمة التلقائية
campaign	object	undefined

مثال

ملاحظة: ستلغي أي تفاصيل حملة تقدّمها أي معلمات utm_ لطلب البحث.

الضبط على مستوى الحساب

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

client_id

يتمّ تحديد نسخة المتصفّح بشكلٍ مجهول. يتمّ تخزين هذه القيمة تلقائيًا كجزء من ملفّ تعريف ارتباط "إحصاءات Google" التابع للطرف الأوّل والذي تنتهي صلاحيته بعد عامَين.

اسم الحقل	النوع	القيمة التلقائية
client_id	string	قيمة يتمّ إنشاؤها عشوائيًا لكلّ مستخدِم

مثال

الضبط على مستوى الحساب

gtag('set', 'client_id', 'aaa.bbb');

ضبطها لبثّ واحد

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

اسم الحقل	النوع	القيمة التلقائية
content_group	string

مثال

الضبط على مستوى الحساب

gtag('set', 'content_group', '/news/sports');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

cookie_domain

تُحدِّد النطاق المستخدَم لتخزين ملفّ تعريف ارتباط "إحصاءات Google".

اضبط القيمة على 'none' لضبط ملف تعريف الارتباط بدون تحديد نطاق.

اضبط القيمة على 'auto' (القيمة التلقائية) لضبط ملفّ تعريف الارتباط على نطاق المستوى الأعلى، بالإضافة إلى نطاق فرعي واحد (eTLD +1). على سبيل المثال، في حال ضبط cookie_domain على 'auto'، https://example.com سيستخدِم example.com للنطاق، و https://subdomain.example.com سيستخدِم أيضًا example.com للنطاق.

اسم الحقل	النوع	القيمة التلقائية
cookie_domain	string	'auto'

مثال

الضبط على مستوى الحساب

gtag('set', 'cookie_domain', 'example.com');

ضبط الإعدادات لبث واحد

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

cookie_expires

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

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

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

اسم الحقل	النوع	القيمة التلقائية
cookie_expires	number	63072000

مثال

الضبط على مستوى الحساب

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

ضبط الإعدادات لبث واحد

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

cookie_flags

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

اسم الحقل	النوع	القيمة التلقائية
cookie_flags	string

مثال

الضبط على مستوى الحساب

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

ضبط الإعدادات لبث واحد

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

cookie_path

تُحدِّد المسار الفرعي المستخدَم لتخزين ملفّ تعريف ارتباط "إحصاءات Google".

اسم الحقل	النوع	القيمة التلقائية
cookie_path	string	'/'

مثال

الضبط على مستوى الحساب

gtag('set', 'cookie_path', '/example_path');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

cookie_prefix

تُحدِّد بادئة قبل أسماء ملفّات تعريف الارتباط في "إحصاءات Google".

اسم الحقل	النوع	القيمة التلقائية
cookie_prefix	string

مثال

الضبط على مستوى الحساب

gtag('set', 'cookie_prefix', 'prefix');

ضبطها لبثّ واحد

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

cookie_update

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

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

اسم الحقل	النوع	القيمة التلقائية
cookie_update	boolean	true

مثال

الضبط على مستوى الحساب

gtag('set', 'cookie_update', true);

ضبطها لبثّ واحد

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

ignore_referrer

اضبط الإعدادات على true لتوضّح لخدمة "إحصاءات Google" ضرورة عدم عرض المُحيل كمصدر للزيارات. معرفة حالات استخدام هذا الحقل

اسم الحقل	النوع	القيمة التلقائية
ignore_referrer	boolean	خطأ

مثال

الضبط على مستوى الحساب

gtag('set', 'ignore_referrer', true);

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'ignore_referrer': true
});

language

تُحدِّد لغة المستخدِم المفضّلة. القيمة التلقائية هي قيمة navigator.language للمستخدِم.

اسم الحقل	النوع	القيمة التلقائية
language	string	ستكون القيمة التلقائية هي navigator.language.

مثال

الضبط على مستوى الحساب

gtag('set', 'language', 'en-us');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

تُحدِّد عنوان URL الكامل للصفحة. القيمة التلقائية هي قيمة document.location للمستخدِم.

اسم الحقل	النوع	القيمة التلقائية	Character Limit
page_location	string	القيمة التلقائية هي document.location	1000

مثال

الضبط على مستوى الحساب

gtag('set', 'page_location', 'https://example.com/page1');

ضبطها لبثّ واحد

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

تُستخدَم لتحديد مصدر الإحالة الذي جلب الزيارات إلى الصفحة. تُستخدَم هذه القيمة أيضًا لاحتساب مصدر الزيارات. تنسيق هذه القيمة هو عنوان URL. القيمة التلقائية هي قيمة document.referrer للمستخدِم.

اسم الحقل	النوع	القيمة التلقائية	Character Limit
page_referrer	string	ستكون القيمة التلقائية هي document.referrer.	420

مثال

الضبط على مستوى الحساب

gtag('set', 'page_referrer', 'https://example.com');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

عنوان الصفحة أو المستند. القيمة التلقائية هي قيمة document.title للمستخدم.

اسم الحقل	النوع	القيمة التلقائية	Character Limit
page_title	string	ستكون القيمة التلقائية هي document.title.	300

مثال

الضبط على مستوى الحساب

gtag('set', 'page_title', 'Settings');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

اضبط القيمة على false لمنع المقتطف التلقائي من إرسال page_view.

اسم الحقل	النوع	القيمة التلقائية
send_page_view	boolean	صحيح

مثال

الضبط على مستوى الحساب

gtag('set', 'send_page_view', false);

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

تُستخدَم لتحديد درجة دقّة الشاشة. يجب أن يكون هناك عددان صحيحان موجبان مفصولان بعلامة x. على سبيل المثال، إذا كانت الشاشة بحجم 800 x 600 بكسل، ستكون القيمة 800x600. ويتم احتسابها من قيمة window.screen للمستخدِم.

اسم الحقل	النوع	القيمة التلقائية
screen_resolution	string	سيتم احتساب القيمة التلقائية من window.screen.

مثال

الضبط على مستوى الحساب

gtag('set', 'screen_resolution', '800x600');

ضبطها لبثّ واحد

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

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

اسم الحقل	النوع	القيمة التلقائية	Character Limit
user_id	string		256

مثال

الضبط على مستوى الحساب

gtag('set', 'user_id', 'id');

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

خصائص المستخدِمين هي سمات يمكن استخدامها لوصف شرائح من قاعدة المستخدِمين لديك، مثل إعدادات اللغة المفضّلة أو الموقع الجغرافي. يمكن إعداد ما يصل إلى 25 خاصيّة مستخدِم إضافية لكلّ مشروع.

اسم الحقل	النوع	القيمة التلقائية	Character Limit
user_properties	object		الخاصية name=24 قيمة الخاصية=36

مثال

الضبط على مستوى الحساب

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

ضبط الإعدادات لبث واحد

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});