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

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

add_payment_info

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;שובר מסחר אלקטרוני&rbrace;&rbrace;
    • payment_type - &lbrace;&lbrace;סוג תשלום במסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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 מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;שובר מסחר אלקטרוני&rbrace;&rbrace;
    • shipping_tier - &lbrace;&lbrace;רמת משלוח מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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 מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_name ברמת האירוע, אם הוא קיים.
quantity number לא 3

כמות הפריטים.

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

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: add_to_cart
  • משתני שכבת נתונים (שם - שם של משתנה שכבת נתונים):
    • פריטי מסחר אלקטרוני – ecommerce.items
    • ערך מסחר אלקטרוני – ecommerce.value
    • מטבע של מסחר אלקטרוני - ecommerce.currency
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • items - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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 מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_name ברמת האירוע, אם הוא קיים.
quantity number לא 3

כמות הפריטים.

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

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: add_to_wishlist
  • משתני שכבת נתונים (שם - שם של משתנה שכבת נתונים):
    • פריטי מסחר אלקטרוני – ecommerce.items
    • ערך מסחר אלקטרוני – ecommerce.value
    • מטבע של מסחר אלקטרוני - ecommerce.currency
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • items - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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 מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;שובר מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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
    }
    ]
  }
});

earn_virtual_currency

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

פרמטרים

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

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: earn_virtual_currency
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • virtual_currency_name – אבני חן
    • value - 5
  • הפעלת האירוע כאשר מישהו מקבל מטבע וירטואלי

generate_lead

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך value, חובה לציין את הערך currency כדי שמדדי ההכנסה יחושבו בצורה מדויקת.
value number כן* 30.03 הערך הכספי של האירוע.

* מגדירים את הערך value כסכום של (price * quantity) לכל הפריטים ב-items. אין לכלול shipping או tax.
* value נדרש בדרך כלל לדיווח משמעותי. אם מסמנים את האירוע כהמרה, מומלץ להגדיר את האירוע value.
* currency הוא שדה חובה אם מגדירים את value.

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: generate_lead
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • currency - דולר ארה"ב
    • value – 99.99
  • להפעיל את האירוע כאשר נוצר ליד.

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
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • level - 5
    • character – שחקן 1
  • הפעלה כששחקן מתקדם לשלב הבא

התחברות

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

פרמטרים

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

דוגמה

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: login
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • method – Google
  • מופעל כשמשתמש מתחבר

post_score

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

פרמטרים

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

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: post_score
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • score עד 10,000
    • level - 5
    • character – שחקן 1
  • מופעל כשהמשתמש מפרסם ניקוד

purchase

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;מזהה עסקה במסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;מס מסחר אלקטרוני&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;משלוח מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;שובר מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: אירוע שווה לרכישה

הגדרת טריגר:

  • סוג הטריגר: אירוע מותאם אישית
  • שם האירוע: 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
    }]
  }
});

refund

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

פרמטרים

שם סוג חובה ערך לדוגמה תיאור
currency string כן* USD מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;מזהה עסקה במסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;מס מסחר אלקטרוני&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;משלוח מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;שובר מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה החזר כספי

הגדרת טריגר:

  • סוג הטריגר: אירוע מותאם אישית
  • שם האירוע: 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 מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_name ברמת האירוע, אם הוא קיים.
quantity number לא 3

כמות הפריטים.

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

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: remove_from_cart
  • משתני שכבת נתונים (שם - שם של משתנה שכבת נתונים):
    • פריטי מסחר אלקטרוני – ecommerce.items
    • ערך מסחר אלקטרוני – ecommerce.value
    • מטבע של מסחר אלקטרוני - ecommerce.currency
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • items - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל- 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • item_list_id - &lbrace;&lbrace;מזהה רשימת פריט במסחר אלקטרוני&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;שם רשימת פריטי מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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 לא Summer Sale שם המבצע שמשויך לאירוע.

