דף זה תורגם על ידי Cloud Translation API.

אירועים מומלצים

האירועים האלה מאפשרים לכם למדוד תכונות והתנהגויות נוספות וליצור בדוחות שימושיים ב-Google Analytics 4. כי לאירועים האלה נדרשים פרטים נוספים כדי שיהיו משמעותיים, הם לא נשלחים באופן אוטומטי. שימוש במסמך הזה לראות את הפרמטרים הנדרשים והאופציונליים של כל אירוע.

add_payment_info

האירוע הזה מציין שמשתמש שלח את פרטי התשלום שלו תהליך התשלום על החשבון במסחר אלקטרוני.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`payment_type`	`string`	לא	כרטיס אשראי	אמצעי התשלום הנבחר.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: add_payment_info
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
ערך מסחר אלקטרוני - ecommerce.value
מטבע מסחר אלקטרוני - ecommerce.currency
שובר מסחר אלקטרוני - ecommerce.coupon
סוג תשלום במסחר אלקטרוני - ecommerce.payment_type

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
value - {{ערך מסחר אלקטרוני}}
currency - {{מסחר אלקטרוני מטבע}}
coupon - {{מסחר אלקטרוני שובר}}
payment_type - {{סוג תשלום מסחר אלקטרוני}}

טריגר: האירוע שווה add_payment_info

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: add_payment_info
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_shipping_info

האירוע הזה מציין שמשתמש שלח את פרטי המשלוח שלו תהליך התשלום על החשבון במסחר אלקטרוני.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`shipping_tier`	`string`	לא	קרקע	דרגת המשלוח (למשל: `Ground`, `Air`, `Next-day`) שנבחרו למשלוח של הפריט שנרכש.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: add_shipping_info
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
ערך מסחר אלקטרוני - ecommerce.value
מטבע מסחר אלקטרוני - ecommerce.currency
שובר מסחר אלקטרוני - ecommerce.coupon
רמת משלוח של מסחר אלקטרוני – ecommerce.shipping_tier

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
value - {{ערך מסחר אלקטרוני}}
currency - {{מסחר אלקטרוני מטבע}}
coupon - {{מסחר אלקטרוני שובר}}
shipping_tier – {{מסחר אלקטרוני רמת משלוח}}

טריגר: האירוע שווה add_shipping_info

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: add_shipping_info
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_cart

האירוע הזה מציין שפריט נוסף לעגלת הקניות לצורך רכישה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: add_to_cart
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
ערך מסחר אלקטרוני - ecommerce.value
מטבע מסחר אלקטרוני - ecommerce.currency

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
value - {{ערך מסחר אלקטרוני}}
currency - {{מסחר אלקטרוני מטבע}}

טריגר: האירוע שווה add_to_cart

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: add_to_cart
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_wishlist

האירוע מציין שפריט נוסף לרשימת משאלות. שימוש באירוע הזה כדי לזהות פריטים פופולריים למתנות באפליקציה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: add_to_wishlist
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
ערך מסחר אלקטרוני - ecommerce.value
מטבע מסחר אלקטרוני - ecommerce.currency

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
value - {{ערך מסחר אלקטרוני}}
currency - {{מסחר אלקטרוני מטבע}}

טריגר: האירוע שווה add_to_wishlist

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: add_to_wishlist
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

begin_checkout

האירוע הזה מציין שמשתמש התחיל את תהליך התשלום.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: begin_checkout
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
ערך מסחר אלקטרוני - ecommerce.value
מטבע מסחר אלקטרוני - ecommerce.currency
שובר מסחר אלקטרוני - ecommerce.coupon

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
value - {{ערך מסחר אלקטרוני}}
currency - {{מסחר אלקטרוני מטבע}}
coupon - {{מסחר אלקטרוני שובר}}

טריגר: האירוע שווה start_checkout

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: begin_checkout
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

close_convert_lead

האירוע הזה מודד מתי ליד (lead) הומר או נסגר (לדוגמה, באמצעות רכישה).

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של `value` באירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: close_convert_lead
פרמטרים של אירועים (שם הפרמטר – ערך):

