صادرات داده‌های فایربیس به بیگ‌کوئری

فایربیس ابزارهایی را در کنسول Firebase ارائه می‌دهد تا داده‌های تاریخی مربوط به برنامه‌های شما که از محصولات فایربیس استفاده می‌کنند را بررسی و تجزیه و تحلیل کند. این ابزارها می‌توانند به شما در پاسخ به بسیاری از سؤالات در مورد نحوه استفاده از برنامه‌هایتان کمک کنند. با این حال، گاهی اوقات، شما همچنین می‌خواهید سؤالات خود را برای پاسخ به سؤالات خود تنظیم کنید.

شما می‌توانید این کار را با خروجی گرفتن داده‌ها از محصولات مختلف Firebase به BigQuery انجام دهید. با BigQuery ، می‌توانید داده‌های خود را با BigQuery SQL تجزیه و تحلیل کنید یا داده‌ها را برای استفاده با ابزارهای خودتان خروجی بگیرید.

محصولات زیر از ارسال داده به BigQuery پشتیبانی می‌کنند:

• Google Analytics
• Cloud Messaging
• Crashlytics
• Performance Monitoring
• A/B Testing
• شخصی‌سازی Remote Config

مجوزهای مورد نیاز و نقش‌های پیشنهادی

برای مشاهده یا مدیریت تنظیمات مربوط به ارسال داده‌ها به BigQuery ، باید سطح دسترسی لازم را داشته باشید.

اگر دسترسی لازم به Firebase را ندارید، می‌توانید از مالک پروژه Firebase بخواهید که از طریق تنظیمات IAM کنسول Firebase ، نقش مربوطه را به شما اختصاص دهد. اگر در مورد دسترسی به پروژه Firebase خود، از جمله یافتن یا اختصاص مالک، سؤالی دارید، سوالات متداول مربوط به مجوزها و دسترسی به پروژه‌های Firebase را بررسی کنید.

سطح پروژه

جدول زیر مربوط به اتصال سطح بالای یک پروژه Firebase به BigQuery است.

اقدام در کنسول Firebase	مجوز IAM مورد نیاز	نقش(های) IAM که به طور پیش‌فرض شامل مجوزهای مورد نیاز هستند	نقش‌های مورد نیاز اضافی
یک پروژه Firebase و BigQuery را پیوند دهید	firebase.links.create	مالک مدیر فایربیس	هیچ کدام
یک پروژه Firebase و BigQuery را از هم جدا کنید	firebase.links.delete	مالک مدیر فایربیس	هیچ کدام
لینک‌های موجود برای BigQuery را مشاهده کنید	firebase.links.list	هر نقش اساسی (مالک، ویرایشگر یا بیننده) هر نقشی در سطح Firebase هر نقش دسته‌بندی محصول در فایربیس	هیچ کدام

Google Analytics

جدول زیر به طور خاص مربوط به خروجی گرفتن از داده‌های Google Analytics به BigQuery است.

اقدام در کنسول Firebase	مجوز IAM مورد نیاز	نقش(های) IAM که به طور پیش‌فرض شامل مجوزهای مورد نیاز هستند	نقش‌های مورد نیاز اضافی
فعال کردن خروجی گرفتن از داده‌های Google Analytics به BigQuery	firebase.links.update و serviceusage.services.enable و resourcemanager.projects.getIamPolicy و resourcemanager.projects.setIamPolicy	مالک مدیر فایربیس و مدیر استفاده از خدمات و مدیر IAM پروژه	Google Analytics : معادل مدیر حساب یا ویرایشگر برای ویژگی لینک‌شده‌ی Google Analytics به یادداشت زیر مراجعه کنید .
فعال کردن خروجی برای برنامه‌های خاص Firebase	firebase.links.update	مالک مدیر فایربیس	گوگل آنالیتیکس : معادل مدیر حساب یا ویرایشگر برای ویژگی لینک‌شده‌ی Google Analytics به یادداشت زیر مراجعه کنید .
غیرفعال کردن خروجی برای برنامه‌های خاص Firebase	firebase.links.update	مالک مدیر فایربیس	گوگل آنالیتیکس : معادل مدیر حساب یا ویرایشگر برای ویژگی لینک‌شده‌ی Google Analytics به یادداشت زیر مراجعه کنید .

