מידע על אירועים שקשורים למשתמשים

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

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

איך פועל שיוך (Attribution) של חיפושים

איך פועל השיוך (Attribution)

סקירה כללית של סוגי אירועים שקשורים למשתמשים

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

שם האירוע של המשתמש פעולת המשתמש ‫Google Analytics 4 event_name
home-page-view צפייה בדף הבית. view_homepage
חיפוש (חיפוש ועיון) חיפוש בקטלוג. ‫view_item_list + [searchQuery או pageCategories + filter]
‫category-page-view (המלצות בלבד) צפייה בדפים מיוחדים, כמו דפי מבצעים או קידומי מכירות. view_item_list + pageCategories
detail-page-view צפייה בדף פרטי המוצר. view_item
add-to-cart הוספת מוצר לעגלת הקניות. add_to_cart
shopping-cart-page-view צפייה בעגלת הקניות. view_cart
purchase-complete משלים את התשלום בקופה. purchase

מתוך סוגי האירועים האלה, התכונה 'חיפוש מסחרי מבוסס-AI' משתמשת בארבעת סוגי האירועים הבאים כדי לאותת על פופולריות:

  • SEARCH
  • DETAIL_PAGE_VIEW
  • ADD_TO_CART
  • PURCHASE_COMPLETE

רשימה מפורטת של שדות אירועים ב-GA4 זמינה במאמר שדות אירועים של משתמשים ב-Google Analytics 4.

למידע מפורט על אובייקט UserEvent, אפשר לעיין במאמר בנושא UserEvent.

דרישות לגבי אירועי משתמשים

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

בקטע הזה מפורטים:

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

אפשר לראות את מדדי איכות הנתונים של החיפוש בדף Data quality (איכות הנתונים) במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience. המדדים האלה מציגים את אחוז המוצרים ואירועי המשתמשים שעומדים בתקנים המומלצים של איכות הנתונים. מידע על הצגת נתוני איכות החיפוש זמין במאמר הצגת רמות הביצועים של החיפוש.

דרישות כלליות לגבי אירועים של משתמשים

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

סוג אירוע דרישה השפעה
כל האירועים

אל תכללו נתונים סינתטיים או אירועים כפולים.

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

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

כך מוודאים של-AI Commerce Search יש מספיק נתונים כדי ליצור תוצאות איכותיות.

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

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

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

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

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

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

כדי ליצור היסטוריה תקפה של רצפי התנהגות, מערכת AI Commerce Search צריכה לראות כמה אירועים עם אותו מזהה מבקר.

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

detail-page-view

צריך לכלול בדיוק מוצר אחד לכל אירוע.

אי אפשר להשתמש באירוע אם לא קיים מוצר. אם כוללים כמה מוצרים, האירוע לא תקין ואי אפשר להשתמש בו.

add-to-cart

צריך לכלול בדיוק מוצר אחד לכל אירוע.

אם כוללים כמה מוצרים, האירוע לא תקין ואי אפשר להשתמש בו.

purchase-complete

כולל purchase_transaction.revenue.

אירועים של purchase-complete שחסר בהם השדה revenue לא משמשים לאימון מודלים.

צריך לכלול בדיוק אחד purchase_transaction.currency_code בכל אירועי הרכישה.

אין קוד מטבע שמוגדר כברירת מחדל, צריך לציין קוד.

אירועי רכישה ללא השדה הזה יובילו למדדי הכנסה שגויים.

בודקים שחלק מאירועי הרכישה כוללים כמה מוצרים.

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

דרישות ספציפיות להמלצות

אם אתם משתמשים בהמלצות, חשוב לוודא שאירועי המשתמשים שלכם עומדים בדרישות הבאות.

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

סוג אירוע דרישה השפעה
purchase-complete

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

כך מוודאים שנוצרים דפוסי רכישה משותפת תקינים.

דרישות ספציפיות לחיפוש

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

סוג אירוע דרישה השפעה
search

‫searchQuery חייב להתקיים כדי לחפש אירועים, ו ‫pageCategories חייב להתקיים כדי לעיין באירועים.

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

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

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

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

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

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

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

כדאי לכלול את השדה attribution_token כדי לקשר אירועים אחרים לאירועי חיפוש.

אם לא תכללו אסימון שיוך, תופעל שגיאה ב-AI Commerce Search ב-Gemini Enterprise for Customer Experience, והדבר ישפיע באופן שלילי על איכות החיפוש ועל דיוק המדדים.