currency - דולר ארה"ב
value עד 30.03

הפעלת האירוע כשהמשתמש הפך לליד שהשלים המרה (לקוח)

close_unconvert_lead

האירוע הזה מודד אם משתמש מסומן כלא הופך לליד שהשלים המרה, ולציין את הסיבה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של `value` באירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`unconvert_lead_reason`	`string`	לא	לא התקבלה תשובה	הסיבה לכך שהליד לא השלים המרה.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: close_unconvert_lead
פרמטרים של אירועים (שם הפרמטר – ערך):

currency - דולר ארה"ב
value עד 30.03

הפעלת האירוע כשמשתמש מסומן כלא הופך לליד שהשלים המרה יכולה להיות אחת מכמה סיבות

disqualify_lead

האירוע הזה מודד אם משתמש מסומן כלא כשיר להיות ליד, וכן את הסיבה לפסילה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של `value` באירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`disqualified_lead_reason`	`string`	לא	לא רוצה לקנות	הסיבה לכך שליד סומן כ'נפסל'.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: disqualify_lead
פרמטרים של אירועים (שם הפרמטר – ערך):

currency - דולר ארה"ב
value עד 30.03
disqualified_lead_reason – לא רוצה לקנות

הפעלת האירוע כשמשתמש מסומן כלא כשיר להיות ליד יכולה להיות אחת מכמה סיבות

earn_virtual_currency

האירוע הזה מודד מתי משתמש מקבל מטבע וירטואלי במשחק. מומלץ לרשום את המידע הזה יחד עם spend_virtual_currency כדי להבין טוב יותר את כלכלה וירטואלית.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`virtual_currency_name`	`string`	לא	תצורות ה-Gem	שם המטבע הווירטואלי.
`value`	`number`	לא	5	הערך של המטבע הווירטואלי.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: earn_virtual_currency
פרמטרים של אירועים (שם הפרמטר – ערך):

virtual_currency_name – אבני חן
5-value

הפעלת האירוע כשמשתמש מקבל מטבע וירטואלי

generate_lead

האירוע הזה מודד מתי נוצר ליד (לדוגמה, דרך ). ציינו את הנתונים האלה כדי להבין את היעילות של הקמפיינים השיווקיים שלכם כמה לקוחות יוצרים אינטראקציה חוזרת עם העסק שלך אחרי רימרקטינג .

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של `value` באירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`lead_source`	`string`	לא	מופע מקצועי	מקור הליד.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: generate_lead
פרמטרים של אירועים (שם הפרמטר – ערך):

currency - דולר ארה"ב
value עד 30.03
lead_source – תערוכה מקצועית

הפעלת האירוע לאחר יצירת ליד

join_group

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`group_id`	`string`	לא	G_12345	המזהה של הקבוצה.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: join_group
פרמטרים של אירועים (שם הפרמטר – ערך):

group_id – G_12345

הפעלת האירוע כשמשתמש מצטרף לקבוצה

level_end

אירוע זה מציין שהשחקן הגיע לסוף שלב במשחק.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`level_name`	`string`	לא	המסע מתחיל...	שם הרמה.
`success`	`boolean`	לא	true	אם השלב הושלם בהצלחה, יש להגדיר את הערך כ-`true`.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: level_end
פרמטרים של אירועים (שם הפרמטר – ערך):

level_name – המסע מתחיל...
הצלחה – נכון

הפעלה כששחקן הגיע לסוף השלב (למשל, דף אישור השלב)

level_start

אירוע זה מציין ששחקן התחיל שלב במשחק.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`level_name`	`string`	לא	המסע מתחיל...	שם הרמה.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: level_start
פרמטרים של אירועים (שם הפרמטר – ערך):

level_name – המסע מתחיל...

הפעלה כשמשתמש מתחיל רמה חדשה (למשל, דף הפתיחה של הרמה)

