الإعداد

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

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

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_source
• campaign_medium
• اسم_الحملة
• campaign_term
• حملة_المحتوى

نقطة رئيسية: استخدِم الإصدار الذي يسبق بادئة 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	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 Analytics، يتم تحديث وقت انتهاء صلاحية ملف تعريف الارتباط ليكون الوقت الحالي بالإضافة إلى قيمة الحقل 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	string

مثال

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

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

إعداد بث مباشر واحد

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

مسار_ملفات تعريف الارتباط

تحدّد المسار الفرعي المستخدَم لتخزين ملف تعريف ارتباط "إحصاءات 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 على true، ستحدِّث gtag.js ملفات تعريف الارتباط عند كل تحميل للصفحة. سيؤدي هذا إلى تحديث تاريخ انتهاء صلاحية ملف تعريف الارتباط الذي سيتم تعيينه مقارنةً بآخر زيارة إلى الموقع. على سبيل المثال، إذا تم تعيين انتهاء صلاحية ملف تعريف الارتباط على أسبوع واحد، وزار أحد المستخدمين باستخدام المتصفح نفسه كل خمسة أيام، فسيتم تحديث انتهاء صلاحية ملف تعريف الارتباط في كل زيارة ولن تنتهي صلاحيته أبدًا.

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

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

مثال

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

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

إعداد بث مباشر واحد

gtag('config', 'STREAM_ID', {
  'cookie_update': 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	420

مثال

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

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'
});

إرسال_مشاهدة_الصفحة

يمكنك تعيينه إلى 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		property name=24 قيمة الخاصية=36

مثال

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

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

إعداد بث مباشر واحد

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