توجه: برای فعال یا غیرفعال کردن خروجی گرفتن در رابط کاربری Google Analytics ، به نقش مدیر یا ویرایشگر صریح برای ویژگی Google Analytics لینک‌شده نیاز دارید. با این حال، دسترسی به فایربیس الزامی نیست.

محصولات فایربیس

جدول زیر برای هر یک از محصولات Firebase که می‌توانید داده‌های آنها را به BigQuery صادر کنید، مانند Crashlytics یا Performance Monitoring ، صدق می‌کند.

اقدام در کنسول Firebase	مجوز IAM مورد نیاز	نقش(های) IAM که به طور پیش‌فرض شامل مجوزهای مورد نیاز هستند	نقش‌های مورد نیاز اضافی
فعال کردن خروجی گرفتن از داده‌های یک محصول به BigQuery	firebase.links.update	مالک مدیر فایربیس	هیچ کدام
فعال کردن خروجی برای برنامه‌های خاص Firebase	firebase.links.update	مالک مدیر فایربیس	هیچ کدام
غیرفعال کردن خروجی برای برنامه‌های خاص Firebase	firebase.links.update	مالک مدیر فایربیس	هیچ کدام

تنظیم خروجی به BigQuery

1. وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.

2. روی کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.

3. برگه ادغام‌ها را انتخاب کنید.

4. در کارت ادغام BigQuery ، روی پیوند (Link) کلیک کنید.

5. برای تنظیم خروجی گرفتن به BigQuery دستورالعمل‌های روی صفحه را دنبال کنید.

وقتی export رو ​​فعال می‌کنی چه اتفاقی می‌افته؟

• شما مکان مجموعه داده‌ها را انتخاب می‌کنید. پس از ایجاد مجموعه داده‌ها، مکان را نمی‌توان تغییر داد، اما می‌توانید مجموعه داده‌ها را به مکان دیگری کپی کنید یا مجموعه داده‌ها را به صورت دستی در مکان دیگری جابجا (بازسازی) کنید. برای کسب اطلاعات بیشتر، به بخش «تغییر مکان برای خروجی‌های موجود» مراجعه کنید.

  این مکان فقط برای داده‌هایی که به BigQuery صادر می‌شوند قابل استفاده است و تاثیری بر مکان داده‌های ذخیره شده برای استفاده در کنسول Firebase ندارد.

  توجه: قابلیت انتخاب و تغییر مکان برای خروجی گرفتن داده‌ها به طور پیش‌فرض برای Google Analytics ، Cloud Messaging و Performance Monitoring در دسترس است. برای Crashlytics ، فقط در صورتی می‌توانید مکان خروجی گرفتن را انتخاب و تغییر دهید که خروجی را بعد از اواسط اکتبر ۲۰۲۴ فعال کرده باشید یا اگر به زیرساخت خروجی جدید ارتقا دهید .

• به طور پیش‌فرض، تمام برنامه‌های موجود در پروژه شما به BigQuery متصل هستند و هر برنامه‌ای که بعداً به پروژه اضافه کنید، به طور خودکار به BigQuery متصل می‌شود. می‌توانید مدیریت کنید که کدام برنامه‌ها داده ارسال کنند .

• فایربیس یک کپی از داده‌های موجود شما را به BigQuery ارسال می‌کند. انتشار اولیه داده‌ها برای ارسال ممکن است تا ۴۸ ساعت طول بکشد.

