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

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

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

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

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

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

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

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

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

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

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

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

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

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

כדי להריץ שאילתה על נתוני ניתוח נתונים של ניסוי:

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

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

   

3. בתפריט הנפתח Query, בוחרים באפשרות In a new tab.

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

4. כדי להציג אירועי התאמה אישית ונתונים משויכים, מעדכנים את השאילתה כך שתכלול אירועים מסוג personalization_assignment. השאילתה לדוגמה הבאה תחזיר אירוע הקצאה מלא של התאמה אישית לחלוקה ספציפית של תאריכים, ותגביל את התוצאות ל-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.

השדות הבסיסיים שמוצגים באירוע התאמה אישית זהים לשדות של כל אירוע Analytics, כפי שמתואר במאמר [GA4] BigQuery הסכימה לייצוא. בעיקר תצטרכו להתמקד ב-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