- الخطوة 1: إنشاء مشروع جديد على Google Cloud Console وتفعيل BigQuery
- الخطوة 2: إعداد مشروعك لميزة BigQuery Export
- الخطوة 3: ربط BigQuery بمواقع "إحصاءات Google 4"
- حذف رابط إلى أداة BigQuery
- حدود BigQuery Export
- فلترة البيانات
- التسعير والفوترة
- وقت بدء ظهور البيانات
- أسباب تعذُّر الربط
- أسباب تعذُّر عملية التصدير
- مراجع ذات صلة
الخطوة 1: إنشاء مشروع على Google APIs Console وتفعيل BigQuery
- سجِّل الدخول إلى Google Cloud Console.
- أنشِئ مشروعًا جديدًا على Google Cloud Console أو اختَر مشروعًا حاليًا.
- انتقِل إلى جدول واجهات برمجة التطبيقات.
افتح قائمة التنقل في أعلى يمين الصفحة، وانقر على واجهات برمجة التطبيقات والخدمات، ثم انقر على المكتبة. - فعِّل BigQuery.
ضمن Google Cloud APIs، انقر على BigQuery API. وفي الصفحة التالية، انقر على تفعيل. - راجِع بنود الخدمة ووافِق عليها في حال المطالبة بذلك.
الخطوة 2: إعداد مشروعك لميزة BigQuery Export
يمكنك تصدير بيانات "إحصاءات Google" إلى وضع الحماية في BigQuery بدون أي تكلفة (تنطبق حدود وضع الحماية).
تعرَّف أكثر على الترقية من وضع الحماية وأسعار BigQuery.
الخطوة 3: ربط موقع على "إحصاءات Google 4" بأداة BigQuery
بعد إكمال أوّل خطوتَين، يمكنك تفعيل ميزة BigQuery Export من "المشرِف" في "إحصاءات Google".
تخضع ميزة BigQuery Export لحدود جمع البيانات والإعدادات نفسها في "إحصاءات Google". وإذا كنت بحاجة إلى حدود أعلى، يمكنك ترقية موقعك إلى الإصدار 360.
- في
المشرف، ضِمن الروابط بين المنتجات، انقر على روابط BigQuery.
سيفتح الرابط السابق على آخر موقع وصلت إليه على "إحصاءات Google". يمكنك تغيير الموقع الإلكتروني باستخدام أداة اختيار المواقع.- يجب أن يكون لديك إذن محرِّر أو أعلى كي تتمكّن منعلى مستوى الموقع من أجل ربط موقع على "إحصاءات Google" بأداة BigQuery.
- يجب أيضًا استخدام عنوان بريد إلكتروني لديه إذن وصول المالك إلى مشروع BigQuery (اطّلِع على الأذونات أدناه لمعرفة متطلّبات الوصول التفصيلية).
- انقر على ربط.
- انقر على اختيار مشروع BigQuery لعرض قائمة بالمشاريع التي يمكنك الوصول إليها.
في حال ربط "إحصاءات Google" بمنصّة Firebase (أو التخطيط لذلك)، يمكن التصدير إلى المشروع نفسه على السحابة الإلكترونية، ما سيسهِّل عملية الربط ببيانات Firebase الأخرى. - اختَر مشروعًا من القائمة، ثم انقر على تأكيد.
- اختَر موقعًا جغرافيًا للبيانات. (إذا كان مشروعك يتضمّن مجموعة بيانات لموقع "إحصاءات Google"، لا يمكنك ضبط هذا الخيار).
- انقر على التالي.
- اختَر ضبط مصادر البيانات والأحداث لاختيار مصادر البيانات التي يجب تضمينها في عملية التصدير، وكذلك لاختيار أحداث محدّدة يجب استبعادها من عملية التصدير. ويمكنك استبعاد الأحداث إما بالنقر على إضافة للاختيار من قائمة الأحداث الحالية أو بالنقر على تحديد الحدث حسب الاسم لاختيار الأحداث الحالية حسب الاسم أو لتحديد أسماء الأحداث التي لم يتمّ جمعها بعد على الموقع.
- انقر على تم.
- اختَر تضمين المعرِّفات الإعلانية لمصادر بيانات التطبيقات المتوافقة مع الأجهزة الجوّالة إذا كنت تريد تضمين المعرِّفات الإعلانية.
- اختَر إمّا يوميًا (مرة في اليوم) أو بث (مستمر) لتصدير البيانات أو كلَيهما. بالنسبة إلى مواقع "إحصاءات Google 360"، يمكنك أيضًا اختيار معدّل تكرار عمليات التصدير الجديدة يوميًا.
- انقر على التالي.
- راجِع إعداداتك، ثمّ انقر على إرسال.
الأذونات
حقوق الحصول على سياسة إدارة الهوية وإمكانية الوصول/وضع سياسة إدارة الهوية وإمكانية الوصول في المشروع، وحقوق تفعيل/الحصول على الخدمات
OWNER هو مجموعة متميّزة من هذه الأذونات.لإنشاء رابط BigQuery، يكون الحدّ الأدنى من الأذونات المطلوبة هو كالتالي:
resourcemanager.projects.get- للحصول على المشروع
resourcemanager.projects.getIamPolicy- للحصول على قائمة بالأذونات
resourcemanager.projects.setIamPolicy- للتأكّد ممّا إذا كان المستخدِم لديه الإذن اللازم لإنشاء الرابط في هذا المشروع
serviceusage.services.enable- لتفعيل BigQuery API
serviceusage.services.get- للتأكّد من تفعيل BigQuery API
التحقّق من حساب الخدمة
عند الربط بين "إحصاءات Google" وBigQuery، تؤدّي هذه العملية إلى إنشاء حساب الخدمة التالي:
firebase-measurement@system.gserviceaccount.com
تأكَّد من إضافة الحساب كعضو في المشروع، ومنحه دور مستخدِم BigQuery (roles/bigquery.user).
إذا سبق لك إعداد BigQuery Export لمنح حساب الخدمة دور المحرِّر لمشروع Google Cloud، يمكنك تقليل هذا الدور إلى مستخدِم BigQuery. لتغيير دور حساب الخدمة، يجب إلغاء ربط "إحصاءات Google" بمشروع BigQuery ثمّ إعادة الربط. تتمثّل الخطوة الأولى في إلغاء ربط "إحصاءات Google" وBigQuery وإزالة حساب الخدمة الذي يمتلك دور "المحرِّر". بعد ذلك، عليك إعادة ربط "إحصاءات Google" وBigQuery وفقًا للتعليمات الواردة أعلاه لإنشاء حساب الخدمة الجديد بالإذن الصحيح للمشروع.
بعد إعادة الربط، تأكّد من أنّ حساب الخدمة يتضمّن دور المالك (bigquery.dataOwner) في مجموعة بيانات التصدير الحالية. ويمكنك إجراء ذلك من خلال الاطّلاع على سياسة الوصول إلى مجموعة البيانات.
تغيير المناطق
إذا اختَرت المنطقة غير الصحيحة وكنت بحاجة إلى تغييرها بعد إنشاء الرابط:
- احذف الرابط إلى أداة BigQuery (انظر أدناه).
- انسخ البيانات احتياطيًا إلى مجموعة بيانات أخرى في BigQuery (نقل أو نسخ).
- احذف مجموعة البيانات الأصلية. سجّل الاسم: ستحتاج إليه في الخطوة التالية.
- أنشِئ مجموعة بيانات جديدة بالاسم نفسه لمجموعة البيانات التي حذفتها مؤخّرًا، واختَر الموقع الجغرافي للبيانات.
- يمكنك مشاركة مجموعة البيانات الجديدة مع firebase-measurement@system.gserviceaccount.com ومنح حساب الخدمة دور مالك بيانات BigQuery.
- انسخ البيانات الاحتياطية إلى مجموعة البيانات الجديدة.
- كرّر الإجراء السابق لإنشاء رابط جديد إلى BigQuery.
بعد تغيير الموقع الجغرافي، ستحدث فجوة في بياناتك: لن تتم معالجة بث البيانات وعمليات التصدير اليومية لها في الفترة بين حذف الرابط الحالي وإنشاء رابط جديد.
حذف رابط إلى أداة BigQuery
- في سيفتح الرابط السابق على آخر موقع وصلت إليه على "إحصاءات Google". يمكنك تغيير الموقع الإلكتروني باستخدام أداة اختيار المواقع.يجب أن يكون لديك إذن محرِّر أو أعلى كي تتمكّن منعلى مستوى الموقع من أجل حذف رابط إلى أداة BigQuery.
- انقر على الصف لعرض الرابط.
- في أعلى يسار الصفحة، انقر على
> حذف.
> حذف.حدود BigQuery Export
الحد اليومي لعدد الأحداث التي يمكن تصديرها يوميًا (بشكل مجمّع) في ميزة BigQuery Export في ما يتعلق بالمواقع العادية على "إحصاءات Google 4" هو مليون حدث. ما مِن حدّ أقصى لعدد أحداث تصدير البث. وإذا كان موقعك يتخطى حدّ التصدير بشكلٍ مستمر، سيتم إيقاف عملية تصدير BigQuery اليومية مؤقتًا ولن تتم إعادة معالجة عمليات تصدير الأيام السابقة.
بالنسبة إلى مواقع "إحصاءات Google 360"، يحتوي خيار التصدير "معدّل تكرار عمليات التصدير الجديدة يوميًا" على جميع حقول البيانات والأعمدة التي يُفترض أن تكون في عملية التصدير اليومية، بما في ذلك بيانات تحديد مصدر المستخدِم المرصودة وبيانات مرّات ظهور الإعلان.
سيتلقّى محرِّرو ومشرفو المواقع إشعارًا عبر البريد الإلكتروني في كل مرة يتخطى فيها الموقع الذي يُديرونه الحدّ اليومي. وسيشير هذا الإشعار إلى الوقت الذي سيتم فيه إيقاف عملية التصدير مؤقتًا في حال عدم اتِّخاذ إجراء. وإضافةً إلى ذلك، إذا كان أحد المواقع العادية يتخطى بشكلٍ كبير الحدّ اليومي الذي يبلغ مليون حدث، قد توقِف "إحصاءات Google" عمليات التصدير اليومية مؤقتًا على الفور. إذا تلقّيت إشعارًا، يُرجى الاستفادة من خيارات فلترة البيانات (تصدير مصادر البيانات واستبعاد الأحداث) لخفض عدد الأحداث التي يتم تصديرها يوميًا والتأكّد من استمرار عمل التصدير اليومي.
مزيد من المعلومات عن الحدود الأعلى المتاحة في المواقع على "إحصاءات 360".
فلترة البيانات
يمكِنك استبعاد مصادر بيانات وأحداث معيّنة من عملية التصدير، سواء كان ذلك بهدف تقليل حجم التصدير أم التأكد من تصدير الأحداث المطلوبة في BigQuery فقط.
استبعاد مصادر البيانات والأحداث خلال عملية الربط
عند اختيار مصادر البيانات المطلوب تصديرها خلال عملية الربط، يتوفر لك أيضًا خيار تحديد الأحداث المطلوب استبعادها من عملية التصدير. اطّلِع على الخطوة 9 في عملية الربط.
إضافة أو إزالة مصادر البيانات أو الأحداث بعد إعداد عملية الربط
يمكنك إضافة مصادر البيانات أو إزالتها وإضافة الأحداث إلى قائمة الاستبعاد أو إزالتها منها بعد إعداد رابط BigQuery.
- في سيفتح الرابط السابق على آخر موقع وصلت إليه على "إحصاءات Google". يمكنك تغيير الموقع الإلكتروني باستخدام أداة اختيار المواقع.
- يجب أن يكون لديك إذن محرِّر أو أعلى كي تتمكّن منعلى مستوى الموقع من أجل إضافة مصادر بيانات أو أحداث أو إزالتها.
- يجب أيضًا استخدام عنوان بريد إلكتروني لديه إذن وصول المالك إلى مشروع BigQuery.
- انقر على الصف الخاص بالمشروع الذي تريد تعديل رابطه.
- ضمن مصادر البيانات والأحداث، انقر على عرض مصادر البيانات والأحداث.
- ضمن مصادر البيانات للتصدير، يمكنك اختيار مصادر بيانات إضافية لتصديرها أو إزالة مصادر البيانات الحالية من القائمة.
- في قائمة الأحداث المطلوب استثناؤها، انقر على إضافة للاختيار من قائمة الأحداث الحالية أو انقر على تحديد الحدث حسب الاسم لاختيار الأحداث الحالية حسب الاسم أو لتحديد أسماء الأحداث التي لم يتمّ جمعها بعدُ على الموقع.
- لإزالة حدث ما من القائمة، انقر على علامة الطرح في نهاية الصف المعنيّ.
التسعير والفوترة
تُحصِّل أداة BigQuery رسوم الاستخدام من خلال عنصرَي التسعير: سعة التخزين ومعالجة طلب البحث. ويمكنك مراجعة جدول التسعير والتعرُّف على الاختلافات بين طلبات البحث التفاعلية والمجمّعة.
يجب توفُّر طريقة دفع صالحة مسجَّلة في Google Cloud حتى يتم تنفيذ عملية التصدير. وفي حال مقاطعة عملية التصدير بسبب تضمين طريقة دفع غير صالحة، لا يمكننا إعادة تصدير البيانات المرتبطة بذلك الوقت.
يمكنك أيضًا تصدير بيانات "إحصاءات Google" إلى وضع الحماية في BigQuery بدون أي تكلفة، ولكن يجب الانتباه إلى أنّ حدود وضع الحماية ستنطبق في هذه الحالة.
وقت بدء ظهور البيانات
عند اكتمال الربط، من المفترض أن يبدأ تدفق البيانات إلى مشروعك على BigQuery خلال 24 ساعة. في حال تفعيل التصدير اليومي، يتم تصدير ملف واحد كل يوم يتضمّن بيانات اليوم السابق (بصفة عامة، خلال وقت مبكر من بعد الظهر في المنطقة الزمنية التي حدّدتها لإعداد التقارير).
بالنسبة إلى المواقع المميّزة "العادية" و"الكبيرة"، يتم تعديل خيار التصدير "معدّل تكرار عمليات التصدير الجديدة يوميًا" كل 60 دقيقة تقريبًا على مدار اليوم. ولا يتوفّر خيار التصدير "معدّل تكرار عمليات التصدير الجديدة يوميًا" للمواقع المميّزة "الكبيرة جدًا".
أسباب تعذُّر الربط
قد يتعذّر الربط بأداة BigQuery لأيٍّ من السببَين التاليَين:
- تحظر سياسة المؤسّسة تصدير البيانات إلى الولايات المتحدة. إذا اختَرت الولايات المتّحدة كموقع جغرافي لبياناتك، عليك اختيار موقع جغرافي مختلف.
- تحظر سياسة المؤسّسة حسابات الخدمة من النطاق الذي تريد تصدير البيانات منه. وفي هذه الحالة، ستحتاج إلى تعديل سياسة المؤسّسة.
أسباب تعذُّر عملية التصدير
| حالة تعذُّر إتمام العملية | السبب | النتيجة |
|---|---|---|
| لا يتوفّر حساب خدمة. | ما مِن حساب خدمة في مشروعك على السحابة الإلكترونية يتضمّن دور المستخدِم النشط. | يتعذّر على "إحصاءات Google" إنشاء جداول. ويتعذّر التصدير. |
| تم حذف حساب الروبوت بعد التثبيت. | أزال مستخدِم على حساب السحابة الإلكترونية حساب الخدمة للروبوت الذي ثبّتته خدمة "إحصاءات Google". | يتعذّر على "إحصاءات Google" بعد ذلك إنشاء جداول. وتتوقّف جميع عمليات التصدير. |
| تتعارض سياسة المؤسسة مع ميزة BigQuery Export | أنشأ مستخدِم ضمن المشروع على السحابة الإلكترونية سياسة مؤسّسة تمنع "إحصاءات Google" من تصدير البيانات. يمكن أن تمنع السياسة إنشاء جداول BigQuery أو الكتابة في الجداول. ويمكن أن تعترض السياسة أيضًا على منطقة تخزين البيانات. | لم يتم إنشاء الجدول أو تم إنشاؤه ثم حذفه بسرعة (حوالي 30 دقيقة). |
| يغيّر مستخدِم إعدادات الفوترة. | ينتقِل مستخدِم ضمن المشروع على السحابة الإلكترونية من مجاني إلى مدفوع لأداة BigQuery. على الرغم من نجاح ذلك في المعتاد، يمكن أن تحدث بعض حالات تعذُّر التصدير، على سبيل المثال، في حال تخطى المشروع 10 غيغابايت (حدود وضع الحماية). عمليًا، يمكن أن يبدأ تعذُّر التصدير. | لا تتم تعبئة الجداول. |
| تجاوز المشروع على السحابة الإلكترونية الحصة المحدّدة | تتوفّر في السحابة الإلكترونية موارد محدودة لمعظم المشاريع. يمكن أن تتجاوز حصة تخزين BigQuery ويتم بعد ذلك منعك من كتابة المزيد من البيانات. تجدر الإشارة إلى أن هذه الحصة صغيرة للمشاريع المجانية (10 غيغابايت). | لا تتم تعبئة الجداول. |
| يغيِّر المستخدِم المنطقة الزمنية للموقع | يشمل التصدير نبذة عن موقع لمدة 24 ساعة استنادًا إلى المنطقة الزمنية لذلك الموقع. وإذا تم تغيير المنطقة الزمنية، يمكن أن تصبح فترة التصدير أقصر أو أطول في يوم محدّد (على سبيل المثال، أقصر بمقدار 3 ساعات إذا تم تغيير المنطقة الزمنية من التوقيت الشرقي الرسمي في الولايات المتحدة إلى توقيت المحيط الهادئ في الولايات المتحدة). وفي أيٍّ من الحالتَين، سيرصد المستخدِم عددًا غير معتاد من الأحداث. | عدد غير معتاد من الأحداث خلال يوم واحد. والتباس الأمور على المستخدِم. |
الدعم
يمكنك التواصل مع فريق دعم Google Cloud بخصوص مشاكل BigQuery، مثل الفوترة.
مراجع ذات صلة
BigQuery Export
للحصول على معلومات حول التصدير والوصول إلى نموذج لمجموعة بيانات، اطّلع على مستندات BigQuery Export.