דרישות לאופטימיזציה של החיפוש

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

מומלץ להעלות אירועים לפחות פעם ביום, עם עיכוב של עד 24 שעות.

מדד האירועים נפח או תדירות האירועים תיאור
נפח האירועים מסוג search ‫250,000 ב-90 הימים האחרונים

נדרשים לפחות 250,000 אירועים ב-90 הימים האחרונים כדי לבצע אופטימיזציה של חוויית החיפוש על סמך אירועים שנאספו.

כדי לשמור על איכות נתונים טובה, מומלץ להעלות אירועים לפחות פעם ביום. במהלך ייבוא של אירועים היסטוריים, חשוב לוודא שהתפלגות הנתונים מוטה לכיוון חותמת הזמן העדכנית ביותר. מספר האירועים ביום האחרון של חותמת הזמן צריך להיות שווה למספר הממוצע של האירועים היומיים או גדול ממנו.
נפח האירועים מסוג detail-page-view שמשויכים לאירוע מסוג search ‫500,000 ב-30 הימים האחרונים נדרשים לפחות 500,000 אירועים כדי לבצע אופטימיזציה של תוצאות החיפוש באמצעות אירועים של משתמשים.
מספר האירועים הממוצע מסוג detail-page-view שניתן לשיוך לאירוע search לכל מוצר ‫10 ב-30 הימים האחרונים חובה לביצוע אופטימיזציה של תוצאות החיפוש באמצעות האירועים שהמערכת קולטת, אלא אם מעלים אירועים מ-21 הימים האחרונים.
החלק היחסי של אירועי search עם מסננים שניתן לנתח ‫0.1 ב-30 הימים האחרונים מומלץ לשימוש באופטימיזציה של סדר ההיבטים הדינמיים בתגובה לחיפוש.
שיעור המוצרים שנמצאו בחיפוש עם מחיר ‫0.95 ב-30 הימים האחרונים נדרש כדי לבצע אופטימיזציה של תוצאות החיפוש באמצעות האירועים שנאספים.
מספר ממוצע של אירועי add-to-cart שאפשר לשייך לאירוע search לכל מוצר בתשלום ‫0.5 ב-30 הימים האחרונים מומלץ לשימוש בתוצאות חיפוש שעברו אופטימיזציה להגדלת ההכנסה.
מספר האירועים הממוצע מסוג purchase-complete שמשויכים לאירוע מסוג search לכל מוצר עם מחיר שאפשר לחפש ‫0.5 ב-30 הימים האחרונים מומלץ לשימוש בתוצאות חיפוש שעברו אופטימיזציה להגדלת ההכנסה.

דרישות להפעלת התאמה אישית של חיפוש Google

כדי להתאים אישית את תוצאות החיפוש של המשתמשים על סמך הפעילות שלהם, Google Search צריכה את הנתונים הבאים.

אחרי שמעלים את הנתונים הבאים, אפשר להתאים אישית את התוצאות בחיפוש באופן אוטומטי.

מדד האירועים נפח או תדירות האירועים תיאור
נפח האירועים מסוג search שמוצגים בחיפוש ‫100,000 ב-30 הימים האחרונים

כדי לספק התאמה אישית, צריך לפחות 100,000 אירועים שהוצגו בחיפוש ב-30 הימים האחרונים.

תוצאות החיפוש לא נשמרות במטמון פחות מ-1% מ-100,000 אירועי המשתמשים האחרונים

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

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

התאמה בין מזהה המבקר ב-SearchRequests לבין אירועים ברמת המשתמש התאמה של יותר מ-10% ל-100,000 אירועי המשתמשים האחרונים חשוב לוודא שהרווח והפורמט של מזהה המבקר זהים ב-SearchRequests ובאירועי המשתמשים. שמירה על עקביות בפורמט של מזהה המבקרים מאפשרת לוודא שחיפוש Google יכול לזהות את פעילות המשתמשים בצורה נכונה.

שיטות מומלצות לשימוש באירועים ברמת המשתמש

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

בדיקת חשיפות של מוצרים

כשמייבאים אירועים ל-AI Commerce Search, בין אם מדובר באירועים היסטוריים או באירועים פעילים בייצור, צריך לוודא שהמודל עומד במגבלות הבאות כדי שניתן יהיה לאמן אותו, כפי שמתואר כאן.

