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

התכונה "Remote Config" מתעדת אירוע personalization_assignmentAnalytics כשמשתמש מקבל התאמה אישית. כך אתם יכולים להשתמש ב-BigQuery כדי לבדוק ולנתח אירועי התאמה אישית ואירועים משויכים.

הערה: נתוני ההתאמה האישית של Remote Config מיוצאים אל BigQuery כקבוצת משנה של ייצוא הנתונים הרגיל של Analytics. אין צורך להגדיר ייצוא נתונים נפרד של Remote Config. הפעלת הייצוא של BigQuery עבור Analytics כוללת באופן אוטומטי את כל האירועים של personalization_assignment.

טיפ: במסוף Firebase, אפשר גם לראות את האירועים של personalization_assignment בAnalytics > לוח הבקרה של Events ולראות תרשים מפורט של התוצאות בדף תוצאות ההתאמה האישית.

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

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

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

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

1. במסוף Firebase, עוברים אל הגדרות > שילובים.

2. בכרטיס BigQuery, לוחצים על קישור. אם אתם כבר משתמשים ב-BigQuery עם שירותים אחרים של Firebase, לוחצים על Manage (ניהול).

3. קוראים את המידע בקטע מידע על קישור Firebase אל BigQuery ולוחצים על הבא.

4. בקטע Configure integration, מפעילים את המתג Google Analytics.

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

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

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

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

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

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

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

1. פותחים את BigQuery במסוף Google Cloud. אפשר גם לפתוח את BigQuery ישירות ממסוף Firebase: נכנסים לAnalytics > Events dashboard ומשתמשים בקישור view your raw events in 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_ID.analytics_ANALYTICS_PROPERTY_ID.events_DATE_SHARD`
   WHERE event_name = 'personalization_assignment'
   LIMIT 10
   

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

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

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

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

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

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

השדות הבסיסיים שמופיעים באירוע התאמה אישית זהים לאלה שמופיעים בכל אירוע של Analytics, כמו שמתואר במאמר ייצוא נתונים מ-Google Analytics for Firebase אל BigQuery. השדות החשובים ביותר הם user_pseudo_id (שבאמצעותו אפשר להבדיל בין משתמשים שונים), חותמות הזמן של האירועים ומאפייני משתמשים אחרים.

פרטים ספציפיים להתאמה אישית מאוחסנים בשדה 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_ID.analytics_ANALYTICS_ACCOUNT_ID.events_DATE_SHARD`
    WHERE event_name = 'personalization_assignment'
    LIMIT 10