בדיקת נתוני ההתאמה האישית באמצעות BigQuery

Remote Config personalization מתעד אירוע personalization_assignment Analytics כשמוקצית התאמה אישית למשתמש, וכך מאפשר לכם להשתמש ב-BigQuery כדי לבדוק ולנתח אירועי התאמה אישית ואירועים משויכים.

טיפ: אפשר גם לראות את האירועים של personalization_assignment בדף Firebase Analytics אירועים, ולצפות בתרשים מפורט של התוצאות בדף Remote Config תוצאות ההתאמה האישית.

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

הפעלת ייצוא של BigQuery עבור Google Analytics לדומיין Firebase

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

קודם כל, מוודאים שמייצאים את נתוני Analytics אל BigQuery:

1. פותחים את הכרטיסייה Integrations (שילובים), שאליה אפשר לגשת באמצעות > Project settings (הגדרות הפרויקט) במסוף Firebase.
2. אם אתם כבר משתמשים ב-BigQuery עם שירותים אחרים של Firebase, לוחצים על Manage (ניהול). אחרת, לוחצים על קישור.
3. בודקים את המידע במאמר מידע על קישור Firebase אל BigQuery ואז לוחצים על הבא.
4. בקטע Configure integration (הגדרת שילוב), מעבירים את המתג Google Analytics למצב מופעל.

5. בוחרים אזור ומגדירים את הגדרות הייצוא.

   הערה: מידע נוסף על Google Analytics בהגדרות של Firebase זמין במאמר איסוף נתונים.

6. לוחצים על קישור אל BigQuery.

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

בשלב הבא, ניגש לאירועי ההתאמה האישית שלנו ב-BigQuery ונבדוק אותם.

גישה לנתוני התאמה אישית באמצעות BigQueryRemote Config

כדי לשלוח שאילתה לנתוני ניתוח של ניסוי:

1. פותחים את BigQuery במסוף Google Cloud. אפשר גם לפתוח אותו ישירות מAnalytics אירועים באמצעות הקישור הצגת האירועים הגולמיים ב-BigQuery בתחתית הדף.

2. בוחרים את הפרויקט Firebase ומרחיבים אותו, מרחיבים את הרשומה analytics_ANALYTICS_PROPERTY_ID ולוחצים על events_.

   

3. בתפריט הנפתח Query (שאילתה), בוחרים באפשרות In a new tab (בכרטיסייה חדשה).

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

4. כדי לראות אירועים של התאמה אישית ונתונים שמשויכים אליהם, מעדכנים את השאילתה כך שתכלול את הפונקציה select personalization_assignment events. שאילתת הדוגמה הבאה תחזיר אירוע מלא של הקצאת התאמה אישית עבור שבריר נתונים של תאריך ספציפי, ותגביל את התוצאות ל-10:

   # Select all personalization_assignment events
   SELECT *
   FROM `PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_DATE_SHARD`
   WHERE event_name = 'personalization_assignment'
   LIMIT 10
   

   טיפ: כדי לחפש בכל טבלאות האירועים במקום בטבלה המפוצלת, אפשר להחליף את התאריך של טבלת האירועים בכוכבית (לדוגמה, PROJECT_NAME.analytics_ANALYTICS_PROPERTY_ID.events_*). לא מומלץ לעשות זאת בתרחישים שאינם בדיקות או במערכי נתונים גדולים.

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

הערה: אם אתם לא מעבירים נתונים מ-Analytics, הנתונים מ-Firebase ב-BigQuery מתעדכנים רק פעם ביום. לכן, יכול להיות שהנתונים שזמינים בדף הניסוי יהיו עדכניים יותר מהנתונים שזמינים במסוף.BigQuery

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

אילו נתונים להתאמה אישית מיוצאים אל BigQuery?

נתוני ההתאמה האישית נכללים בטבלאות Google Analytics ב-BigQuery ונשמרים באירועים personalization_assignment.

השדות הבסיסיים שמופיעים באירוע התאמה אישית זהים לאלה שמופיעים בכל אירוע אחר, כפי שמתואר במאמר [GA4] BigQuery סכימת ייצוא.Analytics הנתונים שיהיו הכי חשובים לכם הם user_pseudo_id i(שניתן להשתמש בו כדי להבדיל בין משתמשים שונים), חותמות הזמן של האירועים ומאפייני משתמשים אחרים.

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

פרמטר	סוג הנתונים	תיאור
personalization_id	מחרוזת	מספק את המזהה הייחודי האוניברסלי (UUID) של ההתאמה האישית שהוקצתה.
קבוצה	מחרוזת	מציין אם המשתמש הוקצה לקבוצת ההתאמה האישית (P13N) או לקבוצת הבסיס (BASELINE).
arm_index	מספר שלם	מייצג את הערך החלופי שהוקצה למשתמש, מספר שלם בין 0 ל-4.
arm_key	מחרוזת	הפרמטר מכיל את השם שמשמש להתאמה אישית.
arm_value	מחרוזת	מכיל את מחרוזת הערך החלופי שהוקצתה על ידי ההתאמה האישית.
engaged_session_event	מספר שלם	כולל את מספר הסשנים שבהם המשתמש הביע התעניינות. מידע נוסף זמין במאמר מידע על סשנים.
firebase_event_origin	מחרוזת	מציין את המקור של האירוע. הערך הזה יהיה תמיד fp לאירועים מסוג personalization_assignment.
firebase_screen_class	מחרוזת	שם הסיווג של המסך שבו המשתמש היה פעיל כשבוצעה הקצאת ההתאמה האישית. מידע נוסף זמין במאמר בנושא אירועים שנאספים באופן אוטומטי.
firebase_screen_id	מספר שלם	מציג את מזהה המסך שבו המשתמש היה כשבוצעה הקצאת ההתאמה האישית. מידע נוסף זמין במאמר בנושא אירועים שנאספים באופן אוטומטי.
first_open_time	מחרוזת	חותמת הזמן, באלפיות השנייה לפי שעון UTC, של הפעם הראשונה שבה המשתמש פתח את האפליקציה. מידע נוסף זמין במאמר בנושא אירועים שנאספים באופן אוטומטי.
ga_session_id	מספר שלם	מספק את מזהה הסשן Google Analytics. מידע נוסף זמין במאמר מידע על סשנים. אפשר להשתמש בפרמטר הזה כדי ליצור קורלציה בין האירוע personalization_assignment לבין אירועים אחרים מסוג Analytics.
ga_session_number	מספר שלם	הפונקציה מחזירה את Google Analytics מספר הסשן. מידע נוסף זמין במאמר מידע על סשנים.

שאילתות לדוגמה

אפשר להשתמש בהצהרת SQL כמו זו שבהמשך כדי לחלץ את הפרמטרים הספציפיים להתאמה אישית מאירועי personalization_assignment:

    # Expand nested personalization parameters
    SELECT
     timestamp_micros(event_timestamp) AS event_time,
     user_pseudo_id,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'group'
     ) AS personalization_group,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'personalization_id'
     ) AS personalization_id,
     (
       SELECT event_params.value.string_value,
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_key'
     ) AS arm_key,
     (
       SELECT event_params.value.string_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'arm_value'
     ) AS arm_value,
     (
       SELECT event_params.value.int_value
       FROM UNNEST(event_params) event_params
       WHERE event_params.key = 'ga_session_id'
     ) AS ga_session_id,
    FROM `PROJECT_NAME.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10