التهيئة

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

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

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. وهذا يعني أنّه في حال استخدام القيمة التلقائية لمدّة عامين (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

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

اسم الحقل	النوع	القيمة الافتراضية
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	خطأ

مثال

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

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.	1000

مثال

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

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" أو التخزين المتوفر.

اسم الحقل	النوع	القيمة الافتراضية	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'
  }
});