[GA4] Esquema do BigQuery Export

event_params RECORD

item_params RECORD

Campos privacy_info

user_properties RECORD

user_ltv RECORD

item_params RECORD

Se você usou versões anteriores de algum SDK e planeja fazer upgrade para o Android 17.2.5 e/ou iOS 16.20.0 (ou mais recente), considere o seguinte:

• Para usar o esquema atual do BigQuery Export, faça upgrade do seu SDK para o Android 17.2.5 e/ou o iOS 16.20.0 (ou posteriores). Ao usar versões anteriores do SDK, os dados exportados vão refletir o esquema antigo.
• Após o upgrade, você só poderá acessar os dados do item dentro da matriz de itens repetidos. Esses dados não estarão mais disponíveis nos parâmetros de evento padrão, como estavam antes dessas versões do SDK.
• Essa alteração foi feita para ajudar na análise de vários produtos.
• Como resultado, talvez seja necessário ajustar suas referências aos dados do item/produto.

1. Faça login no Console do Cloud Platform > página "Gerenciar recursos".
2. Abra o projeto cujos dados você quer migrar e clique em Ativar o Google Cloud Shell na parte de cima da página.
3. Quando o shell for aberto, copie o script abaixo em um arquivo chamado migration_script.sql:
   1. Execute o comando cat > migration_script.sql.
   2. Copie e cole o script abaixo no shell.
   3. Pressione Ctrl + D para salvar e sair.
   Script (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. Abra um novo shell e cole o script bash abaixo em um arquivo chamado migration.sh:
   1. Execute o comando cat > migration.sh.
   2. Copie e cole o script abaixo no shell.
   3. Pressione Ctrl + D para salvar e sair.
   Modifique o script a seguir para incluir o código da propriedade do Google Analytics, o código do projeto do BigQuery, o código do aplicativo do Firebase, o nome do conjunto de dados do BigQuery e as datas de início e término das informações desejadas.
   Script (migration.sh):

   # Código da propriedade do Google Analytics associado ao projeto. Pode ser encontrado nas configurações do Google Analytics no Firebase.
   PROPERTY_ID = código da sua propriedade do Google Analytics
   
   # Projeto do BigQuery Export.
   BQ_PROJECT_ID="ID do seu projeto do BigQuery" (por exemplo, "firebase-public-project")
   
   # Código do aplicativo do Firebase.
   FIREBASE_APP_ID="seu código do aplicativo do Firebase" (por exemplo, "1:300830567303:ios:09b1ab1d3ca29bda")
   
   # Conjunto de dados que será usado para a importação.
   BQ_DATASET="nome do conjunto de dados do BigQuery que você quer usar para importação" (por exemplo,  "com_firebase_demo_IOS")
   
   # Plataforma
   PLATFORM="plataforma do aplicativo. ANDROID ou IOS"
   
   # Período em que você executará a migração, incluindo [START_DATE,END_DATE].
   START_DATE=20180324
   END_DATE=20180327
   
   # Não modifique o script abaixo, a menos que você saiba o que está fazendo :)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # Faça testes com as datas.
   DATE="$startdate"
   while [ "$DATE" -le "$enddate" ]; do
   
           # Tabela do BigQuery criada a partir dos parâmetros acima.
           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
   
   # FIM DO SCRIPT
   
   

5. Abra um novo shell e execute o comando bash migration.sh.

user_dim

event_dim