level_up

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`level`	`number`	לא	5	הרמה של הדמות.
`character`	`string`	לא	שחקן 1	הדמות שהפכה לרמה הבאה.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: level_up
פרמטרים של אירועים (שם הפרמטר – ערך):

5-level
character – שחקן 1

הפעלה כששחקן עלה לרמה הבאה

שליחת האירוע הזה מציינת שמשתמש התחבר לאתר או לאפליקציה שלכם.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`method`	`string`	לא	Google	השיטה ששימשה להתחברות.

דוגמה

post_score

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`score`	`number`	כן	10000	התוצאה לפרסום.
`level`	`number`	לא	5	הרמה שבה נקבע המדד.
`character`	`string`	לא	שחקן 1	הדמות שהשיגה את הניקוד.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: post_score
פרמטרים של אירועים (שם הפרמטר – ערך):

score – 10,000
5-level
character – שחקן 1

הפעלה כשמשתמש מפרסם ניקוד

purchase

האירוע הזה מציין מתי משתמש רכש פריט אחד או יותר.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`transaction_id`	`string`	כן	T_12345	המזהה הייחודי של עסקה. הפרמטר `transaction_id` עוזר למנוע כפילות של אירועים ברכישה.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`shipping`	`number`	לא	3.33	עלות המשלוח המשויכת לעסקה.
`tax`	`number`	לא	1.11	עלות המס שמשויכת לעסקה.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: purchase

פריטים של מסחר אלקטרוני - ecommerce.items
מזהה עסקה של מסחר אלקטרוני – ecommerce.transaction_id
ערך מסחר אלקטרוני - ecommerce.value
מס מסחר אלקטרוני - ecommerce.tax
משלוח מסחר אלקטרוני - ecommerce.shipping
מטבע מסחר אלקטרוני - ecommerce.currency
שובר מסחר אלקטרוני - ecommerce.coupon

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
transaction_id - {{מזהה עסקה של מסחר אלקטרוני}}
value - {{ערך מסחר אלקטרוני}}
tax - {{מס מסחר אלקטרוני}}
shipping – {{מסחר אלקטרוני משלוח}}
currency - {{מסחר אלקטרוני מטבע}}
coupon - {{מסחר אלקטרוני שובר}}

טריגר: האירוע שווה לרכישה

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: purchase
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

qualify_lead

האירוע הזה מודד מתי משתמש מסומן כעומד בקריטריונים כדי להפוך ליד כשיר.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של `value` באירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: qualify_lead
פרמטרים של אירועים (שם הפרמטר – ערך):

currency - דולר ארה"ב
value עד 30.03

הפעלת האירוע כאשר משתמש מסומן כמתאים לקריטריונים להצטרפות לליד (lead) כשיר

refund

האירוע הזה מציין כשמשתמש מבצע החזר כספי על פריט אחד או יותר.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`transaction_id`	`string`	כן	T_12345	המזהה הייחודי של עסקה.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לאירוע. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`shipping`	`number`	לא	3.33	עלות המשלוח המשויכת לעסקה.
`tax`	`number`	לא	1.11	עלות המס שמשויכת לעסקה.
`items`	`Array<Item>`	לא*		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: refund
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
מזהה עסקה של מסחר אלקטרוני – ecommerce.transaction_id
ערך מסחר אלקטרוני - ecommerce.value
מס מסחר אלקטרוני - ecommerce.tax
משלוח מסחר אלקטרוני - ecommerce.shipping
מטבע מסחר אלקטרוני - ecommerce.currency
שובר מסחר אלקטרוני - ecommerce.coupon

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
transaction_id - {{מזהה עסקה של מסחר אלקטרוני}}
value - {{ערך מסחר אלקטרוני}}
tax - {{מס מסחר אלקטרוני}}
shipping – {{מסחר אלקטרוני משלוח}}
currency - {{מסחר אלקטרוני מטבע}}
coupon - {{מסחר אלקטרוני שובר}}

טריגר: האירוע שווה החזר כספי

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: refund
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

remove_from_cart

