[GA4] สคีมา BigQuery Export

RECORD event_params

RECORD item_params

ช่อง privacy_info

RECORD user_properties

RECORD user_ltv

RECORD 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 >: จัดการทรัพยากร
2. เปิดโปรเจ็กต์ที่มีข้อมูลที่ต้องการย้ายแล้วคลิกเปิดใช้งาน Google Cloud Shell ที่ด้านบนของหน้า
3. เมื่อเปิด Shell แล้ว ให้คัดลอกสคริปต์ด้านล่างไปยังไฟล์ชื่อ migration_script.sql ดังนี้
   1. ออกคำสั่ง cat > migration_script.sql
   2. คัดลอกสคริปต์ด้านล่างและวางลงใน Shell
   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. เปิด Shell ใหม่และคัดลอกสคริปต์ Bash ด้านล่างไปยังไฟล์ชื่อ migration.sh ดังนี้
   1. ออกคำสั่ง cat > migration.sh
   2. คัดลอกสคริปต์ด้านล่างและวางลงใน Shell
   3. กด Ctrl+D เพื่อบันทึกและออก
   แก้ไขสคริปต์ต่อไปนี้เพื่อรวมรหัสพร็อพเพอร์ตี้ Analytics, รหัสโครงการ BigQuery, รหัสแอป Firebase, ชื่อชุดข้อมูล BigQuery รวมถึงวันที่เริ่มต้นและวันที่สิ้นสุดของข้อมูลที่คุณต้องการ
   Script (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. เปิด Shell ใหม่และออกคำสั่ง bash migration.sh

user_dim

event_dim