[إحصاءات Google‏ 4] مخطّط BigQuery Export

event_params RECORD

item_params RECORD

حقول privacy_info

user_properties RECORD

user_ltv RECORD

item_params RECORD

إذا كنت تستخدِم إصدارات سابقة من إحدى حزمَتي تطوير البرامج (SDK) وكنت تخطّط للترقية إلى الإصدار 17.2.5 (أو إصدار أحدث) من Android و/أو الإصدار 16.20.0 (أو إصدار أحدث) من iOS، عليك مراعاة ما يلي:

• لاستخدام مخطّط BigQuery Export الحالي، يجب ترقية حزمة تطوير البرامج إلى الإصدار 17.2.5 (أو إصدار أحدث) لنظام التشغيل Android و/أو الإصدار 16.20.0 (أو إصدار أحدث) لنظام التشغيل iOS. وعند استخدام إصدارات سابقة من حزمة تطوير البرامج، ستشير البيانات التي يتمّ تصديرها إلى المخطّط القديم.
• عند إجراء الترقية وبعد ذلك، لن تتمكّن من الوصول إلى بيانات السلع إلّا داخل مصفوفة السلع المتكرّرة، ولن تكون هذه البيانات متوفّرة في مَعلمات الأحداث العادية كما كان الحال قبل هذه الإصدارات من حزمة تطوير البرامج.
• تم إجراء هذا التغيير للسماح بتحليل منتجات متعددة.
• قد تحتاج إلى تعديل الإشارات المرجعية إلى بيانات السلع/المنتجات نتيجةً لذلك.

1. سجِّل الدخول إلى صفحة Cloud Platform Console >: مراجع للمدراء.
2. افتح المشروع الذي تريد نقل بياناته، وانقر على تفعيل Google Cloud Shell في أعلى الصفحة.
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. افتح وحدة تحكُّم جديدة، وانسِخ النصّ البرمجي bash أدناه إلى الملفّ باسم migration.sh:
   1. أدخِل الأمر cat > migration.sh.
   2. انسخ النص البرمجي أدناه والصقه في وحدة التحكّم.
   3. اضغط على Ctrl+D للحفظ والخروج.
   يمكنك تعديل النصّ البرمجي التالي ليتضمّن معرّف موقع "إحصاءات Google"، ورقم تعريف مشروع BigQuery، ومعرّف التطبيق في Firebase، واسم مجموعة بيانات BigQuery، وتاريخَي البدء والانتهاء للبيانات التي تريدها.
   النصّ البرمجي (migration.sh):

   # Analytics Property ID for the Project. Find this in Analytics Settings in Firebase.
   PROPERTY_ID=your Analytics property ID
   
   # Bigquery Export Project.
   BQ_PROJECT_ID="your BigQuery Project ID" (e.g., "firebase-public-project")
   
   
   # Firebase App ID for the app.
   FIREBASE_APP_ID="your Firebase App ID" (e.g., "1:300830567303:ios:09b1ab1d3ca29bda")
   
   # Dataset to import from.
   BQ_DATASET="name of BigQuery dataset you want to import from" (e.g., "com_firebase_demo_IOS")
   
   # Platform
   PLATFORM="platform of the app. ANDROID or IOS"
   
   # Date range for which you want to run migration, [START_DATE,END_DATE] inclusive.
   START_DATE=20180324
   END_DATE=20180327
   
   # Do not modify the script below, unless you know what you are doing :)
   startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
   enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1
   
   # Iterate through the dates.
   DATE="$startdate"
   while [ "$DATE" -le "$enddate" ]; do
   
           # BQ table constructed from above params.
           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