האירוע הזה מציין שפריט הוסר מעגלת קניות.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: remove_from_cart
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
ערך מסחר אלקטרוני - ecommerce.value
מטבע מסחר אלקטרוני - ecommerce.currency

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
value - {{ערך מסחר אלקטרוני}}
currency - {{מסחר אלקטרוני מטבע}}

טריגר: האירוע שווה remove_from_cart

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: remove_from_cart
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

חיפוש

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

פרמטרים

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

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: search
פרמטרים של אירועים (שם הפרמטר – ערך):

search_term – חולצות

הפעלה כשמשתמש מבצע חיפוש באתר שלך

select_content

האירוע הזה מציין שמשתמש בחר תוכן מסוג מסוים. האירוע הזה יכול לעזור לך לזהות תוכן פופולרי וקטגוריות של תוכן ב- באתר או באפליקציה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`content_type`	`string`	לא	product	סוג התוכן שנבחר.
`content_id`	`string`	לא	C_12345	מזהה של התוכן שנבחר.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: select_content
פרמטרים של אירועים (שם הפרמטר – ערך):

content_type – מוצר
content_id – C_12345

טריגר: האירוע שווה Select_content

select_item

האירוע הזה מציין שפריט נבחר מתוך רשימה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`items`	`Array<Item>`	כן*		הפריטים באירוע. * המערך `items` אמור להכיל רכיב אחד שמייצג את הפריט שנבחר. אם קיימים מספר רכיבים צוין, המערכת תשתמש רק ברכיב הראשון של `items`.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: select_item
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
מזהה רשימת פריטי מסחר אלקטרוני – ecommerce.item_list_id
שם רשימת פריטי מסחר אלקטרוני – ecommerce.item_list_name

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
item_list_id - {{מזהה רשימת פריטים של מסחר אלקטרוני}}
item_list_name - {{שם רשימת פריטים של מסחר אלקטרוני}}

טריגר: האירוע שווה Select_item

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: select_item
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

select_promotion

האירוע הזה מציין מבצע שנבחר מתוך רשימה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל אירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לאירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לאירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`items`	`Array<Item>`	לא		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

שם קריאייטיב של מסחר אלקטרוני - ecommerce.creative_name
מיקום לקריאייטיב של מסחר אלקטרוני - ecommerce.creative_slot
מזהה קידום מכירות במסחר אלקטרוני - ecommerce.promotion_id
שם קידום המכירות במסחר אלקטרוני - ecommerce.promotion_name
פריטים של מסחר אלקטרוני - ecommerce.items

פרמטרים של אירועים (שם הפרמטר – ערך):

creative_name - {{שם קריאייטיב של מסחר אלקטרוני}}
creative_slot - {{מיקום קריאייטיב של מסחר אלקטרוני}}
promotion_id - {{ מזהה קידום מסחר אלקטרוני}}
promotion_name - {{שם קידום מכירות אלקטרוני}}
items - {{מסחר אלקטרוני פריטים}}

סוג המשתנה: משתנה שכבת הנתונים 'ecommerce.items'
טריגר: האירוע שווה Select_promotion

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: select_promotion
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

השימוש באירוע הזה כשמשתמש משתף תוכן.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`method`	`string`	לא	Twitter	השיטה שבה התוכן משותף.
`content_type`	`string`	לא	תמונה	סוג התוכן המשותף.
`item_id`	`string`	לא	C_12345	המזהה של התוכן ששותף.

דוגמה

sign_up

האירוע הזה מציין שמשתמש נרשם לחשבון. שימוש באירוע הזה כדי להבין את ההתנהגויות השונות של משתמשים מחוברים ולא מחוברים.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`method`	`string`	לא	Google	השיטה ששימשה להרשמה.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: sign_up
פרמטרים של אירועים (שם הפרמטר – ערך):

method – Google

הפעלה כשמשתמש נרשם לחשבון

spend_virtual_currency