חשוב לציין שנפח המינימום של האירועים הנדרש הוא לא מספר נפח כללי. לדוגמה, אם המגבלות מציינות שצריך 150,000 אירועים של צפייה בדף פרטים, אי אפשר לחשוב על זה כ-150,000 אירועים אקראיים של צפייה בדף פרטים. האירועים צריכים להיות קשורים לאירועים אחרים, כמו SEARCH או ADD TO CART.

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

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

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

העדיפות של סוג האירוע

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

עדיפות סוגי אירועים שקשורים למשתמשים

נדרש לניסויים ראשוניים בשידור חי להמלצות

(סוגי האירועים תלויים בסוג מודל ההמלצות)

detail-page-view

add-to-cart

purchase-complete

home-page-view
נדרש אירוע נוסף לניסוי חיפוש

search

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

בנוסף, אירועי המשתמשים משמשים גם כבסיס למדידת מדדי KPI, כולל הכנסה לכל משתמש, שיעור קליקים ושיעור המרות.

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

שיוך (Attribution) אירועים

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

מסלול המשתמש האידיאלי הוא:

  1. המשתמש מבצע חיפוש של שאילתה.

  2. המשתמש מפעיל צפיות בדפים במוצר שמעניין אותו.

  3. המשתמש מוסיף לעגלת הקניות את המוצר שהוא רוצה לקנות.

  4. המשתמש מריץ עסקת רכישה של המוצרים שהוא מחליט לקנות.

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

זרימת האירועים האידיאלית היא:

  • נתיב 1: אירוע חיפוש ← אירוע צפייה בדף פרטים ← אירוע הוספה לעגלת קניות ← אירוע רכישה
  • נתיב 2: אירוע חיפוש ← אירוע הוספה לעגלת הקניות ← אירוע רכישה

בקריאה של API לחיפוש שלא נשמר במטמון, רצף האירועים הוא כדלקמן:

  • כל מבקר מקבל תגובה ייחודית לשאילתת חיפוש, ואחריה מועבר אסימון השיוך המתאים.
  • יש הבדל ברור בין מעקב אחר visitorID1 לבין מעקב אחר visitorID2, כי טוקן השיוך שונה.

דוגמאות וסכימות של סוגי אירועים של משתמשים

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

הוספנו דוגמאות ל-JavaScript Pixel ול-Tag Manager. ב-BigQuery, מפורטת סכימת הטבלה המלאה לכל סוג.

הפרמטר userId הוא אופציונלי לכל סוגי האירועים שקשורים למשתמשים. השדות של פרטי המוצר (priceInfo ו-availability) הם אופציונליים.

חשוב לדעת:

  • השדה experimentIds נדרש רק אם מפעילים ניסוי A/B.
  • השדה attributionToken הוא חובה רק ב-AI Commerce Search. הוא משמש למדידת ביצועים. אין לשלוח טוקנים של שיוך אל predict, אל search ואל detail-page-view, או אל אירועי קליקים.
  • חשוב לוודא שבכל האירועים מוגדר מטבע אחד, במיוחד אם אתם מתכננים להשתמש בGoogle Cloud מסוף כדי לקבל מדדי הכנסות. ‫AI Commerce Search API לא תומך בשימוש בכמה מטבעות לכל קטלוג.

מידע נוסף על אובייקט אירוע המשתמש מופיע בUserEventמאמרי העזרה של ה-API.

הוסף לעגלה

בדוגמה הבאה מוצג פורמט אירוע המשתמש add-to-cart עם שדות חובה בלבד.

כמות המוצרים באירוע add-to-cart צריכה להיות ערך מצטבר שמייצג את כמות המוצרים שמשויכת לאירוע הספציפי של המשתמש. לדוגמה, אם מוסיפים לעגלת הקניות שתי יחידות של מוצר, בשדה הכמות של אירוע add-to-cart צריך להזין את הערך 2. באירועים מסוג add-to-cart, צריך לכלול בדיוק מוצר אחד לכל אירוע.

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

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

JavaScript Pixel

var user_event = {
  "eventType": "add-to-cart",
  "visitorId": "visitor-id",
  "productDetails": [{
    "product": {
      "id": "product-id"
    },
    "quantity": { "value": product-quantity }
  }]
};

Tag Manager 

<script>
    dataLayer = dataLayer || [];
    dataLayer.push({
      'cloud_retail': {
        'eventType': 'add-to-cart',
        'visitorId': 'visitor-id',
        // You can also define the visitor ID
        // directly on the Tag Manager tag.
        'productDetails': [{
          'product': {
            'id': 'product-id'
          },
          'quantity': product-quantity
        }]
      }
    });
