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

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

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

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

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

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

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

1. פותחים את Integrations (שילובים), אפשר לגשת אליו באמצעות > הגדרות הפרויקט במסוף Firebase.
2. אם אתם כבר משתמשים ב-BigQuery עם שירותי Firebase אחרים, צריך ללחוץ על ניהול. אחרת, לוחצים על קישור.
3. קוראים את המאמר מידע על קישור Firebase ל-BigQuery ולוחצים על הבא.
4. בקטע הגדרת שילוב, מפעילים את האפשרות מתג 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 ומפורטים בטבלה הבאה:

פרמטר	סוג הנתונים	תיאור
custom_id [מזהה_התאמה אישית]	מחרוזת	המזהה הייחודי אוניברסלי (UUID) של ההתאמה האישית שהוקצה.
קבוצה	מחרוזת	מציין אם המשתמש הוקצה לקבוצת ההתאמה אישית (P13N) או לקבוצת הבקרה (BASELINE).
Arm_index	מספר שלם	מייצג את הערך החלופי שהוקצה למשתמש, מספר שלם בין 0 ל-4.
arm_key	מחרוזת	מכיל את שם הפרמטר שבו נעשה שימוש בהתאמה האישית.
ערך_זרוע	מחרוזת	מכיל את מחרוזת הערך החלופית שהוקצתה על ידי ההתאמה האישית.
event_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