האירוע הזה מודד את המכירה של מוצרים וירטואליים באפליקציה שלך ועוזר לך לזהות אילו מוצרים וירטואליים הם הכי פופולריים.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`value`	`number`	כן	5	הערך של המטבע הווירטואלי.
`virtual_currency_name`	`string`	כן	תצורות ה-Gem	שם המטבע הווירטואלי.
`item_name`	`string`	לא	זריקת Starter Boost	שם הפריט שעבורו נעשה שימוש במטבע הווירטואלי.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: spend_virtual_currency
פרמטרים של אירועים (שם הפרמטר – ערך):

5-value
virtual_currency_name – אבני חן
item_name – זריקת אנרגיה למתחילים

הפעלה כשמשתמש קונה מוצר וירטואלי

tutorial_begin

האירוע הזה מציין את תחילת תהליך ההצטרפות. שימוש בפרמטר הזה במשפך עם tutorial_complete כדי להבין כמה משתמשים השלימו את המדריך.

פרמטרים

אין פרמטרים לאירוע הזה.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: tutorial_begin
הפעלה כשמשתמש מתחיל את תהליך ההצטרפות

tutorial_complete

אירוע זה מציין שהמשתמש השלים את תהליך ההצטרפות שלכם. שימוש בטיוטה הזו במשפך עם tutorial_begin כדי להבין כמה משתמשים משלימים את של המדריך.

פרמטרים

לא מוצעים פרמטרים לאירוע הזה.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: tutorial_complete
הפעלה כשמשתמש משלים את תהליך ההצטרפות

unlock_achievement

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

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`achievement_id`	`string`	כן	A_12345	המזהה של ההישג שהנעילה שלו בוטלה.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: unlock_achievement
פרמטרים של אירועים (שם הפרמטר – ערך):

achievement_id – A_12345

הפעלה כשמשתמש מבטל את הנעילה של הישג

view_cart

האירוע הזה מציין שמשתמש צפה בעגלת הקניות שלו.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: view_cart
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
ערך מסחר אלקטרוני - ecommerce.value
מטבע מסחר אלקטרוני - ecommerce.currency

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
value - {{ערך מסחר אלקטרוני}}
currency - {{מסחר אלקטרוני מטבע}}

טריגר: האירוע שווה ל-view_cart

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: view_cart
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item

האירוע הזה מציין שחלק מהתוכן הוצג למשתמש. שימוש באירוע הזה כדי למצוא את הפריטים הפופולריים ביותר שנצפו.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	מטבע הפריטים שמשויכים לאירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * מגדירים את `value` לסכום של `(price * quantity)` לכל הפריטים ב `items` אין לכלול `shipping` או `tax`. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: view_item
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
ערך מסחר אלקטרוני - ecommerce.value
מטבע מסחר אלקטרוני - ecommerce.currency

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
value - {{ערך מסחר אלקטרוני}}
currency - {{מסחר אלקטרוני מטבע}}

טריגר: האירוע שווה ל-view_item

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: view_item
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item_list

רישום אירוע זה כשמוצגת למשתמש רשימה של פריטים קטגוריה מסוימת.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`items`	`Array<Item>`	כן		הפריטים באירוע.

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: view_item_list
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

פריטים של מסחר אלקטרוני - ecommerce.items
מזהה רשימת פריטי מסחר אלקטרוני – ecommerce.item_list_id
שם רשימת פריטי מסחר אלקטרוני – ecommerce.item_list_name

פרמטרים של אירועים (שם הפרמטר – ערך):

items - {{מסחר אלקטרוני פריטים}}
item_list_id - {{מזהה רשימת פריטים של מסחר אלקטרוני}}
item_list_name - {{שם רשימת פריטים של מסחר אלקטרוני}}

טריגר: האירוע שווה view_item_list

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: view_item_list
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

view_promotion

האירוע הזה מציין שמישהו צפה במבצע מתוך רשימה.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל אירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לאירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לאירוע. המערכת מתעלמת ממנו אם היא הוגדרה ברמת הפריט.
`items`	`Array<Item>`	כן*		הפריטים באירוע. * המערך `items` אמור להכיל רכיב אחד שמייצג את הפריט שמשויך למבצע. אם מספר הרכיבים סופקו, רק הרכיב הראשון ב-`items` .

