توضّح هذه المقالة تنسيق ومخطّط بيانات موقع "إحصاءات Google 4" وبيانات "إحصاءات Google لبرنامج Firebase" التي يتمّ تصديرها إلى BigQuery.
مجموعات البيانات
تتمّ إضافة مجموعة بيانات واحدة باسم "analytics_<property_id>" إلى مشروعك على BigQuery، وذلك لكلّ موقع على "إحصاءات Google 4" وكلّ مشروع على Firebase مرتبط بأداة BigQuery. ويشير "رقم تعريف الموقع" إلى رقم تعريف موقع "إحصاءات Google" الذي يمكن العثور عليه في إعدادات موقع "إحصاءات Google 4"، وفي إعدادات "إحصاءات التطبيقات" في Firebase. وسيتمّ تصدير بيانات كلّ موقع على "إحصاءات Google 4" وكلّ تطبيق تمّ تفعيل ميزة تصدير BigQuery فيه إلى مجموعة البيانات الواحدة هذه.
الجداول
ضمن كلّ مجموعة بيانات، يتمّ إنشاء جدول باسم events_YYYYMMDD كلّ يوم في حال تفعيل خيار "التصدير اليومي".
في حال تفعيل الخيار "تصدير متواصل"، يتمّ إنشاء جدول باسم events_intraday_YYYYMMDD. وتتمّ تعبئة هذا الجدول باستمرار أثناء تسجيل الأحداث على مدار اليوم. ويتم حذف هذا الجدول في نهاية كل يوم بعد اكتمال events_YYYYMMDD.
يُرجى العلم أنّ بعض الأجهزة التي تبدأ عليها الأحداث لا تُرسِل بياناتها إلى "إحصاءات Google" في اليوم نفسه الذي تبدأ فيه الأحداث. ولاحتساب وقت الاستجابة هذا، ستُعدِّل "إحصاءات Google" الجداول اليومية (events_YYYYMMDD) بأحداث تلك التواريخ لمدة تصل إلى ثلاثة أيام بعد تواريخ الأحداث. سيكون للأحداث الطابع الزمني الصحيح بغض النظر عن وصولها متأخرة. ولا يتم تسجيل الأحداث التي تصل بعد هذه الفترة البالغة ثلاثة أيام.
إذا كنت تستخدم وضع الحماية في BigQuery، لن يتم استيراد الأحداث خلال اليوم الواحد، وسيتم تطبيق حدود إضافية.
بمكنك الترقية من وضع الحماية إذا كنت تريد عمليات استيراد خلال اليوم. الواحد.
الأعمدة
يمثّل كلّ عمود في الجدول events_YYYYMMDD مَعلمة متعلّقة بالحدث. تجدر الإشارة إلى أنّه يتمّ دمج بعض المَعلمات ضمن RECORDS، ويمكن تكرار بعض RECORDS، مثل items وevent_params. وقد تمّ توضيح أعمدة الجدول في ما يلي.
event
| تحتوي حقول event على معلومات تُحدِّد الأحداث بشكلٍ فريد. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| batch_event_index | عدد صحيح | رقم يشير إلى الترتيب التسلسلي لكلّ حدث ضمن مجموعة استنادًا إلى ترتيب حدوثه على الجهاز. |
| batch_ordering_id | عدد صحيح | عدد يتزايد بشكلٍ منتظم في كلّ مرّة يتمّ فيها إرسال طلب شبكة من صفحة معيّنة. |
| batch_page_id | عدد صحيح | رقم تسلسلي تمّ تعيينه لصفحة معيّنة، ويزداد مع كلّ صفحة لاحقة ضمن تفاعل معيّن. |
| event_date | سلسلة | تاريخ تسجيل الحدث (التنسيق YYYYMMDD في المنطقة الزمنية المسجَّلة في تطبيقك) |
| event_timestamp | عدد صحيح | وقت تسجيل الحدث في البرنامج (بالميكرو ثانية، التوقيت العالمي المنسّق) |
| event_previous_timestamp | عدد صحيح | وقت تسجيل الحدث في البرنامج في وقت سابق (بالميكرو ثانية، حسب التوقيت العالمي المنسّق) |
| event_name | سلسلة | اسم الحدث |
| event_value_in_usd | قيمة عائمة | قيمة تحويل مَعلمة "value" التي تخصّ الحدث إلى عملة (بالدولار الأمريكي). |
| event_bundle_sequence_id | عدد صحيح | المعرّف التسلسلي للحزمة التي تمّ تحميل هذه الأحداث فيها |
| event_server_timestamp_offset | عدد صحيح | الفَرق في الطابع الزمني بين وقت جمع البيانات وتحميلها بالميكرو ثانية |
event_params RECORD
|
يمكن في event_params RECORD تخزين مَعلمات الأحداث على مستوى الحملة والسياق بالإضافة إلى أيّ مَعلمات أحداث من تحديد المستخدِم. ويتمّ تكرار event_params RECORD لكلّ مفتاح مرتبط بحدث. تكون مجموعة المَعلمات المخزَّنة في event_params RECORD فريدةً لكلّ عملية تنفيذ. وللاطّلاع على القائمة الكاملة لمَعلمات الأحداث المتعلّقة بعملية التنفيذ، يمكنك إجراء طلب بحث عن قائمة مَعلمات الأحداث. |
||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| event_params.key | سلسلة | اسم مَعلمة الحدث |
| event_params.value | سجلّ | سجلّ يحتوي على قيمة مَعلمة الحدث |
| event_params.value.string_value | سلسلة | إذا كانت مَعلمة الحدث ممثَّلة بسلسلة، مثل عنوان URL أو اسم الحملة، ستتم تعبئة تلك المَعلمة في هذا الحقل. |
| event_params.value.int_value | عدد صحيح | إذا كانت مَعلمة الحدث ممثَّلة بعدد صحيح، ستتم تعبئتها في هذا الحقل. |
| event_params.value.double_value | قيمة عائمة | إذا كانت مَعلمة الحدث ممثَّلة بقيمة مزدوجة، ستتم تعبئتها في هذا الحقل. |
| event_params.value.float_value | قيمة عائمة | إذا كانت مَعلمة الحدث ممثَّلة بقيمة نقطة عائمة، ستتم تعبئتها في هذا الحقل. هذا الحقل غير مستخدَم حاليًا. |
item_params RECORD
|
يمكن في item_params RECORD تخزين مَعلمات السلع بالإضافة إلى أيّ مَعلمات سلع من تحديد المستخدِم. تكون مجموعة المَعلمات المخزَّنة في item_params RECORD فريدةً لكلّ عملية تنفيذ. |
||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| item_params.key | سلسلة | اسم مَعلمة السلعة |
| item_params.value | سجلّ | سجلّ يحتوي على قيمة معلَمة السلعة |
| item_params.value.string_value | سلسلة | إذا كانت مَعلمة السلعة ممثَّلة بسلسلة، ستتم تعبئتها في هذا الحقل. |
| item_params.value.int_value | عدد صحيح | إذا كانت مَعلمة السلعة ممثَّلة بعدد صحيح، ستتم تعبئتها في هذا الحقل. |
| item_params.value.double_value | قيمة عائمة | إذا كانت مَعلمة السلعة ممثَّلة بقيمة مزدوجة، ستتم تعبئتها في هذا الحقل. |
| item_params.value.float_value | قيمة عائمة | إذا كانت مَعلمة السلعة ممثَّلة بقيمة نقطة عائمة، ستتم تعبئتها في هذا الحقل. |
user
| تحتوي حقول user على معلومات تُحدِّد بشكلٍ فريد المستخدِم المرتبط بالحدث. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| is_active_user | منطقية |
تحدِّد القيمة ما إذا كان المستخدم نشطًا (صحيح) أو غير نشط (خطأ) في أيّ وقت من اليوم التقويمي. يتمّ تضمين القيمة في الجداول اليومية فقط ( |
| user_id | سلسلة | المعرّف الفريد الذي تمّ تعيينه لمستخدِم. |
| user_pseudo_id | سلسلة | رقم التعريف الذي لا ينسِب البيانات لصاحبها (على سبيل المثال، رقم تعريف مثيل التطبيق) للمستخدِم. معرّف فريد يتمّ تعيينه للمستخدِم عندما يفتح التطبيق أو يزور الموقع الإلكتروني للمرّة الأولى. |
| user_first_touch_timestamp | عدد صحيح | وقت فتح المستخدِم للتطبيق أو زيارته للموقع الإلكتروني للمرّة الأولى (بالميكرو ثانية) |
حقول privacy_info
| تحتوي حقول privacy_info على معلومات تستند إلى حالة موافقة المستخدِم عندما يكون وضع الموافقة مفعَّلاً. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| privacy_info.ads_storage | سلسلة |
تحدد هذه القيمة ما إذا كان المستخدِم يريد تفعيل استهداف الإعلانات. القيم المحتملة: نعم، لا، غير مُحدَّد |
| privacy_info.analytics_storage | سلسلة |
يوضّح ما إذا كانت سعة تخزين "إحصاءات Google" مفعّلة للمستخدم. القيم المحتملة: نعم، لا، غير مُحدَّد |
| privacy_info.uses_transient_token | سلسلة |
يوضح ما إذا كان مستخدم الويب قد رفض مساحة تخزين في "إحصاءات Google" وفعَّل المطوّر القياس بدون ملفّات تعريف الارتباط استنادًا إلى الرموز المميزة المؤقّتة في بيانات الخادم. القيم المحتملة: نعم، لا، غير مُحدَّد |
user_properties RECORD
| يحتوي السِجلّ user_properties RECORD على أيّ خصائص مستخدِم أعددتَها. ويتمّ تكراره لكلّ مفتاح مرتبط بمستخدِم. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| user_properties.key | سلسلة | اسم خاصيّة المستخدِم |
| user_properties.value | سجلّ | سِجلّ قيمة خاصيّة المستخدِم. |
| user_properties.value.string_value | سلسلة | قيمة السلسلة لخاصيّة المستخدِم |
| user_properties.value.int_value | عدد صحيح | قيمة العدد الصحيح لخاصيّة المستخدِم. |
| user_properties.value.double_value | قيمة عائمة | القيمة المزدوجة لخاصيّة المستخدِم |
| user_properties.value.float_value | قيمة عائمة | هذا الحقل غير مستخدَم حاليًا. |
| user_properties.value.set_timestamp_micros | عدد صحيح | الوقت (بالميكرو ثانية) عندما تم إعداد خاصيّة المستخدِم للمرّة الأخيرة |
user_ltv RECORD
| يحتوي السِجلّ user_ltv RECORD على معلومات القيمة الدائمة عن المستخدِم. ولا تتمّ تعبئة هذا السِجلّ في الجداول اليومية. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| user_ltv.revenue | قيمة عائمة | القيمة الدائمة (الأرباح) للمستخدِم. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| user_ltv.currency | سلسلة | القيمة الدائمة (العملة) للمستخدِم. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
device
| يحتوي السِجلّ device RECORD على معلومات عن الجهاز الذي نشأ منه الحدث. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| device.category | سلسلة | فئة الجهاز (جهاز جوّال، جهاز لوحي، كمبيوتر مكتبي) |
| device.mobile_brand_name | سلسلة | اسم العلامة التجارية للجهاز |
| device.mobile_model_name | سلسلة | اسم طراز الجهاز |
| device.mobile_marketing_name | سلسلة | الاسم التسويقي للجهاز |
| device.mobile_os_hardware_model | سلسلة | معلومات طراز الجهاز التي يتم استردادها من نظام التشغيل مباشرةً. |
| device.operating_system | سلسلة | نظام تشغيل الجهاز. |
| device.operating_system_version | سلسلة | إصدار نظام التشغيل |
| device.vendor_id | سلسلة | معرّف الجهاز للمورّد (IDFV) (يكون موجودًا فقط في حال عدم جمع معرّف الجهاز للمعلنين (IDFA)). |
| device.advertising_id | سلسلة | معرِّف الإعلانات/معرِّف الجهاز للمعلنين (IDFA) |
| device.language | سلسلة | اللغة المستخدمة في نظام التشغيل |
| device.time_zone_offset_seconds | عدد صحيح | الفَرق بين التوقيت على الجهاز وتوقيت غرينتش بالثواني. |
| device.is_limited_ad_tracking | منطقية |
إعداد "الحدّ من التتبُّع الإعلاني" في الجهاز. عرض القيمة "خطأ" في الإصدار +iOS14 إذا لم يكن معرِّف المعلِنين (IDFA) بقيمة صفرية. |
| device.web_info.browser | سلسلة | المتصفّح الذي شاهَد المستخدِم المحتوى من خلاله. |
| device.web_info.browser_version | سلسلة | إصدار المتصفّح الذي شاهد المستخدم المحتوى من خلاله |
| device.web_info.hostname | سلسلة | اسم المضيف المرتبط بالحدث المُسجَّل |
geo
| يحتوي السِجلّ geo RECORD على معلومات عن الموقع الجغرافي الذي بدأ الحدث منه. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| geo.continent | سلسلة | القارّة التي وقعت فيها الأحداث التي تمّ تسجيلها استنادًا إلى عنوان IP |
| geo.sub_continent | سلسلة | شبه القارة التي تمّ منها تسجيل الأحداث، وذلك استنادًا إلى عنوان IP. |
| geo.country | سلسلة | البلد الذي وقعت فيه الأحداث التي تمّ تسجيلها استنادًا إلى عنوان IP |
| geo.region | سلسلة | المنطقة التي تمّ تسجيل الأحداث فيها استنادًا إلى عنوان IP. |
| geo.metro | سلسلة | المنطقة المركزية التي تمّ منها تسجيل الأحداث، وذلك استنادًا إلى عنوان IP. |
| geo.city | سلسلة | المدينة التي تمّ منها تسجيل الأحداث، وذلك استنادًا إلى عنوان IP. |
app_info
| يحتوي السجلّ app_info على معلومات عن التطبيق الذي بدأ الحدث منه. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| app_info.id | سلسلة | اسم حزمة التطبيق أو رقم تعريف حزمة التطبيق. |
| app_info.firebase_app_id | سلسلة | معرّف التطبيق في Firebase المرتبط بالتطبيق. |
| app_info.install_source | سلسلة | المتجر الذي ثبّت التطبيق. |
| app_info.version | سلسلة | اسم versionName للتطبيق (Android) أو الإصدار القصير للحزمة. |
collected_traffic_source
|
يحتوي الحقل collected_traffic_source RECORD على بيانات مصدر الزيارات التي كانت متوفّرة في الأحداث التي تم جمعها. |
||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| manual_campaign_id | سلسلة | رقم التعريف اليدوي للحملة (utm_id) الذي تم جمعه مع الحدث |
| manual_campaign_name | سلسلة | الاسم اليدوي للحملة (utm_campaign) الذي تم جمعه مع الحدث |
| manual_source | سلسلة | المصدر اليدوي للحملة (utm_source) الذي تمّ جمعه مع الحدث. ويتضمّن أيضًا المَعلمات المُحلّلة من مَعلمات الإحالة، وليس فقط قيم نظام مراقبة الزيارات من Urchin. |
| manual_medium | سلسلة | الوسيط اليدوي للحملة (utm_medium) الذي تمّ جمعه مع الحدث. ويتضمّن أيضًا المَعلمات المُحلّلة من مَعلمات الإحالة، وليس فقط قيم نظام مراقبة الزيارات من Urchin. |
| manual_term | سلسلة | الكلمة الرئيسية/العبارة اليدوية للحملة (utm_term) التي تم جمعها مع الحدث |
| manual_content | سلسلة | البيانات الوصفية الإضافية اليدوية للحملة (utm_content) التي تمّ جمعها مع الحدث. |
| manual_creative_format | سلسلة | تنسيق التصميم اليدوي للحملة (utm_creative_format) الذي تمّ جمعه مع الحدث. |
| manual_marketing_tactic | سلسلة | منهج التسويق اليدوي للحملة (utm_marketing_tactic) الذي تمّ جمعه مع الحدث. |
| manual_source_platform | سلسلة | المنصّة المصدر اليدوية للحملة (utm_source_platform) التي تمّ جمعها مع الحدث. |
| gclid | سلسلة | معرّف النقرة من Google الذي تمّ جمعه مع الحدث. |
| dclid | سلسلة | معرّف النقرة من DoubleClick في "مساحة العرض والفيديو 360" و"مدير الحملة 360" الذي تمّ جمعه مع الحدث. |
| srsltid | سلسلة | معرّف Google Merchant Center الذي تمّ جمعه مع الحدث. |
session_traffic_source_last_click
|
يحتوي السِجلّ session_traffic_source_last_click RECORD على بيانات مصدر زيارات الجلسة التي يتمّ تحديد مصدرها بالاستناد إلى النقرة الأخيرة في إعلانات Google والسياقات اليدوية، متى كان ذلك متاحًا. |
||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| session_traffic_source_last_click. manual_campaign.campaign_id | سلسلة | معرّف الحملة اليدوية التي تمّ النقر عليها آخر مرّة. |
| session_traffic_source_last_click. manual_campaign.campaign_name | سلسلة | اسم الحملة اليدوية التي تمّ النقر عليها آخر مرّة. |
| session_traffic_source_last_click. manual_campaign.medium | سلسلة | وسيط الحملة اليدوية التي تمّ النقر عليها آخر مرّة (مثل نتائج البحث المدفوعة أو نتائج البحث المجّانية أو البريد الإلكتروني). |
| session_traffic_source_last_click. manual_campaign.term | سلسلة | الكلمة الرئيسية/عبارة البحث للحملة اليدوية التي تمّ النقر عليها آخر مرّة. |
| session_traffic_source_last_click. manual_campaign.content | سلسلة | البيانات الوصفية الإضافية للحملة اليدوية التي تمّ النقر عليها آخر مرّة. |
| session_traffic_source_last_click. manual_campaign.source_platform | سلسلة | منصّة الحملة اليدوية التي تمّ النقر عليها آخر مرّة (مثل محرّك بحث أو وسائل التواصل الاجتماعي). |
| session_traffic_source_last_click. manual_campaign.source | سلسلة | المصدر المحدّد ضمن منصّة الحملة اليدوية التي تمّ النقر عليها آخر مرّة. |
| session_traffic_source_last_click. manual_campaign.creative_format | سلسلة | تنسيق التصميم للحملة اليدوية التي تمّ النقر عليها آخر مرّة. |
| session_traffic_source_last_click. manual_campaign.marketing_tactic | سلسلة | منهج التسويق للحملة اليدوية التي تمّ النقر عليها آخر مرّة. |
| session_traffic_source_last_click. google_ads_campaign.customer_id | سلسلة | الرقم التعريفي للعميل المرتبط بحساب "إعلانات Google". |
| session_traffic_source_last_click. google_ads_campaign.account_name | سلسلة | اسم حساب "إعلانات Google". |
| session_traffic_source_last_click. google_ads_campaign.campaign_id | سلسلة | معرّف الحملة على "إعلانات Google". |
| session_traffic_source_last_click. google_ads_campaign.campaign_name | سلسلة | اسم حملة "إعلانات Google". |
| session_traffic_source_last_click. google_ads_campaign.ad_group_id | سلسلة | معرّف المجموعة الإعلانية ضمن حملة "إعلانات Google". |
| session_traffic_source_last_click. google_ads_campaign.ad_group_name | سلسلة | اسم المجموعة الإعلانية ضمن الحملة على "إعلانات Google". |
| session_traffic_source_last_click. cross_channel_campaign.campaign_name |
سلسلة | اسم الحملة التي تشمل قنوات متعدّدة والتي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cross_channel_campaign.campaign_id |
سلسلة | رقم تعريف الحملة التي تشمل قنوات متعدّدة والتي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cross_channel_campaign.source_platform |
سلسلة | منصّة الحملة التي تشمل قنوات متعدّدة والتي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cross_channel_campaign.source |
سلسلة | المصدر المحدّد ضمن منصّة الحملة التي تشمل قنوات متعدّدة والتي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cross_channel_campaign.medium |
سلسلة | وسيط الحملة التي تشمل قنوات متعدّدة والتي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. sa360_campaign.campaign_name |
سلسلة | اسم الحملة على "إعلانات شبكة البحث 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. sa360_campaign.source |
سلسلة | المصدر المحدّد ضمن منصّة الحملة على "إعلانات شبكة البحث 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. sa360_campaign.medium |
سلسلة | وسيط الحملة على "إعلانات شبكة البحث 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. sa360_campaign.ad_group_id |
سلسلة | رقم تعريف المجموعة الإعلانية ضمن الحملة على "إعلانات شبكة البحث 360" |
| session_traffic_source_last_click. sa360_campaign.ad_group_name |
سلسلة | اسم المجموعة الإعلانية ضمن الحملة على "إعلانات شبكة البحث 360" |
| session_traffic_source_last_click. sa360_campaign.campaign_id |
سلسلة | رقم تعريف الحملة على "إعلانات شبكة البحث 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. sa360_campaign.creative_format |
سلسلة | تنسيق تصميم الإعلان للحملة على "إعلانات شبكة البحث 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. sa360_campaign.engine_account_name |
سلسلة | اسم حساب محرّك البحث على "إعلانات شبكة البحث 360" |
| session_traffic_source_last_click. sa360_campaign.engine_account_type |
سلسلة | نوع حساب محرّك البحث الذي يتضمّن الحملة على "إعلانات شبكة البحث 360" |
| session_traffic_source_last_click. sa360_campaign.manager_account_name |
سلسلة | اسم الحساب الإداري على "إعلانات شبكة البحث 360" |
| session_traffic_source_last_click. dv360_campaign.advertiser_id |
سلسلة | رقم تعريف المعلِن على "مساحة العرض والفيديو 360" |
| session_traffic_source_last_click. dv360_campaign.advertiser_name |
سلسلة | اسم المعلِن على "مساحة العرض والفيديو 360". |
| session_traffic_source_last_click. dv360_campaign.campaign_id |
سلسلة | رقم تعريف الحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.campaign_name |
سلسلة | اسم الحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.creative_id |
سلسلة | رقم تعريف تصميم الإعلان للحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.creative_format |
سلسلة | تنسيق تصميم الإعلان للحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.creative_name |
سلسلة | اسم تصميم الإعلان للحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.marketing_tactic |
سلسلة | منهج التسويق للحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.exchange_id |
سلسلة | رقم تعريف تبادل الإعلانات للحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.exchange_name |
سلسلة | اسم تبادل الإعلانات للحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.insertion_order_id |
سلسلة | رقم تعريف طلب الإدراج في الحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.insertion_order_name |
سلسلة | اسم طلب الإدراج في الحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.line_item_id |
سلسلة | رقم تعريف العنصر في الحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.line_item_name |
سلسلة | اسم العنصر في الحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.partner_id |
سلسلة | رقم تعريف الشريك على "مساحة العرض والفيديو 360" |
| session_traffic_source_last_click. dv360_campaign.partner_name |
سلسلة | اسم الشريك على "مساحة العرض والفيديو 360" |
| session_traffic_source_last_click. dv360_campaign.source |
سلسلة | المصدر المحدّد ضمن منصّة الحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. dv360_campaign.medium |
سلسلة | وسيط الحملة على "مساحة العرض والفيديو 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.account_id |
سلسلة | رقم تعريف الحساب على "مدير الحملة 360" |
| session_traffic_source_last_click. cm360_campaign.account_name |
سلسلة | اسم الحساب على "مدير الحملة 360" |
| session_traffic_source_last_click. cm360_campaign.advertiser_id |
سلسلة | رقم تعريف المعلِن على "مدير الحملة 360" |
| session_traffic_source_last_click. cm360_campaign.advertiser_name |
سلسلة | اسم المعلِن على "مدير الحملة 360" |
| session_traffic_source_last_click. cm360_campaign.campaign_id |
سلسلة | رقم تعريف الحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.campaign_name |
سلسلة | اسم الحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.creative_id |
سلسلة | رقم تعريف تصميم الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.creative_format |
سلسلة | تنسيق تصميم الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.creative_name |
سلسلة | اسم تصميم الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.creative_type |
سلسلة | نوع تصميم الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.creative_type_id |
سلسلة | رقم تعريف نوع تصميم الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.creative_version |
سلسلة | نُسخة تصميم الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.placement_id |
سلسلة | رقم تعريف موضع الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click.cm360 _campaign.placement_cost_structure |
سلسلة | بنية تكلفة موضع الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.placement_name |
سلسلة | اسم موضع الإعلان للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.rendering_id |
سلسلة | رقم تعريف العرض للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.site_id |
سلسلة | رقم تعريف الموقع الإلكتروني للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.site_name |
سلسلة | اسم الموقع الإلكتروني للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.source |
سلسلة | المصدر المحدّد للحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
| session_traffic_source_last_click. cm360_campaign.medium |
سلسلة | وسيط الحملة على "مدير الحملة 360" التي تمّ النقر عليها آخر مرّة |
traffic_source
|
يحتوي السجلّ traffic_source على معلومات حول مصدر الزيارات الذي اكتسب المستخدِم للمرّة الأولى. ولا تتمّ تعبئة هذا السِجلّ في الجداول اليومية. ملاحظة: لا تتغيّر قيم traffic_source إذا تفاعَل المستخدِم مع الحملات اللاحقة بعد التثبيت. |
||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| traffic_source.name | سلسلة | اسم الحملة التسويقية التي اكتسبت المستخدم لأول مرة. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| traffic_source.medium | سلسلة | اسم الوسيط (نتائج البحث المدفوعة، نتائج البحث المجانية، البريد الإلكتروني، إلخ) الذي اكتسب المستخدم أولاً. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| traffic_source.source | سلسلة | اسم الشبكة التي اكتسبت المستخدم لأول مرة. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
stream وplatform
| يحتوي الحقلان stream وplatform على معلومات عن مصدر البيانات ومنصّة للتطبيق. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| stream_id | سلسلة | رقم التعريف الرقمي لمصدر البيانات الذي نشأ منه الحدث |
| platform | سلسلة | النظام الأساسي لمصدر البيانات (الويب أو IOS أو Android) الذي نشأ منه الحدث |
التجارة الإلكترونية
| يحتوي السجلّ ecommerce (التجارة الإلكترونية) على معلومات حول أيّ أحداث تجارة إلكترونية تم إعدادها على موقع إلكتروني أو تطبيق. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| ecommerce.total_item_quantity | عدد صحيح | إجمالي عدد السلع في هذا الحدث، وهو مجموع items.quantity |
| ecommerce.purchase_revenue_in_usd | قيمة عائمة | أرباح الشراء في هذا الحدث، بالدولار الأمريكي وبوحدة عادية. وتتم التعبئة لحدث الشراء فقط |
| ecommerce.purchase_revenue | قيمة عائمة | أرباح الشراء في هذا الحدث، بالعملة المحلية وبوحدة عادية. وتتم التعبئة لحدث الشراء فقط |
| ecommerce.refund_value_in_usd | قيمة عائمة | مبلغ ردّ الأموال في هذا الحدث، بالدولار الأمريكي وبوحدة عادية. تتمّ تعبئة البيانات لحدث ردّ الأموال فقط |
| ecommerce.refund_value | قيمة عائمة | مبلغ ردّ الأموال في هذا الحدث، بالعملة المحلّية وبوحدة عادية. تتمّ تعبئة البيانات لحدث ردّ الأموال فقط |
| ecommerce.shipping_value_in_usd | قيمة عائمة | تكلفة الشحن في هذا الحدث، بالدولار الأمريكي وبوحدة عادية |
| ecommerce.shipping_value | قيمة عائمة | تكلفة الشحن في هذا الحدث، بالعملة المحلّية |
| ecommerce.tax_value_in_usd | قيمة عائمة | قيمة الضريبة في هذا الحدث، بالدولار الأمريكي وبوحدة عادية |
| ecommerce.tax_value | قيمة عائمة | قيمة الضريبة في هذا الحدث، بالعملة المحلّية وبوحدة عادية |
| ecommerce.transaction_id | سلسلة | معرِّف معاملة التجارة الإلكترونية. |
| ecommerce.unique_items | عدد صحيح | عدد السلع الفريدة في هذا الحدث، استنادًا إلى item_id وitem_name وitem_brand |
items
| يحتوي السِجلّ items RECORD على معلومات عن السلع التي تمّ تضمينها في أيّ حدث. ويتمّ تكرار هذا السِجلّ لكلّ سلعة. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| items.item_id | سلسلة | رقم تعريف السلعة |
| items.item_name | سلسلة | اسم السلعة. |
| items.item_brand | سلسلة | العلامة التجارية للسلعة |
| items.item_variant | سلسلة | صيغة السلعة |
| items.item_category | سلسلة | فئة السلعة |
| items.item_category2 | سلسلة | الفئة الفرعية للسلعة |
| items.item_category3 | سلسلة | الفئة الفرعية للسلعة |
| items.item_category4 | سلسلة | الفئة الفرعية للسلعة |
| items.item_category5 | سلسلة | الفئة الفرعية للسلعة |
| items.price_in_usd | قيمة عائمة | سعر السلعة بالدولار الأمريكي مع وحدة عادية |
| items.price | قيمة عائمة | سعر السلعة بالعملة المحلية |
| items.quantity | عدد صحيح | تمثل هذه القيمة كمية السلع. ويتم ضبط الكمية على 1 إذا لم يتم تحديدها |
| items.item_revenue_in_usd | قيمة عائمة | الأرباح من هذه السلعة، يتم احتسابها من خلال المعادلة price_in_usd * quantity. وتتم التعبئة لأحداث الشراء فقط بالدولار الأمريكي وبوحدة عادية |
| items.item_revenue | قيمة عائمة | الأرباح من هذه السلعة، يتم احتسابها من خلال المعادلة price * quantity. وتتمّ تعبئة البيانات لأحداث الشراء فقط بالعملة المحلّية وبوحدة عادية. |
| items.item_refund_in_usd | قيمة عائمة | قيمة ردّ الأموال لهذه السلعة، ويتم احتسابها من خلال المعادلة price_in_usd * quantity. وتتم التعبئة فقط لأحداث ردّ الأموال، بالدولار الأمريكي وبوحدة عادية |
| items.item_refund | قيمة عائمة | قيمة ردّ الأموال لهذه السلعة، ويتم احتسابها من خلال المعادلة price * quantity. وتتم التعبئة لأحداث ردّ الأموال فقط بالعملة المحلية وبوحدة عادية |
| items.coupon | سلسلة | رمز القسيمة الذي تمّ تطبيقه على هذه السلعة |
| items.affiliation | سلسلة | ارتباط المنتج لتحديد الشركة التي تقدّمه أو الموقع الجغرافي للمتجر الذي يقدّمه |
| items.location_id | سلسلة | الموقع الجغرافي المرتبط بالسلعة |
| items.item_list_id | سلسلة | رقم تعريف القائمة التي تم فيها عرض السلعة للمستخدِم |
| items.item_list_name | سلسلة | اسم القائمة التي تم فيها عرض السلعة للمستخدِم |
| Items.item_list_index | سلسلة | موضع السلعة في القائمة |
| items.promotion_id | سلسلة | رقم تعريف العرض الترويجي للمنتج |
| items.promotion_name | سلسلة | اسم العرض الترويجي للمنتج. |
| items.creative_name | سلسلة | اسم تصميم الإعلان المستخدَم في إعلان ترويجي على وسائل الإعلام |
| items.creative_slot | سلسلة | اسم خانة تصميم الإعلان |
item_params RECORD
|
يخزِّن السجلّ item_params مَعلمات السلع المخصّصة التي حدّدتها. تجدر الإشارة إلى أنّ مَعلمات السلع المحدّدة مسبقًا مثل item_id وitem_name وما إلى ذلك غير مضمّنة هنا، بل يتم تصديرها كحقول صريحة. تكون مجموعة المَعلمات المخزَّنة في item_params RECORD فريدةً لكلّ عملية تنفيذ. لمعلومات أكثر عن عمليات تنفيذ التجارة الإلكترونية ومصفوفة السلع في "إحصاءات Google 4"، اطّلِع على مقالة قياس التجارة الإلكترونية. |
||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| items.item_params.key | سلسلة | اسم مَعلمة السلعة |
| items.item_params.value | سجلّ | سجلّ يحتوي على قيمة معلَمة السلعة |
| items.item_params.value.string_value | سلسلة | إذا كانت مَعلمة السلعة ممثَّلة بسلسلة، ستتم تعبئتها في هذا الحقل. |
| items.item_params.value.int_value | عدد صحيح | إذا كانت مَعلمة السلعة ممثَّلة بعدد صحيح، ستتم تعبئتها في هذا الحقل. |
| items.item_params.value.double_value | قيمة عائمة | إذا كانت مَعلمة السلعة ممثَّلة بقيمة مزدوجة، ستتم تعبئتها في هذا الحقل. |
| items.item_params.value.float_value | قيمة عائمة | إذا كانت مَعلمة السلعة ممثَّلة بقيمة نقطة عائمة، ستتم تعبئتها في هذا الحقل. |
الناشر (استخدام المنتج قبل إطلاقه فقط)
| يحتوي السجلّ publisher RECORD على معلومات عن الأحداث التي تأتي من عملية تكامل مع ناشر ذات صلة بعرض الإعلانات، أي AdMob. | ||
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| الناشر | سجلّ | سجلّ لبيانات الناشر الواردة من AdMob لا تتم تعبئة هذا الحقل في الجداول اليومية و"عمليات التصدير الجديدة يوميًا" في BigQuery. |
| publisher.ad_revenue_in_usd | قيمة عائمة | إيرادات الإعلانات المقدّرة الناتجة عن هذا الحدث، بالدولار الأمريكي. تتم تعبئة هذا الحقل لأحداث ظهور الإعلان فقط. لا تتم تعبئة هذا الحقل في الجداول اليومية و"عمليات التصدير الجديدة يوميًا" في BigQuery. |
| publisher.ad_format | سلسلة | يصف هذا العمود طريقة ظهور الإعلانات ومكان ظهورها. تشمل الأشكال النموذجية كلاً من "الإعلانات البينية" و"إعلانات البانر" و"الإعلانات مقابل مكافأة" و"الإعلانات المدمجة مع المحتوى (المتقدّمة)". ولا تتم تعبئة هذا الحقل في الجداول اليومية و"عمليات التصدير الجديدة يوميًا" في BigQuery. |
| publisher.ad_source_name | سلسلة | شبكة المصدر التي عرضت إعلانًا. تشمل المصادر النموذجية كلاً من "شبكة AdMob" و"Meta Audience Network" و"الإعلانات للشركة نفسها المعتمِدة على التوسّط". ولا تتم تعبئة هذا الحقل في الجداول اليومية و"عمليات التصدير الجديدة يوميًا" في BigQuery. |
| publisher.ad_unit_id | سلسلة | الاسم الذي اختَرته لوصف هذه الوحدة الإعلانية. والوحدات الإعلانية هي حاويات تضعها في تطبيقاتك لعرض إعلانات على المستخدِمين. لا تتم تعبئة هذا الحقل في الجداول اليومية و"عمليات التصدير الجديدة يوميًا" في BigQuery. |
الصفوف
قد يتم تمثيل بيانات حدث فردي في صف واحد أو عدّة صفوف، استنادًا إلى ما إذا كان يحتوي على سجلّات متكرّرة. على سبيل المثال، سيبدو حدث page_view مع عدّة event_params مشابهًا للجدول التالي. يحتوي الصف الأول على اسم الحدث والتاريخ والطابع الزمني وعناصر البيانات الأخرى غير المتكرّرة. ويتم تكرار السجلّ event_params لكلّ مَعلمة مرتبطة بالحدث. تتم تعبئة هذه السجلّات المتكرّرة في الصفوف اللاحقة أسفل صف الحدث الأوليّ مباشرةً.
| event_date | event_timestamp | event_name | event_params.key | event_params_value.string_value |
|---|---|---|---|---|
| 20220222 | 1643673600483790 | page_view | page_location | https://example.com |
| page_title | الصفحة الرئيسية | |||
| متوسط | إحالة | |||
| source | ||||
| page_referrer | https://www.google.com | |||
| <parameters...> | <القيم...> |
تظهَر بيانات هذا الحدث على النحو التالي في واجهة مستخدِم "إحصاءات Google 4".
بعض الاعتبارات المتعلِّقة بتحديث حِزم تطوير البرامج (SDK) إلى الإصدار 17.2.5 (أو إصدار أحدث) من Android و/أو الإصدار 16.20.0 (أو إصدار أحدث) من iOS
إذا كنت تستخدِم إصدارات سابقة من إحدى حزمَتي تطوير البرامج (SDK) وكنت تخطّط للترقية إلى الإصدار 17.2.5 (أو إصدار أحدث) من Android و/أو الإصدار 16.20.0 (أو إصدار أحدث) من iOS، عليك مراعاة ما يلي:
- لاستخدام مخطّط BigQuery Export الحالي، يجب ترقية حزمة تطوير البرامج إلى الإصدار 17.2.5 (أو إصدار أحدث) لنظام التشغيل Android و/أو الإصدار 16.20.0 (أو إصدار أحدث) لنظام التشغيل iOS. وعند استخدام إصدارات سابقة من حزمة تطوير البرامج، ستشير البيانات التي يتمّ تصديرها إلى المخطّط القديم.
- عند إجراء الترقية وبعد ذلك، لن تتمكّن من الوصول إلى بيانات السلع إلّا داخل مصفوفة السلع المتكرّرة، ولن تكون هذه البيانات متوفّرة في مَعلمات الأحداث العادية كما كان الحال قبل هذه الإصدارات من حزمة تطوير البرامج.
- تم إجراء هذا التغيير للسماح بتحليل منتجات متعددة.
- قد تحتاج إلى تعديل الإشارات المرجعية إلى بيانات السلع/المنتجات نتيجةً لذلك.
استخدِم هذا النص البرمجي لنقل مجموعات بيانات BigQuery الحالية من مخطط التصدير القديم إلى الجديد.
- سجِّل الدخول إلى صفحة Cloud Platform Console >: مراجع للمدراء.
- افتح المشروع الذي تريد نقل بياناته، وانقر على تفعيل Google Cloud Shell في أعلى الصفحة.
- عند فتح وحدة التحكُّم، انسِخ النصّ البرمجي أدناه إلى الملفّ باسم
migration_script.sql:- أدخِل الأمر
cat > migration_script.sql. - انسخ النص البرمجي أدناه والصقه في وحدة التحكّم.
- اضغط على Ctrl+D للحفظ والخروج.
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 - أدخِل الأمر
- افتح وحدة تحكُّم جديدة، وانسِخ النصّ البرمجي bash أدناه إلى الملفّ باسم
migration.sh:- أدخِل الأمر
cat > migration.sh. - انسخ النص البرمجي أدناه والصقه في وحدة التحكّم.
- اضغط على 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 - أدخِل الأمر
- افتح وحدة تحكّم جديدة، وأدخِل الأمر
bash migration.sh
مخطّط التصدير القديم
user_dim
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| user_dim | سجلّ | سِجلّ سمات المستخدم. |
| user_dim.user_id | سلسلة | رقم تعريف المستخدم الذي تمّ ضبطه من خلال setUserId API. |
| user_dim.first_open_timestamp_micros | عدد صحيح | الوقت (بالميكرو ثانية) عندما فَتَحَ المستخدِم التطبيق للمرّة الأولى. |
| user_dim.user_properties | سجلّ | سِجلّ مكرّر لخصائص المستخدِم التي تمّ إعدادها بواسطة setUserProperty API. |
| user_dim.user_properties.key | سلسلة | اسم خاصيّة المستخدم |
| user_dim.user_properties.value | سجلّ | سجلّ معلومات عن خاصيّة المستخدِم |
| user_dim.user_properties.value.value | سجلّ | سِجلّ قيمة خاصيّة المستخدِم. |
| user_dim.user_properties.value.value.string_value | سلسلة | قيمة السلسلة لخاصيّة المستخدِم |
| user_dim.user_properties.value.value.int_value | عدد صحيح | قيمة العدد الصحيح لخاصيّة المستخدِم. |
| user_dim.user_properties.value.value.double_value | قيمة عائمة | القيمة المزدوجة لخاصيّة المستخدِم |
| user_dim.user_properties.value.set_timestamp_usec | عدد صحيح | الوقت (بالميكرو ثانية) عندما تم إعداد خاصيّة المستخدِم للمرّة الأخيرة |
| user_dim.user_properties.value.index | عدد صحيح | فهرس (0-24) لخاصيّة المستخدم. |
| user_dim.device_info | سجلّ | سِجلّ معلومات الجهاز. |
| user_dim.device_info.device_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 | سلسلة | طراز الجهاز |
| user_dim.device_info.platform_version | سلسلة | إصدار نظام التشغيل |
| user_dim.device_info.device_id | سلسلة | معرِّف المورّدين (متوفّر فقط في حال عدم توفُّر معرِّف المعلنين). |
| user_dim.device_info.resettable_device_id | سلسلة | معرِّف الإعلانات/معرِّف الجهاز للمعلنين (IDFA) |
| user_dim.device_info.user_default_language | سلسلة | اللغة المستخدمة في نظام التشغيل |
| user_dim.device_info.device_time_zone_offset_seconds | عدد صحيح | الفَرق بين التوقيت على الجهاز وتوقيت غرينتش بالثواني. |
| user_dim.device_info.limited_ad_tracking | منطقية | إعداد "الحدّ من التتبُّع الإعلاني" في الجهاز. |
| user_dim.geo_info | سجلّ | سِجلّ عن معلومات المستخدِم الجغرافية. |
| user_dim.geo_info.continent | سلسلة | القارّة التي وقعت فيها الأحداث التي تمّ تسجيلها استنادًا إلى عنوان IP |
| user_dim.geo_info.country | سلسلة | البلد الذي وقعت فيه الأحداث التي تمّ تسجيلها استنادًا إلى عنوان IP |
| user_dim.geo_info.region | سلسلة | المنطقة التي تمّ تسجيل الأحداث فيها استنادًا إلى عنوان IP. |
| user_dim.geo_info.city | سلسلة | المدينة التي تمّ منها تسجيل الأحداث، وذلك استنادًا إلى عنوان IP. |
| user_dim.app_info | سجلّ | سِجلّ معلومات عن التطبيق. |
| user_dim.app_info.app_version | سلسلة | اسم versionName للتطبيق (Android) أو الإصدار القصير للحزمة. |
| user_dim.app_info.app_instance_id | سلسلة | المعرّف الفريد لهذه النسخة الافتراضية من التطبيق |
| user_dim.app_info.app_store | سلسلة | المتجر الذي ثبّت هذا التطبيق |
| user_dim.app_info.app_platform | سلسلة | المنصّة التي يتمّ تشغيل التطبيق منها. |
| user_dim.traffic_source | سجلّ | اسم مصدر الزيارات الذي أدّى إلى اكتساب المستخدم. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| user_dim.traffic_source.user_acquired_campaign | سلسلة | اسم حملة التسويق التي أدّت إلى اكتساب المستخدم. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| user_dim.traffic_source.user_acquired_medium | سلسلة | اسم الوسيط (نتائج البحث المدفوعة، بحث مجاني، بريد إلكتروني، وغير ذلك) الذي أدّى إلى اكتساب المستخدم. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| user_dim.traffic_source.user_acquired_source | سلسلة | اسم الشبكة التي أدّت إلى اكتساب المستخدم. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| user_dim.bundle_info | سجلّ | سِجلّ المعلومات عن الحزمة التي تمّ تحميل هذه الأحداث فيها. |
| user_dim.bundle_info.bundle_sequence_id | عدد صحيح | المعرّف التسلسلي للحزمة التي تمّ تحميل هذه الأحداث فيها |
| user_dim.ltv_info | سجلّ | سِجلّ المعلومات عن القيمة الدائمة لهذا المستخدم. لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| user_dim.ltv_info.revenue | قيمة عائمة | القيمة الدائمة لهذا المستخدم (الأرباح). لا تتم تعبئة هذا الحقل في الجداول اليومية. |
| user_dim.ltv_info.currency | سلسلة | القيمة الدائمة لهذا المستخدم (العملة). لا تتم تعبئة هذا الحقل في الجداول اليومية. |
event_dim
| اسم الحقل | نوع البيانات | الوصف |
|---|---|---|
| event_dim | سجلّ | سجل مكرّر من المعلومات المتعلّقة بالأحداث في هذه الحزمة |
| event_dim.date | سلسلة | تاريخ تسجيل الحدث (التنسيق YYYYMMDD في المنطقة الزمنية المسجّلة في التطبيق) |
| event_dim.name | سلسلة | اسم هذا الحدث |
| event_dim.params | سجلّ | سِجِلّ مكرّر للمعلمات المرتبطة بهذا الحدث |
| event_dim.params.key | سلسلة | مفتاح مَعلمة الحدث. |
| event_dim.params.value | سجلّ | سِجلّ قيمة مَعلمة الحدث. |
| event_dim.params.value.string_value | سلسلة | قيمة سلسلة مَعلمة الحدث |
| event_dim.params.value.int_value | عدد صحيح | قيمة العدد الصحيح لمَعلمة الحدث |
| event_dim.params.value.double_value | قيمة عائمة | القيمة المزدوجة لمَعلمة الحدث |
| event_dim.timestamp_micros | عدد صحيح | وقت تسجيل الحدث في البرنامج (بالميكرو ثانية، حسب التوقيت العالمي المنسّق) |
| event_dim.previous_timestamp_micros | عدد صحيح | وقت تسجيل الحدث في الجهاز في وقت سابق (بالملّي ثانية، حسب التوقيت العالمي المنسّق) |