[GA4] Schema di BigQuery Export

RECORD event_params

RECORD item_params

campi privacy_info

RECORD user_properties

RECORD user_ltv

RECORD item_params

Se hai utilizzato versioni precedenti di uno degli SDK e prevedi di eseguire l'upgrade ad Android 17.2.5 (o versioni successive) e/o a iOS 16.20.0 (o versioni successive), tieni presente quanto segue:

• Per utilizzare lo schema di BigQuery Export attuale, devi eseguire l'upgrade del tuo SDK ad Android 17.2.5 o versioni successive e/o a iOS 16.20.0 o versioni successive. Se utilizzi versioni precedenti dell'SDK, i dati esportati riflettono lo schema precedente.
• Dal momento dell'upgrade in poi, potrai accedere ai dati degli articoli solo nell'array di articoli ripetuti. Diversamente da quanto accadeva nelle versioni precedenti degli SDK, questi dati non saranno più disponibili nei parametri evento standard.
• Questa modifica è stata apportata per supportare l'analisi di più prodotti.
• Di conseguenza, potresti dover modificare i riferimenti ai dati degli articoli/di prodotto.

1. Accedi alla pagina Gestisci risorse nella console di Cloud Platform.
2. Apri il progetto per cui vuoi eseguire la migrazione dei dati e fai clic su Attiva Google Cloud Shell nella parte superiore della pagina.
3. Quando si apre la shell, copia lo script riportato di seguito in un file denominato migration_script.sql:
   1. Esegui il comando cat > migration_script.sql
   2. Copia e incolla nella shell lo script indicato di seguito.
   3. Premi Ctrl+D per salvare e uscire.
   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. Apri una nuova shell e copia lo script Bash riportato di seguito in un file denominato migration.sh:
   1. Esegui il comando cat > migration.sh
   2. Copia e incolla nella shell lo script indicato di seguito.
   3. Premi Ctrl+D per salvare e uscire.
   Modifica il seguente script in modo che includa l'ID proprietà Analytics, l'ID progetto BigQuery, l'ID app Firebase, il nome del set di dati BigQuery e le date di inizio e fine dei dati che ti interessano.
   Script (migration.sh):

   # ID proprietà Analytics del progetto. Si trova nelle impostazioni di Analytics in Firebase.
   PROPERTY_ID=ID proprietà Analytics
   
   # Progetto di esportazione Big Query.
   BQ_PROJECT_ID="ID del progetto BigQuery" (ad esempio "firebase-public-project")
   
   # ID dell'app Firebase.
   FIREBASE_APP_ID="ll tuo ID dell'app Firebase" (ad es. "1:300830567303:ios:09b1ab1d3ca29bda")
   
   # Set di dati da cui eseguire l'importazione.
   BQ_DATASET="nome del set di dati BigQuery da cui eseguire l'importazione" (ad esempio "com_firebase_demo_IOS")
   
   # Piattaforma
   PLATFORM="piattaforma dell'app. ANDROID o IOS"
   
   # Intervallo di date per il quale eseguire la migrazione, inclusi i giorni [START_DATE,END_DATE].
   START_DATE=20180324
   END_DATE=20180327
   
   # Non modificare lo script seguente, a meno che tu non sappia esattamente cosa fare :)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # Ripetizione durante le date.
   DATE="$startdate"
   while [ "$DATE" -le "$enddate" ]; do
   
           # Tabella BQ creata dai parametri in alto.
           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. Apri una nuova shell ed esegui il comando bash migration.sh

user_dim

event_dim