• فایربیس همگام‌سازی‌های روزانه داده‌های شما را با BigQuery تنظیم می‌کند.

  • بعد از اینکه پروژه خود را لینک کردید، معمولاً باید تا همگام‌سازی روز بعد صبر کنید تا اولین مجموعه داده‌ها به BigQuery صادر شوند.

  • همگام‌سازی روزانه، صرف نظر از هرگونه صادرات برنامه‌ریزی‌شده‌ای که ممکن است در BigQuery تنظیم کرده باشید، یک بار در روز اتفاق می‌افتد. توجه داشته باشید که زمان و مدت زمان کار همگام‌سازی می‌تواند تغییر کند، بنابراین توصیه نمی‌کنیم عملیات یا کارهای پایین‌دستی را بر اساس زمان‌بندی خاصی از صادرات برنامه‌ریزی کنید.

  توجه: خروجی گرفتن از داده‌های Google Analytics به BigQuery به ۱ میلیون رویداد در روز محدود می‌شود. می‌توانید از فیلتر کردن رویدادها برای محدود کردن تعداد رویدادهای خروجی استفاده کنید. برای کسب اطلاعات بیشتر، به بخش فیلتر کردن داده‌ها مراجعه کنید. هیچ محدودیتی برای کاربران گوگل آنالیتیکس ۳۶۰ وجود ندارد.

برای غیرفعال کردن صادرات به BigQuery ، پروژه خود را در کنسول Firebase از حالت اتصال خارج کنید.

تغییر مکان برای صادرات موجود

پس از تنظیم محصول برای صادرات به BigQuery و ایجاد یک مجموعه داده، نمی‌توانید مکان آن مجموعه داده را تغییر دهید. با این حال، می‌توانید مجموعه داده موجود خود را در یک مجموعه داده جدید که مکان متفاوتی دارد کپی کنید و صادرات داده خود را به آن مکان جدید بازنشانی کنید. درباره مکان‌های مجموعه داده BigQuery اطلاعات کسب کنید.

توجه: قابلیت تغییر مکان برای صادرات داده‌ها به طور پیش‌فرض برای Google Analytics ، Cloud Messaging و Performance Monitoring در دسترس است. برای Crashlytics ، فقط در صورتی می‌توانید مکان صادرات را انتخاب و تغییر دهید که صادرات را بعد از اواسط اکتبر 2024 فعال کرده باشید یا اگر به زیرساخت صادرات جدید ارتقا دهید .

مطمئن شوید که تمام دستورالعمل‌های این روش‌ها را دنبال می‌کنید؛ نادیده گرفتن یک مرحله ممکن است منجر به از دست رفتن داده‌ها شود.

محصولی را که می‌خواهید مکان صادرات داده آن را تغییر دهید، انتخاب کنید

گوگل آنالیتیکس

برای تغییر مکان خروجی موجود Google Analytics به BigQuery ، این دستورالعمل‌ها را دنبال کنید:

1. در کنسول Firebase ، به صفحه Integrations بروید. سپس موارد زیر را انجام دهید:

   1. در کارت BigQuery ، روی مدیریت (Manage) کلیک کنید.
   2. برای غیرفعال کردن BigQuery نوار لغزنده Google Analytics را خاموش کنید.

2. در کنسول Google Cloud ، به صفحه BigQuery بروید. سپس موارد زیر را انجام دهید:

   1. یک مجموعه داده موقت ایجاد کنید تا یک کپی از داده‌های موجود از مجموعه داده اصلی خود را ذخیره کنید. نامی متفاوت از نام مجموعه داده اصلی به مجموعه داده موقت اختصاص دهید.
   2. داده‌ها را از مجموعه داده اصلی خود به مجموعه داده موقت کپی یا منتقل کنید .
   3. مجموعه داده اصلی را حذف کنید.
   4. یک مجموعه داده جدید و دائمی با همان نام مجموعه داده اصلی خود ایجاد کنید ( analytics_ ANALYTICS_PROPERTY_ID )، سپس منطقه جدید را انتخاب کنید.
   5. داده‌ها را از مجموعه داده‌های موقت به مجموعه داده‌های جدید کپی یا منتقل کنید، سپس مجموعه داده‌های موقت را حذف کنید.

