يسرد هذا المستند جميع حقول الضبط لخدمة "إحصاءات 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 |
مثال
الإعداد العام
gtag('set', 'campaign_content', 'logolink');
ضبط إعدادات حدث بث واحد
gtag('config', 'STREAM_ID', {
'campaign_content': 'logolink'
});
campaign_id
تُستخدَم لتحديد الحملة التي تشير إليها هذه الإحالة. استخدِم campaign_id
لتحديد حملة معيّنة.
اسم الحقل | النوع | القيمة التلقائية |
---|---|---|
campaign_id |
string |
undefined |
مثال
الإعداد العام
gtag('set', 'campaign_id', 'abc.123');
ضبط إعدادات حدث بث واحد
gtag('config', 'STREAM_ID', {
'campaign_id': 'abc.123'
});
campaign_medium
استخدِم campaign_medium
لتحديد وسيط مثل البريد الإلكتروني أو تكلفة النقرة.
اسم الحقل | النوع | القيمة التلقائية |
---|---|---|
campaign_medium |
string |
undefined |
مثال
الإعداد العام
gtag('set', 'campaign_medium', 'cpc');
ضبط إعدادات حدث بث واحد
gtag('config', 'STREAM_ID', {
'campaign_medium': 'cpc'
});
campaign_name
تُستخدَم لتحليل الكلمات الرئيسية. استخدِم campaign_name
لتحديد ترويج
لمنتج معيّن أو حملة استراتيجية معيّنة.
اسم الحقل | النوع | القيمة التلقائية |
---|---|---|
campaign_name |
string |
undefined |
مثال
الإعداد العام
gtag('set', 'campaign_name', 'spring_sale');
ضبط إعدادات حدث بث واحد
gtag('config', 'STREAM_ID', {
'campaign_name': 'spring_sale'
});
campaign_source
استخدِم campaign_source
لتحديد محرك بحث أو اسم نشرة إخبارية أو مصدر
آخر.
اسم الحقل | النوع | القيمة التلقائية |
---|---|---|
campaign_source |
string |
undefined |
مثال
الإعداد العام
gtag('set', 'campaign_source', 'google');
ضبط إعدادات حدث بث واحد
gtag('config', 'STREAM_ID', {
'campaign_source': 'google'
});
campaign_term
تُستخدَم لنتائج البحث المدفوعة. يمكنك استخدام campaign_term
لتمييز الكلمات الرئيسية لهذا الإعلان.
اسم الحقل | النوع | القيمة التلقائية |
---|---|---|
campaign_term |
string |
undefined |
مثال
الإعداد العام
gtag('set', 'campaign_term', 'running+shoes');
ضبط إعدادات حدث بث واحد
gtag('config', 'STREAM_ID', {
'campaign_term': 'running+shoes'
});
حملة
عنصر يحتوي على جميع قيم الحملة التي يمكن ضبطها.
يتم توفير الكائن campaign
لإتاحة عمليات التنفيذ القديمة،
ولا يُنصَح به في معظم الحالات. بدلاً من ذلك، عليك استخدام
الإصدار السابق campaign
من كل حقل:
اسم الحقل | النوع | القيمة التلقائية |
---|---|---|
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" الخاص بالطرف الأول مع انتهاء صلاحية لمدة عامين.
اسم الحقل | النوع | القيمة التلقائية |
---|---|---|
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'
}
});