ניהול אירועים של משתמשים

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

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

הצגת מידע נצבר על אירועים שקשורים למשתמשים

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

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

כדי לראות את פרטי אירועי המשתמש:

1. נכנסים לדף AI Applications במסוף Google Cloud .

   אפליקציות AI

2. לוחצים על שם האפליקציה שרוצים לראות את פרטי אירועי המשתמשים שלה.

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

מחיקה סופית של אירועי משתמשים

אם יש לכם אירועים של משתמשים שלא תועדו בצורה נכונה ואתם רוצים להסיר אותם, אתם יכולים לעשות זאת באמצעות ה-method‏ userEvents.purge API. למרות שאתם מתעדים ומייבאים ברמת המיקום, אתם צריכים למחוק אירועים של משתמשים ברמת מאגר הנתונים.

מציינים את האירועים שרוצים להסיר באמצעות מסנן אירועים של משתמש. אתם יכולים להשתמש במסנן אירועי המשתמש כדי לציין את האירועים שאתם רוצים למחוק. אפשר לסנן לפי השדות eventTime,‏ eventType,‏ visitorID ו-userID.

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

curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token)"" \
  -H "Content-Type: application/json; charset=utf-8" \
  --data '{
    "filter":"eventTime > \"2023-12-21T18:25:43.511Z\" eventTime < \"2023-12-21T18:30:43.511Z\"",
  }' \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:purge"

אמורים לקבל אובייקט תגובה שדומה לזה, כאשר purge-user-events-54321 הוא מזהה הפעולה:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/purge-user-events-54321"
}

בדוגמה הזו מתבצעת בקשה לסטטוס הפעולה:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/operations/OPERATION_ID"

דוגמה לסטטוס פעולה:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.PurgeUserEventsResponse"
    "purgedEventsCount": "1"
  }
}

שימוש במסנן אירועים של משתמשים

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

המסנן הוא מחרוזת שמכילה הגבלה אחת או יותר מההגבלות הבאות:

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

• ‫eventType: הגבלת האירועים למחיקה לסוג אירוע יחיד.

• ‫visitorID: מגבילים את האירועים למחיקה למזהה מבקר יחיד.

• ‫userID: הגבלת האירועים למחיקה למזהה משתמש יחיד.

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

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

eventTime > "2023-02-01T00:00:00Z" eventType = add-to-cart

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

• הקלטת אירועים של משתמשים בזמן אמת
• ייבוא אירועים היסטוריים של משתמשים.