[GA4] BigQuery Export şeması

Veri türü KAYIT olan event_params

Veri türü KAYIT olan item_params

privacy_info alanları

Veri türü KAYIT olan user_properties

Veri türü KAYIT olan user_ltv

Veri türü KAYIT olan item_params

SDK'ların önceki sürümlerini kullandıysanız ve Android 17.2.5 (ya da üzeri) ve/veya iOS 16.20.0 (ya da üzeri) sürümüne geçmeyi planlıyorsanız aşağıdakileri göz önünde bulundurmalısınız:

• Güncel BigQuery Export şemasını kullanmak için SDK'nızı Android 17.2.5 (ya da üzeri) ve/veya iOS 16.20.0 (ya da üzeri) sürümüne yükseltmeniz gerekir. Önceki SDK sürümleri kullanıldığında, dışa aktarılan veriler eski şemayı yansıtır.
• Yeni sürüme geçildikten sonra yalnızca tekrarlanan öğe dizisindeki ürün verilerine erişebilirsiniz. Ürün verileri bu SDK sürümlerinden öncesine ait olduğu için artık standart etkinlik parametrelerinde kullanılamaz.
• Bu değişiklik, birden çok ürün analizini desteklemek için yapılmıştır.
• Sonuç olarak, öğe/ürün verilerinizle ilgili referanslarınızı düzenlemeniz gerekebilir.

1. Cloud Platform Console >: Yönetici kaynakları sayfasına giriş yapın.
2. Verilerini taşımak istediğiniz projeyi açın ve sayfanın üst kısmındaki Google Cloud Shell'i etkinleştir'i tıklayın.
3. Kabuk açıldığında aşağıdaki komutları migration_script.sql adlı bir dosyaya kopyalayın:
   1. cat > migration_script.sql komutunu verin.
   2. Aşağıdaki komut dosyasını kopyalayıp kabuğa yapıştırın.
   3. Kaydedip çıkmak için Ctrl+D tuşlarına basın.
   Komut dosyası (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. Yeni bir kabuk açın ve aşağıdaki bash komutlarını migration.sh adlı bir dosyaya kopyalayın:
   1. cat > migration.sh komutunu verin.
   2. Aşağıdaki komut dosyasını kopyalayıp kabuğa yapıştırın.
   3. Kaydedip çıkmak için Ctrl+D tuşlarına basın.
   Analytics mülk kimliğinizi, BigQuery proje kimliğinizi, Firebase uygulama kimliğinizi, BigQuery veri kümesinin adını ve istediğiniz verilerin başlangıç ve bitiş tarihlerini eklemek için aşağıdaki komut dosyasını değiştirin.
   Komut dosyası (migration.sh):

   # Projenin Analytics Mülk Kimliği. Bunu Firebase'deki Analytics Ayarlarında bulabilirsiniz.
   PROPERTY_ID=Analytics mülk kimliğiniz
   
   # BigQuery Export Projesi.
   BQ_PROJECT_ID="BigQuery Projenizin Kimliği" (ör. "firebase-public-project")
   
   # Uygulamanızın Firebase Uygulama Kimliği.
   FIREBASE_APP_ID="Firebase Uygulama Kimliğiniz" (ör. "1:300830567303:ios:09b1ab1d3ca29bda")
   
   # İçe aktarma işleminin yapılacağı veri kümesi.
   BQ_DATASET="içe aktarma işlemini yapacağınız BigQuery veri kümesinin adı" (ör. "com_firebase_demo_IOS")
   
   # Platform
   PLATFORM="uygulamanın platformu. ANDROID veya IOS"
   
   # Taşımayı çalıştıracağınız veri aralığı, [START_DATE,END_DATE] tarihleri dahildir.
   START_DATE=20180324
   END_DATE=20180327
   
   # Yeterince bilgi sahibi değilseniz aşağıdaki komut dosyasını değiştirmeyin:)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # Tarihleri sırayla tarayın.
   DATE="$startdate"
   while [ "$DATE" -le "$enddate" ]; do
   
           # Yukarıdaki parametrelerden oluşturulan BQ tablosu.
           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
   
   # KOMUT DOSYASI SONU
   
   

5. Yeni bir kabuk açın ve bash migration.sh komutunu verin

user_dim

event_dim