يسرد هذا المستند جميع حقول الإعدادات لخدمة "إحصاءات 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'
});
cookie_domain
تُحدِّد النطاق المستخدَم لتخزين ملفّ تعريف ارتباط "إحصاءات 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'
});
cookie_expires
في كلّ مرّة يتمّ فيها إرسال نتيجة إلى "إحصاءات 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 */
});
cookie_flags
تُستخدَم لإلحاق علامات إضافية بملفّ تعريف الارتباط عند إعداده. يجب فصل الأعلام باستخدام أشكال متشابكة. راجِع كتابة ملفّ تعريف ارتباط جديد للاطّلاع على بعض أمثلة العلامات التي سيتمّ إعدادها.
اسم الحقل | Type | القيمة التلقائية |
---|---|---|
cookie_flags |
string |
مثال
الانتشار في جميع أنحاء العالم
gtag('set', 'cookie_flags', 'SameSite=None;Secure');
ضبط الإعدادات لبث واحد
gtag('config', 'STREAM_ID', {
'cookie_flags': 'SameSite=None;Secure'
});
cookie_path
تُحدِّد المسار الفرعي المستخدَم لتخزين ملفّ تعريف ارتباط "إحصاءات Google".
اسم الحقل | Type | القيمة التلقائية |
---|---|---|
cookie_path |
string |
'/' |
مثال
الانتشار في جميع أنحاء العالم
gtag('set', 'cookie_path', '/example_path');
ضبط الإعدادات لبث واحد
gtag('config', 'STREAM_ID', {
'cookie_path': '/example_path'
});
cookie_prefix
تُحدِّد بادئة قبل أسماء ملفّات تعريف الارتباط في "إحصاءات Google".
اسم الحقل | Type | القيمة التلقائية |
---|---|---|
cookie_prefix |
string |
مثال
الانتشار في جميع أنحاء العالم
gtag('set', 'cookie_prefix', 'prefix');
ضبط الإعدادات لبث واحد
gtag('config', 'STREAM_ID', {
'cookie_prefix': 'prefix'
});
cookie_update
عند ضبط 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'
}
});