3. به کنسول Firebase و کارت BigQuery برگردید. سپس موارد زیر را انجام دهید:

   1. برای فعال کردن مجدد ادغام BigQuery نوار لغزنده Google Analytics را فعال کنید.
   2. برنامه‌هایی را که می‌خواهید خروجی گرفتن برای آنها فعال شود، انتخاب کنید.

پیام‌رسانی ابری

برای تغییر مکان خروجی Cloud Messaging موجود به BigQuery ، این دستورالعمل‌ها را دنبال کنید:

1. در کنسول Firebase ، به صفحه Integrations بروید. سپس موارد زیر را انجام دهید:

   1. در کارت BigQuery ، روی مدیریت (Manage) کلیک کنید.
   2. برای غیرفعال کردن BigQuery نوار لغزنده Cloud Messaging را به حالت خاموش تغییر دهید.

2. در کنسول Google Cloud ، به صفحه BigQuery بروید. سپس موارد زیر را انجام دهید:

   1. یک مجموعه داده موقت ایجاد کنید تا یک کپی از داده‌های موجود از مجموعه داده اصلی خود را ذخیره کنید. نامی متفاوت از نام مجموعه داده اصلی به مجموعه داده موقت اختصاص دهید.
   2. داده‌ها را از مجموعه داده اصلی خود به مجموعه داده موقت کپی یا منتقل کنید .
   3. مجموعه داده اصلی را حذف کنید.
   4. یک مجموعه داده جدید و دائمی با همان نام مجموعه داده اصلی خود ( firebase_messaging ) ایجاد کنید، سپس منطقه جدید را انتخاب کنید.
   5. داده‌ها را از مجموعه داده‌های موقت به مجموعه داده‌های جدید کپی یا منتقل کنید، سپس مجموعه داده‌های موقت را حذف کنید.

3. به کنسول Firebase و کارت BigQuery برگردید. سپس موارد زیر را انجام دهید:

   1. برای فعال کردن مجدد ادغام BigQuery نوار لغزنده Cloud Messaging را فعال کنید.
   2. برنامه‌هایی را که می‌خواهید خروجی گرفتن برای آنها فعال شود، انتخاب کنید.

4. به کنسول Google Cloud و صفحه BigQuery برگردید تا تأیید کنید که پیکربندی انتقال برای Cloud Messaging در منطقه جدید ایجاد شده است.

کراش‌لیتیک

مهم: قابلیت انتخاب و تغییر مکان برای خروجی گرفتن از داده‌های Crashlytics فقط در صورتی در دسترس است که خروجی را بعد از اواسط اکتبر ۲۰۲۴ فعال کرده باشید یا اگر به زیرساخت خروجی جدید ارتقا دهید .

برای تغییر مکان خروجی Crashlytics موجود به BigQuery ، این دستورالعمل‌ها را دنبال کنید:

1. در کنسول Firebase ، به صفحه Integrations بروید. سپس موارد زیر را انجام دهید:

   1. در کارت BigQuery ، روی مدیریت (Manage) کلیک کنید.
   2. برای غیرفعال کردن BigQuery نوار لغزنده Crashlytics را خاموش کنید.

2. در کنسول Google Cloud ، به صفحه BigQuery بروید. سپس موارد زیر را انجام دهید:

   1. یک مجموعه داده موقت ایجاد کنید تا یک کپی از داده‌های موجود از مجموعه داده اصلی خود را ذخیره کنید. نامی متفاوت از نام مجموعه داده اصلی به مجموعه داده موقت اختصاص دهید.
   2. داده‌ها را از مجموعه داده اصلی خود به مجموعه داده موقت کپی یا منتقل کنید .
   3. مجموعه داده اصلی را حذف کنید.
   4. یک مجموعه داده جدید و دائمی با همان نام مجموعه داده اصلی خود ( firebase_crashlytics ) ایجاد کنید، سپس منطقه جدید را انتخاب کنید.
   5. داده‌ها را از مجموعه داده‌های موقت به مجموعه داده‌های جدید کپی یا منتقل کنید، سپس مجموعه داده‌های موقت را حذف کنید.

