[GA4] Giản đồ BigQuery Export

event_params RECORD

BẢN GHI item_params

các trường privacy_info

user_properties RECORD

BẢN GHI user_ltv

BẢN GHI item_params

Nếu đã sử dụng một trong hai phiên bản SDK cũ và dự định nâng cấp lên Android 17.2.5 trở lên và/hoặc iOS 16.20.0 trở lên, thì bạn nên lưu ý những điều sau:

• Để sử dụng giản đồ BigQuery Export hiện tại, bạn phải nâng cấp SDK lên Android 17.2.5 trở lên và/hoặc iOS 16.20.0 trở lên. Khi bạn sử dụng các phiên bản SDK trước đó, dữ liệu được xuất sẽ phản ánh giản đồ cũ.
• Kể từ thời điểm nâng cấp trở đi, bạn chỉ có thể truy cập vào dữ liệu mặt hàng trong các mảng items lặp lại; dữ liệu mặt hàng sẽ không còn nằm trong các tham số sự kiện chuẩn vì dữ liệu đó đã có trước các phiên bản SDK này.
• Chúng tôi thực hiện thay đổi này để hỗ trợ bạn phân tích nhiều sản phẩm.
• Do đó, bạn có thể sẽ phải điều chỉnh các tệp tham chiếu đến dữ liệu mặt hàng/sản phẩm.

1. Đăng nhập vào trang Bảng điều khiển Cloud Platform >: Tài nguyên người quản lý.
2. Mở dự án có dữ liệu mà bạn muốn di chuyển rồi nhấp vào Kích hoạt Google Cloud Shell ở đầu trang.
3. Khi màn hình shell mở ra, hãy sao chép tập lệnh bên dưới vào tệp có tên là migration_script.sql:
   1. Gõ lệnh cat > migration_script.sql
   2. Sao chép và dán tập lệnh bên dưới vào màn hình shell.
   3. Nhấn tổ hợp phím Ctrl+D để lưu và thoát.
   Tập lệnh (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. Mở một màn hình shell mới rồi sao chép tập lệnh bash bên dưới vào tệp có tên là migration.sh:
   1. Gõ lệnh cat > migration.sh
   2. Sao chép và dán tập lệnh bên dưới vào màn hình shell.
   3. Nhấn tổ hợp phím Ctrl+D để lưu và thoát.
   Sửa đổi tập lệnh sau để bao gồm ID tài sản Analytics, ID dự án BigQuery, ID ứng dụng Firebase, tên tập dữ liệu BigQuery, cùng với ngày bắt đầu và ngày kết thúc của dữ liệu mà bạn muốn.
   Tập lệnh (migration.sh):

   # Analytics Property ID for the Project. Find this in Analytics Settings in Firebase.
   PROPERTY_ID=your Analytics property ID
   
   # Bigquery Export Project.
   BQ_PROJECT_ID="your BigQuery Project ID" (e.g., "firebase-public-project")
   
   # Firebase App ID for the app.
   FIREBASE_APP_ID="your Firebase App ID" (e.g., "1:300830567303:ios:09b1ab1d3ca29bda")
   
   # Dataset to import from.
   BQ_DATASET="name of BigQuery dataset you want to import from" (e.g., "com_firebase_demo_IOS")
   
   # Platform
   PLATFORM="platform of the app. ANDROID or IOS"
   
   # Date range for which you want to run migration, [START_DATE,END_DATE] inclusive.
   START_DATE=20180324
   END_DATE=20180327
   
   # Do not modify the script below, unless you know what you are doing :)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # Iterate through the dates.
   DATE="$startdate"
   while [ "$DATE" -le "$enddate" ]; do
   
           # BQ table constructed from above params.
           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
   
   # END OF SCRIPT
   
   

5. Mở một màn hình shell mới và thêm lệnh bash migration.sh

user_dim

event_dim