</script>

BigQuery

זו הסכימה המלאה של JSON לסוג האירוע הזה של המשתמש. מציינים את הסכימה הזו כשיוצרים טבלאות לסוג האירוע הזה של המשתמש ב-BigQuery.

הערכים של מצבי שדות החובה הם REQUIRED או REPEATED. האמצעים להגעה לשדות אופציונליים מוגדרים כNULLABLE.

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

[
 {
   "name": "eventType",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "visitorId",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "eventTime",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "experimentIds",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "attributionToken",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "productDetails",
   "type": "RECORD",
   "mode": "REPEATED",
   "fields": [
     {
       "name": "product",
       "type": "RECORD",
       "mode": "REQUIRED",
       "fields": [
         {
           "name": "id",
           "type": "STRING",
           "mode": "REQUIRED"
         }
       ]
     },
     {
       "name": "quantity",
       "type": "INTEGER",
       "mode": "REQUIRED"
     }
   ]
 },
 {
   "name": "cartId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "userInfo",
   "type": "RECORD",
   "mode": "NULLABLE",
   "fields": [
     {
       "name": "userId",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "ipAddress",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "userAgent",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "directUserRequest",
       "type": "BOOLEAN",
       "mode": "NULLABLE"
     }
   ]
 },
 {
   "name": "uri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "referrerUri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "pageViewId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "entity",
   "type": "STRING",
   "mode": "NULLABLE"
 }
]

צפייה בדף קטגוריה

בדוגמה הבאה מוצג הפורמט של אירוע משתמש category-page-view.

בדוגמאות הבאות מוצגים רק שדות החובה של פורמט אירוע המשתמש category-page-view.

בדרך כלל יש רק קטגוריה אחת שמשויכת לדף, אבל השדה pageCategories תומך גם בהיררכיית קטגוריות שאפשר לספק כרשימה.

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

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

JavaScript Pixel

var user_event = {
  "eventType": "category-page-view",
  "visitorId": "visitor-id",
  "pageCategories": ["category1 > category2"]
};

Tag Manager 

<script>
    dataLayer = dataLayer || [];
    dataLayer.push({
      'cloud_retail': {
        'eventType': 'category-page-view',
        'visitorId": 'visitor-id',
        // You can also define the user ID and visitor ID
        // directly on the Tag Manager tag.
        'pageCategories': ['category1 > category2']
      }
    });
</script>

BigQuery

זו הסכימה המלאה של JSON לסוג האירוע הזה של המשתמש. מציינים את הסכימה הזו כשיוצרים טבלאות לסוג האירוע הזה של המשתמש ב-BigQuery.

הערכים של מצבי שדות החובה הם REQUIRED או REPEATED. האמצעים להגעה לשדות אופציונליים מוגדרים כNULLABLE.

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

[
 {
   "name": "eventType",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "visitorId",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "eventTime",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "experimentIds",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "attributionToken",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "productDetails",
   "type": "RECORD",
   "mode": "REPEATED",
   "fields": [
     {
       "name": "product",
       "type": "RECORD",
       "mode": "REQUIRED",
       "fields": [
         {
           "name": "id",
           "type": "STRING",
           "mode": "REQUIRED"
         }
       ]
     }
   ]
 },
 {
   "name": "pageCategories",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "userInfo",
   "type": "RECORD",
   "mode": "NULLABLE",
   "fields": [
     {
       "name": "userId",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "ipAddress",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "userAgent",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "directUserRequest",
       "type": "BOOLEAN",
       "mode": "NULLABLE"
     }
   ]
 },
 {
   "name": "uri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "referrerUri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "pageViewId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "entity",
   "type": "STRING",
   "mode": "NULLABLE"
 }
]

צפייה בדף הפרטים

בהמשך מוצג פורמט נתוני האירועים של המשתמש detail-page-view.

בדוגמאות הבאות מוצגים רק שדות החובה של פורמט אירוע המשתמש detail-page-view.

ברוב המקרים, productDetails מכיל פרטים על המוצר המשויך, אלא אם נמכר מארז של פריטים.

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

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

JavaScript Pixel

var user_event = {
  "eventType": "detail-page-view",
  "visitorId": "visitor-id",
  "productDetails": [{
    "product": {
      "id": "product-id"
    }
  }]
};

Tag Manager 

