‫[GA4] סכימת BigQuery Export

הרשומה event_params

הרשומה item_params

השדות של privacy_info

הרשומה user_properties

הרשומה user_ltv

הרשומה item_params

אם השתמשתם בגרסאות SDK קודמות ואתם מתכננים לשדרג ל-Android 17.2.5 ואילך ו/או ל-iOS 16.20.0 ואילך, אתם צריכים לשקול את הדברים הבאים:

• כדי להשתמש בסכימה הנוכחית של BigQuery Export, צריך לשדרג את ה-SDK ל-Android 17.2.5 ואילך או ל-iOS 16.20.0 ואילך. כשמשתמשים בגרסאות SDK קודמות, הנתונים שמיוצאים משקפים את הסכימה הישנה.
• אחרי השדרוג תוכלו לגשת לנתוני הפריטים רק ממערך הפריטים החוזרים. נתוני הפריטים כבר לא יהיו זמינים בפרמטרים רגילים של אירועים כמו בגרסאות ה-SDK הקודמות.
• עשינו את השינוי הזה כדי לאפשר לכם לנתח נתונים של הרבה מוצרים במקביל.
• כתוצאה מכך, ייתכן שתצטרכו לתקן את ההפניות לנתוני פריטים או מוצרים.

1. מתחברים לCloud Platform Console > הדף ‏Manage resources (ניהול משאבים).
2. פותחים את הפרויקט שאת הנתונים שלו רוצים להעביר ולוחצים על Activate Google Cloud Shell (הפעלה של Google Cloud Shell) בראש הדף.
3. כשהמעטפת נפתחת, מעתיקים את הסקריפט שמוצג בהמשך לקובץ בשם migration_script.sql:
   1. שולחים את הפקודה cat > migration_script.sql
   2. מעתיקים את הסקריפט שמוצג למטה ומדביקים אותו במעטפת.
   3. לוחצים על Ctrl+D כדי לשמור ולצאת.
   הסקריפט (migration_script.sql):

     SELECT
     @date AS event_date,
     event.timestamp_micros AS event_timestamp,
     event.previous_timestamp_micros AS event_previous_timestamp,
     event.name AS event_name,
     event.value_in_usd  AS event_value_in_usd,
      user_dim.bundle_info.bundle_sequence_id AS event_bundle_sequence_id,
     user_dim.bundle_info.server_timestamp_offset_micros as event_server_timestamp_offset,
     (
     SELECT
       ARRAY_AGG(STRUCT(event_param.key AS key,
           STRUCT(event_param.value.string_value AS string_value,
             event_param.value.int_value AS int_value,
             event_param.value.double_value AS double_value, 
             event_param.value.float_value AS float_value) AS value))
     FROM
       UNNEST(event.params) AS event_param) AS event_params,
     user_dim.first_open_timestamp_micros AS user_first_touch_timestamp,
     user_dim.user_id AS user_id,
     user_dim.app_info.app_instance_id AS user_pseudo_id,
     "" AS stream_id,
     user_dim.app_info.app_platform AS platform,
     STRUCT( user_dim.ltv_info.revenue AS revenue,
       user_dim.ltv_info.currency AS currency ) AS user_ltv,
     STRUCT( user_dim.traffic_source.user_acquired_campaign AS name,
         user_dim.traffic_source.user_acquired_medium AS medium,
         user_dim.traffic_source.user_acquired_source AS source ) AS traffic_source,
     STRUCT( user_dim.geo_info.continent AS continent,
       user_dim.geo_info.country AS country,
       user_dim.geo_info.region AS region,
       user_dim.geo_info.city AS city ) AS geo,
     STRUCT( user_dim.device_info.device_category AS category,
       user_dim.device_info.mobile_brand_name,
       user_dim.device_info.mobile_model_name,
       user_dim.device_info.mobile_marketing_name,
       user_dim.device_info.device_model AS mobile_os_hardware_model,
       @platform AS operating_system,
       user_dim.device_info.platform_version AS operating_system_version,
       user_dim.device_info.device_id AS vendor_id,
       user_dim.device_info.resettable_device_id AS advertising_id,
       user_dim.device_info.user_default_language AS language,
       user_dim.device_info.device_time_zone_offset_seconds AS time_zone_offset_seconds,
       IF(user_dim.device_info.limited_ad_tracking, "Yes", "No") AS is_limited_ad_tracking ) AS device,
     STRUCT( user_dim.app_info.app_id AS id,
       @firebase_app_id  AS firebase_app_id,
       user_dim.app_info.app_version AS version,
       user_dim.app_info.app_store AS install_source ) AS app_info,
     (
     SELECT
       ARRAY_AGG(STRUCT(user_property.key AS key,
           STRUCT(user_property.value.value.string_value AS string_value,
             user_property.value.value.int_value AS int_value,
             user_property.value.value.double_value AS double_value,
             user_property.value.value.float_value AS float_value,
             user_property.value.set_timestamp_usec AS set_timestamp_micros ) AS value))
     FROM
       UNNEST(user_dim.user_properties) AS user_property) AS user_properties
   FROM
     `SCRIPT_GENERATED_TABLE_NAME`,
     UNNEST(event_dim) AS event
     

