[GA4] Schemat BigQuery Export

REKORD event_params

Rekord item_params

Pola privacy_info

REKORD user_properties

Rekord user_ltv

Rekord item_params

Jeśli używasz starszych wersji pakietu SDK i planujesz jego uaktualnienie na Androidzie do wersji 17.2.5 (lub nowszej) lub na iOS do wersji 16.20.0 (lub nowszej), pamiętaj o tych kwestiach:

• Aby korzystać z bieżącego schematu BigQuery Export, musisz uaktualnić swój pakiet SDK na Androida do wersji 17.2.5 (lub nowszej) lub na iOS do wersji 16.20.0 (lub nowszej). Jeśli używasz starszych wersji pakietu SDK, wyeksportowane dane będą zgodne ze starym schematem.
• Po uaktualnieniu będziesz mieć dostęp do danych produktów tylko w tablicy powtórzonych produktów. Dane produktów nie będą już dostępne w standardowych parametrach zdarzeń, jak miało to miejsce w przypadku starszych wersji pakietu SDK.
• Ta zmiana została wprowadzona, by umożliwić analizę wielu produktów.
• Dlatego może być konieczne dostosowanie odwołań do danych o produktach.

1. Zaloguj się na stronie konsoli Cloud Platform > Zarządzaj zasobami.
2. Otwórz projekt, którego dane chcesz przenieść, i u góry strony kliknij Aktywuj Google Cloud Shell.
3. Gdy powłoka się otworzy, skopiuj ten skrypt do pliku migration_script.sql:
   1. Wykonaj polecenie cat > migration_script.sql
   2. Skopiuj poniższy skrypt i wklej go do powłoki.
   3. Aby zapisać zmiany i zamknąć powłokę, naciśnij Ctrl+D.
   Skrypt (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. Otwórz nową powłokę i skopiuj ten skrypt do pliku migration.sh:
   1. Wykonaj polecenie cat > migration.sh
   2. Skopiuj poniższy skrypt i wklej go do powłoki.
   3. Naciśnij Ctrl+D, by zapisać zmiany i zamknąć powłokę.
   Zmodyfikuj widoczny poniżej skrypt, aby uwzględnić identyfikator usługi Analytics, identyfikator projektu BigQuery, identyfikator aplikacji Firebase, nazwę zbioru danych BigQuery oraz daty rozpoczęcia i zakończenia okresu, w którego przypadku chcesz uruchomić migrację danych.
   Skrypt (migration.sh):

   # Identyfikator usługi Analytics dla projektu. Znajdziesz go w Ustawieniach Analytics w Firebase.
   PROPERTY_ID=identyfikator Twojej usługi Analytics
   
   # Eksportowany projekt BigQuery.
   BQ_PROJECT_ID="identyfikator Twojego projektu BigQuery" (np. "firebase-public-project")
   
   # Identyfikator Firebase danej aplikacji.
   FIREBASE_APP_ID="identyfikator Firebase Twojej aplikacji" (np. "1:300830567303:ios:09b1ab1d3ca29bda")
   
   # Zbiór danych, z którego importujesz informacje.
   BQ_DATASET="nazwa zestawu BigQuery, z którego chcesz importować dane" (np. "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
   
   # Nie zmieniaj poniższego skryptu, jeśli nie masz odpowiednich kwalifikacji :)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # Powtarzaj dla kolejnych dat.
   DATE="$startdate"
   while [ "$DATE" -le "$enddate" ]; do
   
           # Tabela BQ stworzona z powyższych parametrów.
           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
   
   # KONIEC SKRYPTU
   
   

5. Otwórz nową powłokę i wykonaj polecenie bash migration.sh

user_dim

event_dim