<script>
    dataLayer = dataLayer || [];
    dataLayer.push({
      'cloud_retail': {
        'eventType': 'detail-page-view',
        'visitorId': 'visitor-id',
        // You can also define the visitor ID directly on
        // the Tag Manager tag.
        'productDetails': [{
          'product': {
            'id': 'product-id'
          }
        }]
      }
    });
</script>

BigQuery

זו הסכימה המלאה של JSON לסוג האירוע הזה של המשתמש. מציינים את הסכימה הזו כשיוצרים טבלאות לסוג האירוע הזה של המשתמש ב-BigQuery.

הערכים של מצבי שדות החובה הם REQUIRED או REPEATED. האמצעים להגעה לשדות אופציונליים מוגדרים כNULLABLE.

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

[
 {
   "name": "eventType",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "visitorId",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "eventTime",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "experimentIds",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "attributionToken",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "productDetails",
   "type": "RECORD",
   "mode": "REPEATED",
   "fields": [
     {
       "name": "product",
       "type": "RECORD",
       "mode": "REQUIRED",
       "fields": [
         {
           "name": "id",
           "type": "STRING",
           "mode": "REQUIRED"
         }
       ]
     }
   ]
 },
 {
   "name": "userInfo",
   "type": "RECORD",
   "mode": "NULLABLE",
   "fields": [
     {
       "name": "userId",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "ipAddress",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "userAgent",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "directUserRequest",
       "type": "BOOLEAN",
       "mode": "NULLABLE"
     }
   ]
 },
 {
   "name": "uri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "referrerUri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "pageViewId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "entity",
   "type": "STRING",
   "mode": "NULLABLE"
 }
]

צפייה בדף הבית

בדוגמה הבאה מוצג הפורמט של אירוע משתמש home-page-view.

בדוגמאות הבאות מוצגים רק שדות החובה של פורמט אירוע המשתמש home-page-view.

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

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

JavaScript Pixel

var user_event = {
  "eventType": "home-page-view",
  "visitorId": "visitor-id",
};

Tag Manager 

<script>
    dataLayer = dataLayer || [];
    dataLayer.push({
      'cloud_retail': {
        'eventType': 'home-page-view',
        'visitorId': 'visitor-id'
        // You can also define the visitor ID
        // directly on the Tag Manager tag.
      }
    });
</script>

BigQuery

זו הסכימה המלאה של JSON לסוג האירוע הזה של המשתמש. מציינים את הסכימה הזו כשיוצרים טבלאות לסוג האירוע הזה של המשתמש ב-BigQuery.

הערכים של מצבי שדות החובה הם REQUIRED או REPEATED. האמצעים להגעה לשדות אופציונליים מוגדרים כNULLABLE.

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

[
 {
   "name": "eventType",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "visitorId",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "eventTime",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "experimentIds",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "attributionToken",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "productDetails",
   "type": "RECORD",
   "mode": "REPEATED",
   "fields": [
     {
       "name": "product",
       "type": "RECORD",
       "mode": "REQUIRED",
       "fields": [
         {
           "name": "id",
           "type": "STRING",
           "mode": "REQUIRED"
         }
       ]
     },
     {
       "name": "quantity",
       "type": "INTEGER",
       "mode": "REQUIRED"
     }
   ]
 },
 {
   "name": "userInfo",
   "type": "RECORD",
   "mode": "NULLABLE",
   "fields": [
     {
       "name": "userId",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "ipAddress",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "userAgent",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "directUserRequest",
       "type": "BOOLEAN",
       "mode": "NULLABLE"
     }
   ]
 },
 {
   "name": "uri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "referrerUri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "pageViewId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "entity",
   "type": "STRING",
   "mode": "NULLABLE"
 }
]

הרכישה הושלמה

בהמשך מוצג פורמט נתוני האירועים של המשתמש purchase-complete.

בדוגמאות הבאות מוצגים רק שדות החובה של פורמט אירוע המשתמש purchase-complete.

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

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

JavaScript Pixel

var user_event = {
  "eventType": "purchase-complete",
  "visitorId": "visitor-id",
  "productDetails": [{
    "product": {
      "id": "product-id"
    },
    "quantity": product-quantity
  }],
  "purchaseTransaction": {
    "revenue": revenue,
    "currencyCode": "currency-code"
  }
};

Tag Manager 