3. به کنسول Firebase و کارت BigQuery برگردید. سپس موارد زیر را انجام دهید:

   1. برای فعال کردن مجدد ادغام BigQuery نوار لغزنده Crashlytics را فعال کنید.
   2. برنامه‌هایی را که می‌خواهید خروجی گرفتن برای آنها فعال شود، انتخاب کنید.

4. به کنسول Google Cloud و صفحه BigQuery برگردید تا تأیید کنید که پیکربندی انتقال برای Crashlytics در منطقه جدید ایجاد شده است.

نظارت بر عملکرد

برای تغییر مکان خروجی Performance Monitoring موجود به BigQuery ، این دستورالعمل‌ها را دنبال کنید:

1. در کنسول Firebase ، به صفحه Integrations بروید. سپس موارد زیر را انجام دهید:

   1. در کارت BigQuery ، روی مدیریت (Manage) کلیک کنید.
   2. برای غیرفعال کردن BigQuery نوار لغزنده Performance Monitoring را خاموش کنید.

2. در کنسول Google Cloud ، به صفحه BigQuery بروید. سپس موارد زیر را انجام دهید:

   1. یک مجموعه داده موقت ایجاد کنید تا یک کپی از داده‌های موجود از مجموعه داده اصلی خود را ذخیره کنید. نامی متفاوت از نام مجموعه داده اصلی به مجموعه داده موقت اختصاص دهید.
   2. داده‌ها را از مجموعه داده اصلی خود به مجموعه داده موقت کپی یا منتقل کنید .
   3. مجموعه داده اصلی را حذف کنید.
   4. یک مجموعه داده جدید و دائمی با همان نام مجموعه داده اصلی خود ( firebase_performance ) ایجاد کنید، سپس منطقه جدید را انتخاب کنید.
   5. داده‌ها را از مجموعه داده‌های موقت به مجموعه داده‌های جدید کپی یا منتقل کنید، سپس مجموعه داده‌های موقت را حذف کنید.

3. به کنسول Firebase و کارت BigQuery برگردید. سپس موارد زیر را انجام دهید:

   1. برای فعال کردن مجدد ادغام BigQuery نوار لغزنده Performance Monitoring را فعال کنید.
   2. برنامه‌هایی را که می‌خواهید خروجی گرفتن برای آنها فعال شود، انتخاب کنید.

4. برای تأیید اینکه پیکربندی انتقال برای Performance Monitoring در منطقه جدید ایجاد شده است، به کنسول Google Cloud و صفحه BigQuery برگردید.

قیمت‌گذاری و سندباکس BigQuery

اگر پروژه Firebase شما در طرح قیمت‌گذاری رایگان Spark قرار دارد، می‌توانید Google Analytics ، Cloud Messaging ، Crashlytics و Performance Monitoring را به BigQuery sandbox متصل کنید که دسترسی رایگان به BigQuery را فراهم می‌کند. برای اطلاعات بیشتر در مورد BigQuery sandbox و قابلیت‌های آن، به بخش «استفاده BigQuery sandbox» مراجعه کنید.

اگر پروژه Firebase شما در طرح قیمت‌گذاری Blaze با پرداخت در محل قرار دارد، می‌توانید Google Analytics ، Cloud Messaging ، Crashlytics ، Performance Monitoring و A/B Testing را به BigQuery متصل کنید. استفاده شما از BigQuery مشمول قیمت‌گذاری معمول BigQuery است که شامل استفاده محدود و بدون هزینه می‌شود.