[GA4] BigQuery Export स्कीमा

event_params RECORD

item_params RECORD

privacy_info fields

user_properties RECORD

user_ltv RECORD

item_params RECORD

अगर आपने SDK टूल के किसी भी पुराने वर्शन का इस्तेमाल किया है और Android 17.2.5 (या बाद के वर्शन) और/या iOS 16.20.0 (या बाद के वर्शन) पर अपडेट करने की योजना बनाई है, तो आपको इन बातों का ध्यान रखना होगा:

• मौजूदा BigQuery Export स्कीमा का इस्तेमाल करने के लिए, आपको अपने एसडीके को Android 17.2.5 (या बाद के वर्शन) और/या iOS 16.20.0 (या बाद के वर्शन) पर अपग्रेड करना होगा. एसडीके के पुराने वर्शन का इस्तेमाल करने पर, एक्सपोर्ट किया गया डेटा पुराने स्कीमा में दिखेगा.
• अपग्रेड करने के दौरान और उसके बाद, सिर्फ़ दोहराए गए आइटम के कलेक्शन में मौजूद आइटम का डेटा ऐक्सेस किया जा सकेगा. साथ ही, स्टैंडर्ड इवेंट पैरामीटर में आइटम का डेटा उपलब्ध नहीं होगा. हालांकि, एसडीके के पुराने वर्शन में यह डेटा उपलब्ध होता था.
• यह बदलाव एक से ज़्यादा प्रॉडक्ट के विश्लेषण में सहायता के लिए किया गया था.
• आपको आइटम/प्रॉडक्ट डेटा के हिसाब से, इनसे जुड़ी चीज़ों में बदलाव करना पड़ सकता है.

1. Cloud Platform कंसोल >: मैनेजर के लिए संसाधन पेज पर लॉग इन करें.
2. वह प्रोजेक्ट खोलें जिसका डेटा माइग्रेट करना है. इसके बाद, पेज पर सबसे ऊपर Google Cloud शेल चालू करें पर क्लिक करें.
3. शेल खुलने के बाद, नीचे दी गई स्क्रिप्ट को migration_script.sql नाम वाली फ़ाइल में कॉपी करें:
   1. cat > migration_script.sql निर्देश दें
   2. नीचे दी गई स्क्रिप्ट को कॉपी करें और शेल में चिपकाएं.
   3. सेव करके बाहर निकलने के लिए Ctrl+D दबाएं.
   स्क्रिप्ट (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. नया शेल खोलें. इसके बाद, नीचे दी गई बैश स्क्रिप्ट को migration.sh नाम की फ़ाइल में कॉपी करें:
   1. cat > migration.sh निर्देश दें
   2. नीचे दी गई स्क्रिप्ट को कॉपी करें और शेल में चिपकाएं.
   3. सेव करके बाहर निकलने के लिए Ctrl+D दबाएं.
   Analytics प्रॉपर्टी आईडी, BigQuery प्रोजेक्ट आईडी, Firebase ऐप्लिकेशन आईडी, BigQuery डेटासेट का नाम, और जो डेटा आपको चाहिए उसके शुरू और खत्म होने की तारीख शामिल करने के लिए, नीचे दी गई स्क्रिप्ट में बदलाव करें.
   स्क्रिप्ट (migration.sh):

   प्रोजेक्ट के लिए # Analytics प्रॉपर्टी आईडी. यह Firebase की Analytics सेटिंग में मिलेगा.
   PROPERTY_ID="आपकी Analytics प्रॉपर्टी का आईडी"
   # BigQuery Export का प्रोजेक्ट.
   BQ_PROJECT_ID="आपके BigQuery प्रोजेक्ट का आईडी" (उदाहरण, "firebase-public-project")
   
   # ऐप्लिकेशन का Firebase ऐप्लिकेशन आईडी.
   FIREBASE_APP_ID="आपका Firebase ऐप्लिकेशन आईडी" (उदाहरण, "1:300830567303:iOS:09b1ab1d3ca29bda")
   
   # वह डेटासेट जिससे इंपोर्ट करना है.
   BQ_DATASET="उस BigQuery डेटासेट का नाम जिससे आपको इंपोर्ट करना है" (उदाहरण, "com_firebase_demo_IOS")
   
   # Platform
   PLATFORM="ऐप्लिकेशन का प्लैटफ़ॉर्म. ANDROID या IOS"
   
   # तारीख की वह सीमा जिसके लिए माइग्रेशन चलाना है, [START_DATE,END_DATE] के साथ.
   START_DATE=20180324
   END_DATE=20180327
   
   # नीचे दी गई स्क्रिप्ट में तब तक बदलाव न करें, जब तक आपको इसकी पक्की जानकारी न हो :)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # तारीखों के बीच दोहराएं.
   DATE="$startdate"
   while [ "$DATE" -le "$enddate" ]; do
   
           # BQ टेबल, जो ऊपर दिए गए पैरामीटर से बनाई गई है.
           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. एक नया शेल खोलें और bash migration.sh निर्देश दें

user_dim

event_dim