<script>
    dataLayer = dataLayer || [];
    dataLayer.push({
      'cloud_retail': {
        'eventType': 'purchase-complete',
        'visitorId': 'visitor-id',
        // You can also define the visitor ID directly on
        // the Tag Manager tag.
        'productDetails': [{
          'product': {
            'id': 'product-id'
          },
          'quantity': product-quantity
        }],
        'purchaseTransaction': {
          'revenue': revenue,
          'currencyCode': 'currency-code'
        }
      }
    });
</script>

BigQuery

זו הסכימה המלאה של JSON לסוג האירוע הזה של המשתמש. מציינים את הסכימה הזו כשיוצרים טבלאות לסוג האירוע הזה של המשתמש ב-BigQuery.

הערכים של מצבי שדות החובה הם REQUIRED או REPEATED. האמצעים להגעה לשדות אופציונליים מוגדרים כNULLABLE.

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

[
 {
   "name": "eventType",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "visitorId",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "eventTime",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "experimentIds",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "attributionToken",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "productDetails",
   "type": "RECORD",
   "mode": "REPEATED",
   "fields": [
     {
       "name": "product",
       "type": "RECORD",
       "mode": "REQUIRED",
       "fields": [
         {
           "name": "id",
           "type": "STRING",
           "mode": "REQUIRED"
         },
         {
           "name": "priceInfo",
           "type": "RECORD",
           "mode": "NULLABLE",
           "fields": [
             {
               "name": "price",
               "type": "FLOAT",
               "mode": "REQUIRED"
             },
             {
               "name": "originalPrice",
               "type": "FLOAT",
               "mode": "NULLABLE"
             },
             {
               "name": "currencyCode",
               "type": "STRING",
               "mode": "REQUIRED"
             },
             {
               "name": "cost",
               "type": "FLOAT",
               "mode": "NULLABLE"
             }
           ]
         }
       ]
     },
     {
       "name": "quantity",
       "type": "INTEGER",
       "mode": "REQUIRED"
     }
   ]
 },
 {
   "name": "cartId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "purchaseTransaction",
   "type": "RECORD",
   "mode": "REQUIRED",
   "fields": [
     {
       "name": "id",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "revenue",
       "type": "FLOAT",
       "mode": "REQUIRED"
     },
     {
       "name": "tax",
       "type": "FLOAT",
       "mode": "NULLABLE"
     },
     {
       "name": "cost",
       "type": "FLOAT",
       "mode": "NULLABLE"
     },
     {
       "name": "currencyCode",
       "type": "STRING",
       "mode": "REQUIRED"
     }
   ]
 },
 {
   "name": "userInfo",
   "type": "RECORD",
   "mode": "NULLABLE",
   "fields": [
     {
       "name": "userId",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "ipAddress",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "userAgent",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "directUserRequest",
       "type": "BOOLEAN",
       "mode": "NULLABLE"
     }
   ]
 },
 {
   "name": "uri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "referrerUri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "pageViewId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "entity",
   "type": "STRING",
   "mode": "NULLABLE"
 }
]

בדוגמה הבאה מוצג הפורמט של אירוע משתמש search.

אובייקט החיפוש המינימלי הנדרש

אלה שדות החובה המינימליים שצריך להזין כדי שחיפוש מסחרי מבוסס-AI יחזיר רשימה של תוצאות חיפוש:

  • הערך של searchQuery נקרא מהפרמטר search_term או מהאירועים view_search_results.
  • הערך של productDetails נקרא מהפרמטר items של האירוע view_item_list. היא צריכה לכלול את רשימת מזהי המוצרים שמוצגים למשתמש הקצה בדף תוצאות החיפוש.
  • ‫userEvents מתעד את כל פרטי המטא-נתונים ש-AI Commerce Search API צריך לדעת על האינטראקציות של משתמשי הקצה עם האתר של הלקוח.

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

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

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

JavaScript Pixel

var user_event = {
  "eventType": "search",
  "visitorId": "visitor-id",
  "searchQuery": "search-query",
  "pageCategories": ["category1 > category2"],
  "productDetails": [
    {
      "product": {
        "id": "product-id1"
      }
    }, {
      "product": {
        "id": "product-id2"
      }
    }
  ]
};

Tag Manager 

<script>
    dataLayer = dataLayer || [];
    dataLayer.push({
      'cloud_retail': {
        'eventType': 'search',
        'visitorId': 'visitor-id',
        // You can also define the visitor ID
        // directly on the Tag Manager tag.
        'searchQuery': 'search-query',
        'pageCategories': ['category1 > category2'],
        'productDetails': [
          {
            'product': {
              'id': 'product-id1'
            }
          }, {
            'product': {
              'id': 'product-id2'
            }
          }
        ]
      }
    });