המערכת מתעלמת מהמדיניות אם היא מוגדרת ברמת הפריט.
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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;שם קריאייטיב במסחר אלקטרוני&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;מיקום קריאייטיב של מסחר אלקטרוני&rbrace;&rbrace;
    • promotion_id – &lbrace;&lbrace;מזהה קידום מכירות מסחר אלקטרוני&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;שם קידום מכירות של מסחר אלקטרוני&rbrace;&rbrace;
    • items - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
  • סוג משתנה: datalayer Variable - '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 המזהה של התוכן ששותף.

דוגמה

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: share
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • method – Twitter
    • content_type - תמונה
    • item_id – 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 לא הגברה בהתחלה שם הפריט שעבורו נעשה שימוש במטבע הווירטואלי.

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: spend_virtual_currency
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • value - 5
    • 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 מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_name ברמת האירוע, אם הוא קיים.
quantity number לא 3

כמות הפריטים.

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

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: view_cart
  • משתני שכבת נתונים (שם - שם של משתנה שכבת נתונים):
    • פריטי מסחר אלקטרוני – ecommerce.items
    • ערך מסחר אלקטרוני – ecommerce.value
    • מטבע של מסחר אלקטרוני - ecommerce.currency
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • items - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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 מטבע הפריטים שמשויכים לאירוע, בפורמט ISO 4217 שמורכב מ-3 אותיות.

* אם מגדירים את הערך 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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_name ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_name ברמת האירוע, אם הוא קיים.
quantity number לא 3

כמות הפריטים.

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

דוגמה

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

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

הגדרת התג:

  • סוג התג: אירוע GA4
  • שם האירוע: view_item
  • משתני שכבת נתונים (שם - שם של משתנה שכבת נתונים):
    • פריטי מסחר אלקטרוני – ecommerce.items
    • ערך מסחר אלקטרוני – ecommerce.value
    • מטבע של מסחר אלקטרוני - ecommerce.currency
  • פרמטרים של אירועים (שם הפרמטר – ערך):
    • items - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • value - &lbrace;&lbrace;ערך מסחר אלקטרוני&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;מטבע מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
    • item_list_id - &lbrace;&lbrace;מזהה רשימת פריט במסחר אלקטרוני&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;שם רשימת פריטי מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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 לא Summer Sale שם המבצע שמשויך לאירוע.

המערכת מתעלמת מהמדיניות אם היא מוגדרת ברמת הפריט.
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 הנתונים שמשויכים למוצר כדי לציין את החברה שמספקת אותו או את המיקום הפיזי של החנות.
הערה: הפרמטר 'affiliation' זמין רק ברמת הפריט.
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 של סן פרנסיסקו) המיקום הפיזי המשויך לפריט (למשל, המיקום של החנות הפיזית). מומלץ להשתמש במזהה מקום Google שתואם לפריט המשויך. אפשר גם להשתמש במזהה מיקום מותאם אישית.
הערה: המאפיין 'מזהה מיקום' זמין רק ברמת הפריט.
price number לא 10.01 המחיר ליחידה הכספית של הפריט, ביחידות של פרמטר המטבע שצוין.
אם יש הנחה על הפריט, צריך להגדיר את price כמחיר ליחידה המוזל, ולציין את ההנחה במחיר ליחידה בפרמטר discount.
promotion_id string לא P_12345 המזהה של המבצע שמשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות promotion_id ברמת האירוע.
אם המדיניות לא מוגדרת, נעשה שימוש ב-promotion_id ברמת האירוע, אם הוא קיים.
promotion_name string לא Summer Sale שם המבצע המשויך לפריט.

אם היא מוגדרת, המערכת מתעלמת מהמדיניות 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 - &lbrace;&lbrace;שם קריאייטיב במסחר אלקטרוני&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;מיקום קריאייטיב של מסחר אלקטרוני&rbrace;&rbrace;
    • promotion_id – &lbrace;&lbrace;מזהה קידום מכירות מסחר אלקטרוני&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;שם קידום מכירות של מסחר אלקטרוני&rbrace;&rbrace;
    • items - &lbrace;&lbrace;פריטי מסחר אלקטרוני&rbrace;&rbrace;
  • טריגר: האירוע שווה ל-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
    }
    ]
  }
});