[GA4] Schéma de BigQuery Export

event_params RECORD

item_params RECORD

Champs "privacy_info"

user_properties RECORD

user_ltv RECORD

item_params RECORD

Si vous avez utilisé des versions antérieures du SDK et envisagez de passer à Android 17.2.5 (ou version ultérieure) et/ou à iOS 16.20.0 (ou version ultérieure), vous devez tenir compte des points suivants :

• Pour utiliser le schéma actuel de BigQuery Export, vous devez mettre à jour votre SDK vers Android 17.2.5 (ou version ultérieure) et/ou iOS 16.20.0 (ou version ultérieure). Lorsque vous utilisez des versions antérieures du SDK, les données exportées reflètent l'ancien schéma. 
• Après la mise à jour, vous ne pourrez accéder aux données sur les articles que dans le tableau des articles répétés. Ces données ne seront plus disponibles dans les paramètres d'événement standards, comme dans les versions précédentes du SDK.
• Cette modification permet d'analyser plusieurs produits.
• Vous devrez peut-être ajuster vos références aux données produit/article.

1. Connectez-vous à la page "Gérer les ressources" de la console Cloud Platform.
2. Ouvrez le projet dont vous souhaitez migrer les données, puis cliquez sur Activer Google Cloud Shell en haut de la page.
3. Lorsque l'interface système s'ouvre, copiez le script ci-dessous dans un fichier nommé migration_script.sql :
   1. Exécutez la commande cat > migration_script.sql.
   2. Copiez et collez le script ci-dessous dans l'interface système.
   3. Appuyez sur Ctrl+D pour enregistrer et quitter.
   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. Ouvrez une nouvelle interface système et copiez le script bash ci-dessous dans un fichier nommé migration.sh :
   1. Exécutez la commande cat > migration.sh.
   2. Copiez et collez le script ci-dessous dans l'interface système.
   3. Appuyez sur Ctrl+D pour enregistrer et quitter.
   Modifiez le script suivant afin d'inclure l'ID de propriété Analytics, l'ID du projet BigQuery, l'ID de l'application Firebase, le nom de l'ensemble de données BigQuery, et les dates de début et de fin des données souhaitées.
   Script (migration.sh):

   # ID de propriété Analytics pour le projet. Vous trouverez cette valeur dans les paramètres Analytics de Firebase.
   PROPERTY_ID=votre ID de propriété Analytics
   
   # Projet BigQuery Export.
   BQ_PROJECT_ID="votre ID de projet BigQuery" (par exemple, "firebase-public-project")
   
   # ID de l'application Firebase.
   FIREBASE_APP_ID="votre ID d'application Firebase" (par exemple, "1:300830567303:ios:09b1ab1d3ca29bda")
   
   # Ensemble de données à partir duquel effectuer l'importation.
   BQ_DATASET="nom de l'ensemble de données BigQuery à partir duquel vous souhaitez effectuer l'importation" (par exemple, "com_firebase_demo_IOS")
   
   # Plate-forme
   PLATFORM="plate-forme de l'application ANDROID ou IOS"
   
   # Plage de dates concernée par la migration, [START_DATE,END_DATE] incluses.
   START_DATE=20180324
   END_DATE=20180327
   
   # Ne modifiez pas le script ci-dessous, sauf si vous savez ce que vous faites :)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # Répétez pour toutes les dates.
   DATE="$startdate"
   while [ "$DATE" -le "$enddate" ]; do
   
           # Tableau BQ construit à partir des paramètres ci-dessus.
           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
   
   # FIN DU SCRIPT
   
   

5. Ouvrez une nouvelle interface système et exécutez la commande bash migration.sh.

user_dim

event_dim