</script>

BigQuery

זו הסכימה המלאה של JSON לסוג האירוע הזה של המשתמש. מציינים את הסכימה הזו כשיוצרים טבלאות לסוג האירוע הזה של המשתמש ב-BigQuery.

הערכים של מצבי שדות החובה הם REQUIRED או REPEATED. האמצעים להגעה לשדות אופציונליים מוגדרים כNULLABLE.

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

[
 {
   "name": "eventType",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "visitorId",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "eventTime",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "productDetails",
   "type": "RECORD",
   "mode": "REPEATED",
   "fields": [
     {
       "name": "product",
       "type": "RECORD",
       "mode": "REQUIRED",
       "fields": [
         {
           "name": "id",
           "type": "STRING",
           "mode": "REQUIRED"
         }
       ]
     }
   ]
 },
 {
   "name": "searchQuery",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "pageCategories",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "entity",
   "type": "STRING",
   "mode": "NULLABLE"
 }
]

השלמה אוטומטית

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

בדוגמאות הבאות מוצג השדה completionDetail כשמשתמש מקליד 'sh' ולוחץ על ההצעה השנייה, 'shoes', ברשימת ההצעות כדי להפעיל אירוע חיפוש. אם המשתמש לא לוחץ על אף אחת מההצעות, השדה completionDetail נשאר ריק.

הערך של eventType חייב להיות "search".

‫completionAttributionToken היא התגובה attributionToken מ-completeQuery.

הערך של selectedSuggestion צריך להיות זהה לערך של searchQuery.

JavaScript Pixel

var user_event = {
  "eventType": "search",
  "visitorId": "visitor-id",
  "searchQuery": "search-query",
  "pageCategories": ["category1 > category2"],
  "productDetails": [
    {
      "product": {
        "id": "product-id1"
      }
    }, {
      "product": {
        "id": "product-id2"
      }
    }
  ]
  "completionDetail": {
    "completionAttributionToken": "completion_token",
    "selectedSuggestion": "search-query",
    "selectedPosition": completion_position
  }
};

Tag Manager 

<script>
    dataLayer = dataLayer || [];
    dataLayer.push({
      'cloud_retail': {
        'eventType': 'search',
        'visitorId': 'visitor-id',
        // You can also define the visitor ID
        // directly on the Tag Manager tag.
        'searchQuery': 'search-query',
        'pageCategories': ['category1 > category2'],
        'productDetails': [
          {
            'product': {
              'id': 'product-id1'
            }
          }, {
            'product': {
              'id': 'product-id2'
            }
          }
        ]
        "completionDetail": {
          "completionAttributionToken": 'completion_token',
          "selectedSuggestion": 'search-query',
          "selectedPosition": completion_position
        }
      }
    });
</script>

BigQuery

זו הסכימה המלאה של JSON לסוג האירוע הזה של המשתמש. מציינים את הסכימה הזו כשיוצרים טבלאות לסוג האירוע הזה של המשתמש ב-BigQuery.

הערכים של מצבי שדות החובה הם REQUIRED או REPEATED. האמצעים להגעה לשדות אופציונליים מוגדרים כNULLABLE.

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

[
 {
   "name": "eventType",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "visitorId",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "eventTime",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "productDetails",
   "type": "RECORD",
   "mode": "REPEATED",
   "fields": [
     {
       "name": "product",
       "type": "RECORD",
       "mode": "REQUIRED",
       "fields": [
         {
           "name": "id",
           "type": "STRING",
           "mode": "REQUIRED"
         }
       ]
     }
   ]
 },
 {
   "name": "searchQuery",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "pageCategories",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "completionDetail",
   "type": "RECORD"
   "mode": "NULLABLE"
   "fields": [
     {
       "name": "completionAttributionToken",
       "type": "STRING",
       "mode": "REQUIRED"
     },
     {
       "name": "selectedSuggestion",
       "type": "STRING",
       "mode": "REQUIRED"
     },
     {
       "name": "selectedPosition",
       "type": "INTEGER",
       "mode": "REQUIRED"
     }
    ]
 }
]

צפייה בדף עגלת הקניות

בהמשך מוצג פורמט נתוני האירועים של המשתמש shopping-cart-page-view.

בדוגמאות הבאות מוצגים רק שדות החובה של פורמט אירוע המשתמש shopping-cart-page-view.

