الإعدادات

يسرد هذا المستند جميع حقول الضبط لخدمة "إحصاءات 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_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. وهذا يعني أنّه إذا استخدمت القيمة التلقائية لمدّة عامين (63072,000 ثانية)، وكان أحد المستخدمين يزور موقعك كلّ شهر، لن تنتهي صلاحية ملفّ تعريف الارتباط لديه أبدًا.

إذا ضبطت الوقت 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	false

مثال

الإعداد العام

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.	1,000

مثال

الإعداد العام

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

يمكنك ضبط القيمة على "خطأ" لمنع المقتطف التلقائي من إرسال 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'
  }
});