פרמטרים של פריטים

שם	סוג	חובה	ערך לדוגמה	תיאור
`item_id`	`string`	כן*	SKU_12345	המזהה של הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`item_name`	`string`	כן*	חולצת Stan and Friends	שם הפריט. *צריך להזין את אחד מהערכים `item_id` או `item_name`.
`affiliation`	`string`	לא	Google Store	הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או לבנה, המיקום הפיזי של החנות. הערה: 'שיוך' זמין רק ברמת הפריט.
`coupon`	`string`	לא	SUMMER_FUN	השם/הקוד של השובר שמשויך לפריט. פרמטרים `coupon` ברמת האירוע וברמת הפריט הם בלתי תלויית.
`creative_name`	`string`	לא	summer_banner2	שם הקריאייטיב לקידום המכירות. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_name` ברמת האירוע, אם כיום.
`creative_slot`	`string`	לא	featured_app_1	השם של מיקום הקריאייטיב לקידום מכירות המשויך אל שימושי. אם המדיניות מוגדרת, המערכת תתעלם מ-`creative_slot` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `creative_slot` ברמת האירוע, אם כיום.
`discount`	`number`	לא	2.22	הערך הכספי של ההנחה ליחידה שמשויכת לפריט.
`index`	`number`	לא	5	האינדקס/המיקום של הפריט ברשימה.
`item_brand`	`string`	לא	Google	המותג של הפריט.
`item_category`	`string`	לא	ביגוד	הקטגוריה של הפריט. אם נעשה בהן שימוש כחלק מהיררכיית קטגוריות או זוהי הקטגוריה הראשונה.
`item_category2`	`string`	לא	אדם מבוגר	ההיררכיה של הקטגוריה השנייה או טקסונומיה נוספת של הפריט.
`item_category3`	`string`	לא	חולצות	ההיררכיה של הקטגוריה השלישית או טקסונומיה נוספת של הפריט.
`item_category4`	`string`	לא	צוות ההפקה	ההיררכיה של הקטגוריה הרביעית או טקסונומיה נוספת של הפריט.
`item_category5`	`string`	לא	שרוולים קצרים	ההיררכיה של הקטגוריה החמישית או טקסונומיה נוספת של הפריט.
`item_list_id`	`string`	לא	related_products	המזהה של הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_id` ברמת האירוע, אם כיום.
`item_list_name`	`string`	לא	מוצרים קשורים	שם הרשימה שבה הפריט הוצג למשתמש. אם המדיניות מוגדרת, המערכת תתעלם מ-`item_list_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `item_list_name` ברמת האירוע, אם כיום.
`item_variant`	`string`	לא	green	הווריאנט של הפריט, קוד ייחודי או תיאור ייחודי של הפריט הנוסף פרטים/אפשרויות.
`location_id`	`string`	לא	ChIJIQBpAG2ahYAR_6128GcTUEo (מזהה Google Place בסן פרנסיסקו)	המיקום הפיזי שמשויך לפריט (למשל, המיקום הפיזי) המיקום של החנות). מומלץ להשתמש Google מזהה מקום שתואם לפריט המשויך. מיקום מותאם אישית ניתן להשתמש גם בתעודה מזהה. הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
`price`	`number`	לא	10.01	המחיר ליחידה הכספית של הפריט, ביחידות של המטבע שצוין הפרמטר. אם חלה הנחה על הפריט, צריך להגדיר את `price` כמחיר ליחידה המוזלת מציינים את הנחת המחיר ליחידה בפרמטר `discount`.
`promotion_id`	`string`	לא	P_12345	מזהה המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_id` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_id` ברמת האירוע, אם כיום.
`promotion_name`	`string`	לא	מבצע קיץ	שם המבצע שמשויך לפריט. אם המדיניות מוגדרת, המערכת תתעלם מ-`promotion_name` ברמת האירוע. אם המדיניות לא מוגדרת, ייעשה שימוש במדד `promotion_name` ברמת האירוע, אם כיום.
`quantity`	`number`	לא	3	כמות הפריטים. אם הערך לא מוגדר, `quantity` מוגדר כ-1.

בנוסף לפרמטרים הקיימים, ניתן לכלול עד 27 פרמטרים מותאמים אישית במערך items.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: view_promotion
משתני שכבת נתונים (שם - שם משתנה של שכבת נתונים):

שם קריאייטיב של מסחר אלקטרוני - ecommerce.creative_name
מיקום לקריאייטיב של מסחר אלקטרוני - ecommerce.creative_slot
מזהה קידום מכירות במסחר אלקטרוני - ecommerce.promotion_id
שם קידום המכירות במסחר אלקטרוני - ecommerce.promotion_name
פריטים של מסחר אלקטרוני - ecommerce.items

פרמטרים של אירועים (שם הפרמטר – ערך):

creative_name - {{שם קריאייטיב של מסחר אלקטרוני}}
creative_slot - {{מיקום קריאייטיב של מסחר אלקטרוני}}
promotion_id - {{ מזהה קידום מסחר אלקטרוני}}
promotion_name - {{שם קידום מכירות אלקטרוני}}
items - {{מסחר אלקטרוני פריטים}}

טריגר: האירוע שווה view_promotion

הגדרת הטריגר:

סוג הטריגר: אירוע מותאם אישית
שם האירוע: view_promotion
הטריגר הזה מופעל בתאריך: כל האירועים בהתאמה אישית

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

working_lead

האירוע הזה מודד מתי משתמש יוצר קשר או יוצר קשר עם נציג.

פרמטרים

שם	סוג	חובה	ערך לדוגמה	תיאור
`currency`	`string`	כן*	USD	המטבע של `value` באירוע, ב- 3 אותיות פורמט ISO 4217. * אם מגדירים את `value`, חובה לציין `currency` כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
`value`	`number`	כן*	30.03	הערך הכספי של האירוע. * `value` בדרך כלל נדרש כדי לקבל דיווח משמעותי. אם תסמן האירוע כאירוע מרכזי. לאחר מכן מומלץ להגדיר `value`. חובה להזין * `currency` אם מגדירים את הערך `value`.
`lead_status`	`string`	לא	שיחות שהתחילו	הסטטוס של הליד.

דוגמה

הדוגמה הבאה מתייחסת להטמעות של Tag Manager:

אני רוצה לראות את הגדרת התג

הגדרת התגים:

סוג התג: אירוע GA4
שם האירוע: working_lead
פרמטרים של אירועים (שם הפרמטר – ערך):

currency - דולר ארה"ב
value עד 30.03
lead_status – שיחות שהתחילו

להפעיל את האירוע כשמשתמש יוצר קשר עם משתמש או כשיצר קשר עם נציג

אירועים מומלצים

add_payment_info

פרמטרים

פרמטרים של פריטים

דוגמה

אני רוצה לראות את הגדרת התג

add_shipping_info

פרמטרים

פרמטרים של פריטים

דוגמה

אני רוצה לראות את הגדרת התג

add_to_cart

פרמטרים

פרמטרים של פריטים

דוגמה

אני רוצה לראות את הגדרת התג

add_to_wishlist

פרמטרים

פרמטרים של פריטים

דוגמה

אני רוצה לראות את הגדרת התג

begin_checkout

פרמטרים

פרמטרים של פריטים

דוגמה

אני רוצה לראות את הגדרת התג

close_convert_lead

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

close_unconvert_lead

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

disqualify_lead

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

earn_virtual_currency

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

generate_lead

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

join_group

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

level_end

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

level_start

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

level_up

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

התחברות

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

post_score

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

purchase

פרמטרים

פרמטרים של פריטים

דוגמה

אני רוצה לראות את הגדרת התג

qualify_lead

פרמטרים

דוגמה

אני רוצה לראות את הגדרת התג

refund