الإعدادات

يسرد هذا المستند جميع حقول الإعدادات لخدمة "إحصاءات Google 4".

allow_google_signals

لإيقاف جميع الميزات الإعلانية، اضبط allow_google_signals على false.

اسم الحقل Type القيمة التلقائية
allow_google_signals boolean صحيح

مثال

الانتشار في جميع أنحاء العالم

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

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

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

allow_ad_personalization_signals

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

اسم الحقل Type القيمة التلقائية
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 نفسه

اسم الحقل Type القيمة التلقائية
campaign_content string undefined

مثال

الانتشار في جميع أنحاء العالم

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

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

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

campaign_id

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

اسم الحقل Type القيمة التلقائية
campaign_id string undefined

مثال

الانتشار في جميع أنحاء العالم

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

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

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

campaign_medium

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

اسم الحقل Type القيمة التلقائية
campaign_medium string undefined

مثال

الانتشار في جميع أنحاء العالم

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

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

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

campaign_name

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

اسم الحقل Type القيمة التلقائية
campaign_name string undefined

مثال

الانتشار في جميع أنحاء العالم

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

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

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

campaign_source

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

اسم الحقل Type القيمة التلقائية
campaign_source string undefined

مثال

الانتشار في جميع أنحاء العالم

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

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

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

campaign_term

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

اسم الحقل Type القيمة التلقائية
campaign_term string undefined

مثال

الانتشار في جميع أنحاء العالم

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

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

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

حملة

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

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

اسم الحقل Type القيمة التلقائية
campaign object undefined

مثال

الانتشار في جميع أنحاء العالم

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" للطرف الأول مع انتهاء صلاحية لمدة عامَين.

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

مثال

الانتشار في جميع أنحاء العالم

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

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

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

content_group

اسم الحقل Type القيمة التلقائية
content_group string

مثال

الانتشار في جميع أنحاء العالم

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

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

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

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

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

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

اسم الحقل Type القيمة التلقائية
cookie_domain string 'auto'

الانتشار في جميع أنحاء العالم

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

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

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

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

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

اسم الحقل Type القيمة التلقائية
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 */
});

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

اسم الحقل Type القيمة التلقائية
cookie_flags string

الانتشار في جميع أنحاء العالم

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

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

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

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

اسم الحقل Type القيمة التلقائية
cookie_path string '/'

الانتشار في جميع أنحاء العالم

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

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

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

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

اسم الحقل Type القيمة التلقائية
cookie_prefix string

الانتشار في جميع أنحاء العالم

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

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

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

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

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

اسم الحقل Type القيمة التلقائية
cookie_update boolean true

الانتشار في جميع أنحاء العالم

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

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

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

ignore_referrer

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

اسم الحقل Type القيمة التلقائية
ignore_referrer boolean false

مثال

الانتشار في جميع أنحاء العالم

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

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

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

language

تُحدِّد لغة المستخدِم المفضّلة. ويتم ضبطها تلقائيًا على قيمة navigator.language للمستخدم.

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

مثال

الانتشار في جميع أنحاء العالم

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

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

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

page_location

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

اسم الحقل Type القيمة التلقائية 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 لدى المستخدم.

اسم الحقل Type القيمة التلقائية 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 لدى المستخدم.

اسم الحقل Type القيمة التلقائية 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.

اسم الحقل Type القيمة التلقائية
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 للمستخدم.

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

مثال

الانتشار في جميع أنحاء العالم

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

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

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

user_id

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

اسم الحقل Type القيمة التلقائية Character Limit
user_id string 256

مثال

الانتشار في جميع أنحاء العالم

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

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

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

user_properties

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

اسم الحقل Type القيمة التلقائية Character Limit
user_properties object اسم السمة=24
قيمة السمة=36

مثال

الانتشار في جميع أنحاء العالم

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

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

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