תצורה

במסמך הזה מפורטים כל שדות ההגדרה של GA4.

הערה: אין להשתמש בשדות שמפורטים בדף הזה בתור שמות של פרמטרים מותאמים אישית.

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_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

מזהה באופן אנונימי את המופע של הדפדפן. כברירת מחדל, הערך הזה שמור כחלק מקובץ ה-cookie של צד ראשון ב-Analytics עם תאריך תפוגה של שנתיים.

שם השדה	סוג	ערך ברירת מחדל
client_id	string	ערך שנוצר באופן אקראי לכל משתמש.

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

group_group

שם השדה	סוג	ערך ברירת מחדל
content_group	string

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

cookie_domain

השדה הזה מציין את הדומיין לאחסון קובץ ה-cookie של Analytics.

כדי להגדיר את קובץ ה-cookie בלי לציין דומיין, מגדירים ל-'none'.

מגדירים את הערך 'auto' (ערך ברירת המחדל) כדי להגדיר את קובץ ה-cookie לדומיין ברמה העליונה, בתוספת תת-דומיין אחד (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 Analytics, זמן התפוגה של קובץ ה-cookie מעודכן לפי הזמן הנוכחי, בתוספת הערך של השדה cookie_expires. המשמעות היא שאם אתם משתמשים בערך ברירת המחדל של שנתיים (63072000 שניות), ומשתמש מבקר באתר שלכם בכל חודש, התוקף של קובץ ה-cookie שלו לעולם לא יפוג.

אם מגדירים את משך הזמן של cookie_expires ל-0 (אפס), קובץ ה-cookie הופך לקובץ cookie שמבוסס על ביקורים, ותוקפו פג בסיום הסשן הנוכחי בדפדפן.

זהירות: אם התוקף של קובץ ה-cookie יפוג מהר מדי, מספר המשתמשים יתפח והאיכות של המדידה תרד.

שם השדה	סוג	ערך ברירת מחדל
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

הוספת סימונים נוספים לקובץ ה-cookie לאחר הגדרתו. יש להפריד בין הסימונים באמצעות נקודה ופסיק (;). לקבלת דוגמאות של סימונים להגדרה, מומלץ לעיין במאמר כתיבת קובץ cookie חדש.

שם השדה	סוג	ערך ברירת מחדל
cookie_flags	string

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

נתיב_קובץ cookie

מציין את נתיב המשנה המשמש לאחסון קובץ ה-cookie של Analytics.

שם השדה	סוג	ערך ברירת מחדל
cookie_path	string	'/'

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

cookie_prefix

מציין תחילית לצירוף שמות של קובצי cookie לניתוח נתונים.

שם השדה	סוג	ערך ברירת מחדל
cookie_prefix	string

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

קובץ cookie_update

כאשר המדיניות cookie_update מוגדרת לערך true, קובצי gtag.js יעדכנו קובצי cookie בכל טעינת דף. הפעולה הזו תעדכן את תפוגת קובץ ה-cookie כך שתיקבע ביחס לביקור האחרון באתר. לדוגמה, אם התוקף של קובץ ה-cookie מוגדר לשבוע, ומשתמש מבקר באותו דפדפן כל חמישה ימים, התפוגה של קובץ ה-cookie תתעדכן בכל ביקור ולא תפוג בפועל.

אם המדיניות מקבלת את הערך false, קובצי cookie לא מתעדכנים בכל טעינת דף. ההשפעה של תפוגת קובץ ה-cookie על כך קשורה לפעם הראשונה שבה משתמש נכנס לאתר.

שם השדה	סוג	ערך ברירת מחדל
cookie_update	boolean	true

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

gtag('config', 'STREAM_ID', {
  'cookie_update': 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.

שם השדה	סוג	ערך ברירת מחדל	מגבלת תווים
page_location	string	ערך ברירת המחדל הוא document.location	420

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

page_referrer

מציינת איזה מקור הפניה הניב תנועה לדף. הערך הזה משמש גם לחישוב מקור התנועה. הפורמט של הערך הזה הוא כתובת URL. ערך ברירת המחדל של המשתמש הוא document.referrer.

שם השדה	סוג	ערך ברירת מחדל	מגבלת תווים
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.

שם השדה	סוג	ערך ברירת מחדל	מגבלת תווים
page_title	string	ערך ברירת המחדל הוא document.title	300

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

send_page_view

יש להגדיר את הערך False כדי למנוע מקטע הקוד המשמש כברירת מחדל לשלוח page_view.

שם השדה	סוג	ערך ברירת מחדל
send_page_view	boolean	נכון

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

screen_resolution

מציינת את רזולוציית המסך. צריך להיות שני מספרים שלמים חיוביים המופרדים באמצעות x. לדוגמה, אם מדובר במסך בגודל 800x600 פיקסלים, הערך יהיה 800x600. מחושב על סמך ערך המשתמש של window.screen.

שם השדה	סוג	ערך ברירת מחדל
screen_resolution	string	ערך ברירת המחדל יחושב מ-window.screen.

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

user_id

מציין מזהה ידוע למשתמש שסופק על ידי בעל האתר/הספרייה. הוא לא יכול להכיל פרטים אישיים מזהים (PII). אין לשמור על הערך בעקביות בקובצי cookie של Google Analytics או באחסון אחר שסופק ב-Analytics.

שם השדה	סוג	ערך ברירת מחדל	מגבלת תווים
user_id	string		256

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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

user_properties

מאפייני משתמש הם מאפיינים שבהם אפשר להשתמש כדי לתאר פלחים של בסיס המשתמשים, כמו העדפת שפה או מיקום גיאוגרפי. אפשר להגדיר עד 25 מאפייני משתמשים נוספים לכל פרויקט.

שם השדה	סוג	ערך ברירת מחדל	מגבלת תווים
user_properties	object		שם המאפיין=24 ערך הנכס=36

דוגמה

הגדרה גלובלית

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

הגדרה של שידור יחיד

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