4. פותחים מעטפת חדשה ומעתיקים את סקריפט ה-Bash שמוצג בהמשך לקובץ בשם migration.sh:
   1. שולחים את הפקודה cat > migration.sh
   2. מעתיקים את הסקריפט שמוצג למטה ומדביקים אותו במעטפת.
   3. לוחצים על Ctrl+D כדי לשמור ולצאת.
   מוסיפים לסקריפט הבא את מזהה הנכס ב-Analytics, מזהה הפרויקט ב-BigQuery, מזהה האפליקציה ב-Firebase, שם מערך הנתונים ב-BigQuery ותאריכי ההתחלה והסיום של הנתונים הרצויים.
   הסקריפט (migration.sh):

   ‫# מזהה הנכס של הפרויקט ב-Analytics. המזהה נמצא בהגדרות Analytics ב-Firebase.
   ‫PROPERTY_ID=מזהה הנכס שלכם ב-Analytics
   
   # פרויקט BigQuery Export.
   BQ_PROJECT_ID="מזהה פרויקט BigQuery שלכם" (למשל, "firebase-public-project")
   
   # מזהה האפליקציה ב-Firebase.
   FIREBASE_APP_ID="מזהה האפליקציה ב-Firebase‏" (למשל, ‎"1:300830567303:iOS:09b1ab1d3ca29bda")
   
   # מערך הנתונים שברצונכם לייבא ממנו.
   BQ_DATASET="שם מערך הנתונים ב-BigQuery שברצונכם לייבא ממנו" (למשל, "com_firebase_demo_IOS")
   
   # פלטפורמה
   ‫PLATFORM="הפלטפורמה של האפליקציה. ANDROID או IOS"
   
   # טווח התאריכים הרצוי של ההעברה, [START_DATE,END_DATE], כולל.
   START_DATE=20180324
   END_DATE=20180327
   
   # מומלץ לא לשנות את קטע הסקריפט הבא, אלא אם יש לכם ניסיון ואתם יודעים מה אתם עושים:)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # איטרציה על התאריכים.
   DATE="$startdate"
   while ‎[ "$DATE" -le "$enddate" ]; do
   
           # טבלת BQ שנבנתה לפי הפרמטרים שמצוינים למעלה.
           BQ_TABLE="$BQ_PROJECT_ID.$BQ_DATASET.app_events_$DATE"
   
           echo "Migrating $BQ_TABLE"
   
           cat migration_script.sql | sed -e "s/SCRIPT_GENERATED_TABLE_NAME/$BQ_TABLE/g" | bq query \
           --debug_mode \
           --allow_large_results \
           --noflatten_results \
           --use_legacy_sql=False \
           --destination_table analytics_$PROPERTY_ID.events_$DATE \
           --batch \
           --append_table \
           --parameter=firebase_app_id::$FIREBASE_APP_ID \
           --parameter=date::$DATE \
           --parameter=platform::$PLATFORM \
           --project_id=$BQ_PROJECT_ID
   
   
           temp=$(date -I -d "$DATE + 1 day")
           DATE=$(date -d "$temp" +%Y%m%d)
   
   done
   exit
   
   # סוף הסקריפט
   
   

5. פותחים מעטפת חדשה ומריצים את הפקודה bash migration.sh

user_dim

event_dim