צריך לספק את האובייקטים productDetails ו-userEvents אלא אם עגלת הקניות ריקה.

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

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

JavaScript Pixel

var user_event = {
  "eventType": "shopping-cart-page-view"",
  "visitorId": "VISITOR-ID"
  "cartId": "CART-ID",
  "productDetails": [{
      "product": {
        "id": "PRODUCT-ID"
      },
      "quantity": PRODUCT-QUANTITY
    }]
};

מחליפים את PRODUCT-ID, PRODUCT-QUANTITY, VISOTOR-ID ו-CART-ID במזהה המוצר, בכמות המוצרים, במזהה הסשן ובמזהה עגלת הקניות.

Tag Manager 

<script>
    dataLayer = dataLayer || [];
    dataLayer.push({
      'cloud_retail': {
        'eventType': 'shopping-cart-page-view',
        'visitorId': 'VISITOR-ID'
        // You can also define the visitor ID
        // directly on the Tag Manager tag.
        'cartId': 'CART-ID',
        'productDetails': [{
            'product': {
              'id': 'PRODUCT-ID'
            },
            'quantity': PRODUCT-QUANTITY
          }]
      }
    });
</script>

מחליפים את PRODUCT-ID, PRODUCT-QUANTITY, VISOTOR-ID ו-CART-ID במזהה המוצר, בכמות המוצרים, במזהה הסשן ובמזהה עגלת הקניות.

BigQuery

זו הסכימה המלאה של JSON לסוג האירוע הזה של המשתמש. מציינים את הסכימה הזו כשיוצרים טבלאות לסוג האירוע הזה של המשתמש ב-BigQuery.

הערכים של מצבי שדות החובה הם REQUIRED או REPEATED. האמצעים להגעה לשדות אופציונליים מוגדרים כNULLABLE.

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

[
 {
   "name": "eventType",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "visitorId",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "eventTime",
   "type": "STRING",
   "mode": "REQUIRED"
 },
 {
   "name": "experimentIds",
   "type": "STRING",
   "mode": "REPEATED"
 },
 {
   "name": "attributionToken",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "productDetails",
   "type": "RECORD",
   "mode": "REPEATED",
   "fields": [
     {
       "name": "product",
       "type": "RECORD",
       "mode": "REQUIRED",
       "fields": [
         {
           "name": "id",
           "type": "STRING",
           "mode": "REQUIRED"
         }
       ]
     },
     {
       "name": "quantity",
       "type": "INTEGER",
       "mode": "REQUIRED"
     }
   ]
 },
 {
   "name": "cartId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "userInfo",
   "type": "RECORD",
   "mode": "NULLABLE",
   "fields": [
     {
       "name": "userId",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "ipAddress",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "userAgent",
       "type": "STRING",
       "mode": "NULLABLE"
     },
     {
       "name": "directUserRequest",
       "type": "BOOLEAN",
       "mode": "NULLABLE"
     }
   ]
 },
 {
   "name": "uri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "referrerUri",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "pageViewId",
   "type": "STRING",
   "mode": "NULLABLE"
 },
 {
   "name": "entity",
   "type": "STRING",
   "mode": "NULLABLE"
 }
]

שדות של אירועים ברמת המשתמש ב-Google Analytics 4

בטבלה הבאה אפשר לראות איך שדות של אירועי משתמשים ב-Google Analytics 4 ממופים לשדות של חיפוש מסחר מבוסס-AI.

לפני שמייבאים או מתעדים אירועי משתמשים מ-Google Analytics 4, צריך לוודא שאירועי המשתמשים ב-Google Analytics 4 משתמשים בשדות הבאים, כדי שחיפוש AI Commerce יוכל לשלב את הנתונים בצורה נכונה.

‫Google Analytics 4 קמעונאות
ecommerce.purchase_revenue purchaseTransaction.revenue
event_name eventType
event_timestamp eventTime
items.item_id productDetails.product.id
items.price productDetails.product.priceInfo.price
items.quantity productDetails.quantity
מפתח:
event_params.key מוגדר ל-"currency"

ערך:
event_params.value.string_value		 productDetails.product.priceInfo.currencyCode
מפתח:
event_params.key מוגדר ל-"currency"

ערך:
event_params.value.string_value		 purchaseTransaction.currencyCode
מפתח:
event_params.key מוגדר ל-"search_term"

ערך:
event_params.value.string_value		 searchQuery
user_id userInfo.userId
user_pseudo_id visitorId

המאמרים הבאים