التهيئة

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

allow_google_signals

لإيقاف الميزات الإعلانية المستندة إلى المعرّفات الإعلانية التابعة لجهات خارجية، اضبط allow_google_signals على false.

مثال

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

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

ضبطها لبث واحد

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

allow_ad_personalization_signals

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

مثال

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

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

ضبطها لبث واحد

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

campaign_content

يتمّ استخدامها لاختبارات A/B والإعلانات التي تستهدف المحتوى. استخدِم campaign_content لتمييز الإعلانات أو الروابط التي تشير إلى عنوان URL نفسه.

مثال

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

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

ضبطها لبث واحد

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

campaign_id

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

مثال

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

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

ضبطها لبث واحد

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

campaign_medium

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

مثال

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

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

ضبطها لبث واحد

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

campaign_name

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

مثال

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

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

ضبطها لبث واحد

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

campaign_source

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

مثال

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

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

ضبطها لبث واحد

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

campaign_term

تُستخدَم لنتائج البحث المدفوعة. استخدِم campaign_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

مثال

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

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

مثال

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

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

ضبطها لبث واحد

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

content_group

مثال

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

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 أيضًا.

مثال

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

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

ضبطها لبث واحد

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

cookie_expires

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

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

مثال

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

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

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

مثال

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

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

ضبطها لبث واحد

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

cookie_path

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

مثال

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

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

ضبطها لبث واحد

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

cookie_prefix

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

مثال

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

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

ضبطها لبث واحد

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

cookie_update

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

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

مثال

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

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

ضبطها لبث واحد

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

ignore_referrer

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

مثال

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

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

ضبطها لبث واحد

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

language

تُحدِّد لغة المستخدِم المفضّلة. تكون القيمة التلقائية هي قيمة navigator.language الخاصة بالمستخدم.

مثال

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

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

ضبطها لبث واحد

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

page_location

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

مثال

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

gtag('set', 'page_location', 'https://example.com/page1');

ضبطها لبث واحد

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

تُستخدَم لتحديد مصدر الإحالة الذي جلب الزيارات إلى الصفحة. تُستخدم هذه القيمة أيضًا لاحتساب مصدر الزيارات. تكون قيمة هذه السمة عنوان URL. تكون القيمة التلقائية هي قيمة document.referrer للمستخدم.

مثال

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

gtag('set', 'page_referrer', 'https://example.com');

ضبطها لبث واحد

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

عنوان الصفحة أو المستند. تكون القيمة التلقائية هي قيمة document.title الخاصة بالمستخدم.

مثال

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

gtag('set', 'page_title', 'Settings');

ضبطها لبث واحد

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

اضبط القيمة على "خطأ" لمنع المقتطف التلقائي من إرسال page_view.

مثال

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

gtag('set', 'send_page_view', false);

ضبطها لبث واحد

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

تُستخدَم لتحديد درجة دقّة الشاشة. يجب أن يكون هناك عددان صحيحان موجبان مفصولان بعلامة x. على سبيل المثال، إذا كانت الشاشة بحجم 800 ‏x‏ 600 بكسل، ستكون القيمة 800x600. ويتمّ احتسابها من قيمة window.screen للمستخدِم.

مثال

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

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

ضبطها لبث واحد

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

user_id

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

مثال

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

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

ضبطها لبث واحد

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

user_properties

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

مثال

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

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

ضبطها لبث واحد

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