آزمایش‌های پیکربندی از راه دور Firebase را با آزمایش A/B ایجاد کنید

وقتی از Firebase Remote Config برای استقرار تنظیمات یک برنامه با پایگاه کاربر فعال استفاده می‌کنید، می‌خواهید مطمئن شوید که آن را به درستی انجام می‌دهید. می‌توانید از آزمایش‌های A/B Testing برای تعیین بهترین موارد زیر استفاده کنید:

• بهترین راه برای پیاده‌سازی یک ویژگی برای بهینه‌سازی تجربه کاربری. اغلب، توسعه‌دهندگان برنامه تا زمانی که رتبه برنامه‌شان در فروشگاه برنامه کاهش نیابد، متوجه نمی‌شوند که کاربرانشان از یک ویژگی جدید یا یک تجربه کاربری به‌روزرسانی‌شده خوششان نمی‌آید. A/B Testing می‌تواند به سنجش اینکه آیا کاربران شما انواع جدید ویژگی‌ها را دوست دارند یا اینکه برنامه را همانطور که هست ترجیح می‌دهند، کمک کند. به‌علاوه، نگه‌داشتن اکثر کاربرانتان در یک گروه پایه تضمین می‌کند که اکثر پایگاه کاربری شما می‌توانند بدون هیچ تغییری در رفتار یا ظاهر برنامه تا زمان پایان آزمایش، به استفاده از آن ادامه دهند.
• بهترین راه برای بهینه‌سازی تجربه کاربری برای یک هدف تجاری. گاهی اوقات شما در حال اجرای تغییرات محصول برای به حداکثر رساندن معیاری مانند درآمد یا حفظ مشتری هستید. با A/B Testing ، هدف تجاری خود را تعیین می‌کنید و Firebase تجزیه و تحلیل آماری را انجام می‌دهد تا مشخص کند که آیا یک متغیر از خط پایه برای هدف انتخابی شما بهتر عمل می‌کند یا خیر.

برای تست A/B انواع ویژگی‌ها با یک خط پایه، موارد زیر را انجام دهید:

1. آزمایش خود را ایجاد کنید.
2. آزمایش خود را مدیریت کنید.

یک آزمایش ایجاد کنید

یک آزمایش Remote Config به شما امکان می‌دهد چندین نوع را روی یک یا چند پارامتر Remote Config ارزیابی کنید.

1. تأیید کنید که Google Analytics در پروژه شما فعال است تا آزمایش به داده‌های Analytics دسترسی داشته باشد.

   اگر هنگام ایجاد پروژه خود، Google Analytics فعال نکرده‌اید، می‌توانید آن را در ... فعال کنید. settings Firebase تب ادغام‌ها در کنسول فایربیس .

2. در کنسول Firebase ، به DevOps & Engagement > A/B Testing بروید.

3. روی ایجاد آزمایش کلیک کنید و سپس وقتی از شما خواسته شد سرویسی را که می‌خواهید با آن آزمایش کنید Remote Config را انتخاب کنید.

4. در بخش متغیرها ، یک خط مبنا و حداقل یک متغیر برای آزمایش انتخاب کنید. می‌توانید یک یا چند پارامتر برای آزمایش اضافه کنید. می‌توانید این مرحله را برای اضافه کردن چندین پارامتر به آزمایش خود تکرار کنید.

5. (اختیاری) برای افزودن بیش از یک نوع به آزمایش خود، روی «افزودن نوع دیگر» کلیک کنید.

6. یک یا چند پارامتر را برای انواع خاص تغییر دهید. هر پارامتر بدون تغییر برای کاربرانی که در آزمایش گنجانده نشده‌اند، یکسان است.

7. برای مشاهده یا تغییر وزن متغیرها برای آزمایش، وزن متغیرها را باز کنید. به طور پیش‌فرض، هر متغیر وزن یکسانی دارد. توجه داشته باشید که وزن‌های ناهموار ممکن است زمان جمع‌آوری داده‌ها را افزایش دهند و وزن‌ها پس از شروع آزمایش قابل تغییر نیستند .

8. معیارهای هدف‌گیری برای آزمایش خود را با استفاده از شرایط Remote Config تعریف کنید:

   • استفاده مجدد از یک شرط موجود: اگر یک شرط موجود در الگوی Remote Config شما از قبل با مخاطب هدف شما مطابقت دارد، آن را از لیست انتخاب کنید.

   • تأیید ترتیب ارزیابی شرط: مطمئن شوید که شرط‌های شما در صفحه شرط‌ها به ترتیب اولویت صحیح سازماندهی شده‌اند. از آنجا که Remote Config شرط‌ها را به ترتیب از بالا به پایین ارزیابی می‌کند، سایر شرط‌های با اولویت بالاتر می‌توانند مانع از دسترسی تعداد کافی از کاربران به شرط مرتبط با آزمایش شما شوند.

   • ایجاد یک شرط جدید: اگر هیچ یک از شرط‌های موجود، الزامات هدف‌گیری شما را برآورده نمی‌کند، یا اگر ترجیح می‌دهید یک شرط موجود را کپی کنید (برای مثال، اگر ترجیح می‌دهید از شرطی که قبلاً توسط پارامترهای دیگر استفاده می‌شود استفاده نکنید)، ابتدا با انتخاب برنامه‌ای که از آزمایش شما استفاده می‌کند، یک شرط جدید ایجاد کنید. اگر یک شرط جداگانه یا تکراری برای یک آزمایش ایجاد می‌کنید، مطمئن شوید که شرط جدید در اولویت بالاتری نسبت به شرط موجود قرار دارد. در غیر این صورت، کاربران ابتدا با شرط موجود مطابقت دارند و هیچ کاربری وارد آزمایش نخواهد شد.

     سپس می‌توانید با کلیک کردن و انتخاب یک یا چند گزینه از لیست زیر، زیرمجموعه خاصی از کاربران را هدف قرار دهید:

     • نسخه: یک یا چند نسخه از برنامه شما
     • شماره ساخت: شماره ساخت (اپل) یا کد نسخه (اندروید) برنامه شما
     • پلتفرم: یک یا چند پلتفرم (iOS، اندروید یا وب) برای هدف قرار دادن
     • سیستم عامل: کاربران برنامه‌های وب را بر اساس سیستم عامل و نسخه آنها هدف قرار دهید
     • مرورگر: کاربران برنامه‌های وب را بر اساس مرورگر وب و نسخه مرورگرشان هدف قرار دهید.
     • دسته بندی دستگاه: کاربران اپلیکیشن وب را بر اساس اینکه دستگاهشان موبایل است یا غیرموبایل هدف قرار دهید
     • زبان‌ها: یک یا چند زبان و منطقه‌ی جغرافیایی که برای انتخاب کاربرانی که ممکن است در آزمایش گنجانده شوند، استفاده می‌شود.
     • کشور/منطقه: یک یا چند کشور یا منطقه برای انتخاب کاربرانی که باید در آزمایش گنجانده شوند
     • مخاطبان کاربر: مخاطبان Analytics که برای هدف قرار دادن کاربرانی که ممکن است در آزمایش گنجانده شوند، استفاده می‌شوند
     • ویژگی کاربر: یک یا چند ویژگی کاربر Analytics برای انتخاب کاربرانی که ممکن است در آزمایش گنجانده شوند
     • کاربر در درصد تصادفی: درصد تصادفی از کاربران را در یک محدوده صدک تعریف شده هدف قرار دهید.
     • بخش وارد شده: کاربرانی را هدف قرار دهید که به بخش‌های وارد شده سفارشی آپلود شده در پروژه شما تعلق دارند
     • تاریخ/زمان: کاربران را بر اساس یک تاریخ و زمان مشخص هدف قرار دهید
     • اولین باز شدن: کاربران را بر اساس اولین باری که برنامه شما را باز کرده‌اند، هدف قرار دهید.
     • شناسه نصب: دستگاه‌های آزمایشی خاص یا نمونه‌های کلاینت را با استفاده از شناسه‌های نصب Firebase (FID) آنها هدف قرار دهید.
     • کاربر وجود دارد: همه کاربران را در تمام برنامه‌های پروژه هدف قرار دهید
     • سیگنال سفارشی: کاربران را بر اساس سیگنال‌های کلید-مقدار سفارشی سمت کلاینت که در زمان اجرا ارسال می‌شوند، هدف قرار دهید.

9. تنظیم میزان مواجهه: درصد پایگاه کاربری برنامه خود را که با معیارهای تعیین شده مطابقت دارد، در قسمت «کاربران هدف» که می‌خواهید به طور مساوی بین خط پایه و یک یا چند متغیر در آزمایش خود تقسیم کنید، وارد کنید. این می‌تواند هر درصدی بین 0٪ تا 100٪ باشد. کاربران به طور تصادفی به هر آزمایش، از جمله آزمایش‌های تکراری، اختصاص داده می‌شوند.

10. به صورت اختیاری، یک رویداد فعال‌سازی تنظیم کنید تا مطمئن شوید که فقط داده‌های کاربرانی که ابتدا یک رویداد Analytics را فعال کرده‌اند در آزمایش شما شمارش می‌شوند. توجه داشته باشید که همه کاربرانی که با پارامترهای هدف‌گیری شما مطابقت دارند، مقادیر آزمایشی Remote Config دریافت خواهند کرد، اما فقط کسانی که یک رویداد فعال‌سازی را فعال می‌کنند در نتایج آزمایش شما لحاظ می‌شوند.

    برای اطمینان از یک آزمایش معتبر، مطمئن شوید که رویدادی که انتخاب می‌کنید پس از فعال شدن مقادیر پیکربندی واکشی شده توسط برنامه شما رخ می‌دهد. علاوه بر این، رویدادهای زیر قابل استفاده نیستند زیرا همیشه قبل از فعال شدن مقادیر واکشی شده رخ می‌دهند:

    • app_install
    • app_remove
    • app_update

    رویداد Analytics که به عنوان رویداد فعال‌سازی انتخاب می‌کنید، نباید به عنوان معیار اصلی (یا به عنوان یک معیار اضافی) در همان آزمایش نیز استفاده شود. انجام این کار باعث ایجاد خطای اعتبارسنجی در کنسول Firebase شده و از اجرای آزمایش شما جلوگیری می‌کند.

11. برای اهداف آزمایش، معیار اصلی را برای ردیابی انتخاب کنید و هر معیار اضافی را که می‌خواهید ردیابی کنید از لیست اضافه کنید. این موارد شامل اهداف از پیش تعیین‌شده (خریدها، درآمد، حفظ مشتری، کاربران بدون خرابی و غیره)، رویدادهای تبدیل Analytics و سایر رویدادهای Analytics است. پس از اتمام، روی بعدی کلیک کنید.

12. برای ذخیره آزمایش خود، روی ذخیره کلیک کنید. برای شروع اجرای آزمایش، باید الگو را منتشر کنید.

شما مجاز به انجام حداکثر ۳۰۰ آزمایش در هر پروژه (شامل راه‌اندازی‌ها) هستید، که می‌تواند شامل حداکثر ۲۴ آزمایش و راه‌اندازی در حال اجرا و بقیه آزمایش‌ها به عنوان آزمایش‌های تکمیل‌شده باشد.

آزمایش خود را مدیریت کنید

وقتی با استفاده از Remote Config یک آزمایش ایجاد می‌کنید، می‌توانید آزمایش خود را شروع کنید، در حین اجرا آن را زیر نظر داشته باشید و تعداد کاربرانی که در آزمایش در حال اجرا شرکت می‌کنند را افزایش دهید.

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

ویرایش یک آزمایش

1. در بخش DevOps & Engagement از منوی ناوبری کنسول Firebase ، روی Remote Config کلیک کنید.
2. روی برگه تست‌های A/B کلیک کنید.
3. روی «در حال اجرا» کلیک کنید، روی آزمایشی که می‌خواهید ویرایش کنید کلیک کنید.
4. روی منوی زمینه ( more_vert ) کلیک کنید و روی ویرایش آزمایش در حال اجرا کلیک کنید.
5. برای تأیید اینکه برنامه شما کاربرانی دارد که می‌توانند در آزمایش شما گنجانده شوند، جزئیات را گسترش دهید و در بخش هدف‌گیری و توزیع، عددی بزرگتر از ۰٪ را بررسی کنید (برای مثال، ۱٪ از کاربران مطابق با معیارها ).

نظارت بر یک آزمایش

وقتی مدتی از اجرای یک آزمایش گذشت، می‌توانید پیشرفت آن را بررسی کنید و ببینید نتایج شما برای کاربرانی که تاکنون در آزمایش شما شرکت کرده‌اند، چگونه به نظر می‌رسد.

1. در بخش DevOps & Engagement از منوی ناوبری کنسول Firebase ، روی Remote Config کلیک کنید.
2. روی برگه تست‌های A/B کلیک کنید.

3. روی Running کلیک کنید و سپس روی عنوان آزمایش خود کلیک کنید یا آن را جستجو کنید. در این صفحه، می‌توانید آمارهای مختلف مشاهده شده و مدل‌سازی شده در مورد آزمایش در حال اجرا خود، از جمله موارد زیر را مشاهده کنید:

   • درصد اختلاف از حالت پایه : معیاری برای بهبود یک معیار برای یک متغیر معین در مقایسه با حالت پایه. با مقایسه محدوده مقادیر متغیر با محدوده مقادیر حالت پایه محاسبه می‌شود.
   • احتمال غلبه بر خط پایه : احتمال تخمینی که یک متغیر معین، خط پایه را برای معیار انتخاب شده شکست می‌دهد.
   • observed_metric به ازای هر کاربر : بر اساس نتایج آزمایش، این محدوده پیش‌بینی‌شده‌ای است که مقدار متریک در طول زمان در آن قرار خواهد گرفت.
   • مجموع observed_metric : مقدار تجمعی مشاهده‌شده برای خط پایه یا متغیر. این مقدار برای اندازه‌گیری میزان عملکرد هر متغیر آزمایشی و محاسبه‌ی بهبود (Improvment)، محدوده‌ی ارزش (Value range )، احتمال بهتر بودن از خط پایه (Probability to Beyond the baseline ) و احتمال بهترین بودن متغیر استفاده می‌شود. بسته به معیار اندازه‌گیری‌شده، این ستون ممکن است با برچسب‌های «مدت زمان به ازای هر کاربر»، «درآمد به ازای هر کاربر»، «نرخ ماندگاری» یا «نرخ تبدیل» نامگذاری شود.

4. پس از اینکه آزمایش شما مدتی اجرا شد (۱۴ روز برای Remote Config )، داده‌های این صفحه نشان می‌دهد که کدام نوع، در صورت وجود، «پیشرو» است. برخی از اندازه‌گیری‌ها با نمودار میله‌ای همراه هستند که داده‌ها را در قالب بصری ارائه می‌دهد.

یک آزمایش را برای همه کاربران منتشر کنید

بعد از اینکه یک آزمایش به اندازه کافی اجرا شد که شما یک "پیشرو" یا یک نوع برنده برای معیار هدف خود داشتید، می‌توانید آزمایش را برای ۱۰۰٪ کاربران منتشر کنید. این به شما امکان می‌دهد تا یک نوع را برای انتشار برای همه کاربران در آینده انتخاب کنید. حتی اگر آزمایش شما یک برنده مشخص ایجاد نکرده باشد، هنوز می‌توانید یک نوع را برای همه کاربران خود منتشر کنید.

1. در بخش DevOps & Engagement از منوی ناوبری کنسول Firebase ، روی Remote Config کلیک کنید.
2. روی برگه تست‌های A/B کلیک کنید.
3. روی «تکمیل‌شده» یا «در حال اجرا» کلیک کنید، روی آزمایشی که می‌خواهید برای همه کاربران منتشر شود کلیک کنید، روی منوی زمینه ( more_vert ) کلیک کنید و گزینه «نوع را منتشر کنید» را انتخاب کنید .
4. با انجام موارد زیر، آزمایش خود را برای همه کاربران منتشر کنید:
   • برای یک آزمایش Remote Config ، یک نوع را انتخاب کنید تا مشخص شود کدام مقادیر پارامتر Remote Config باید به‌روزرسانی شوند. معیارهای هدف‌گیری که هنگام ایجاد آزمایش تعریف شده‌اند، به عنوان یک شرط جدید در الگوی شما اضافه می‌شوند تا اطمینان حاصل شود که این به‌روزرسانی فقط بر کاربرانی که توسط آزمایش هدف قرار گرفته‌اند، تأثیر می‌گذارد. پس از کلیک روی «بررسی» در Remote Config برای بررسی تغییرات، روی «انتشار تغییرات» کلیک کنید تا به‌روزرسانی کامل شود.

گسترش یک آزمایش

اگر متوجه شدید که یک آزمایش، کاربران کافی برای A/B Testing و اعلام برتری را جذب نمی‌کند، می‌توانید توزیع آزمایش خود را افزایش دهید تا به درصد بیشتری از پایگاه کاربران برنامه دسترسی پیدا کنید.

1. در بخش DevOps & Engagement از منوی ناوبری کنسول Firebase ، روی Remote Config کلیک کنید.
2. روی برگه تست‌های A/B کلیک کنید.
3. آزمایش در حال اجرا را که می‌خواهید ویرایش کنید، انتخاب کنید.
4. در نمای کلی آزمایش ، روی منوی زمینه ( more_vert ) کلیک کنید و سپس روی ویرایش آزمایش در حال اجرا کلیک کنید.
5. پنجره‌ی «هدف‌گذاری» گزینه‌ای را برای افزایش درصد کاربرانی که در آزمایش در حال اجرا هستند نمایش می‌دهد. عددی بزرگتر از درصد فعلی را انتخاب کنید و روی «انتشار» کلیک کنید. آزمایش به درصد کاربرانی که مشخص کرده‌اید، منتقل می‌شود.

تکرار یک آزمایش

1. در بخش DevOps & Engagement از منوی ناوبری کنسول Firebase ، روی Remote Config کلیک کنید.
2. روی برگه تست‌های A/B کلیک کنید.
3. آزمایش در حال اجرا یا تکمیل‌شده‌ای را که می‌خواهید متوقف کنید، انتخاب کنید.
4. روی «تکمیل‌شده» یا «در حال اجرا» کلیک کنید، اشاره‌گر را روی آزمایش خود نگه دارید، روی منوی زمینه ( more_vert ) کلیک کنید و سپس روی «تکرار آزمایش» یا «توقف آزمایش» کلیک کنید.

توقف یک آزمایش

1. در بخش DevOps & Engagement از منوی ناوبری کنسول Firebase ، روی Remote Config کلیک کنید.
2. روی برگه تست‌های A/B کلیک کنید.
3. آزمایش در حال اجرا یا تکمیل‌شده‌ای را که می‌خواهید متوقف کنید، انتخاب کنید.
4. روی «تکمیل‌شده» یا «در حال اجرا» کلیک کنید، اشاره‌گر را روی آزمایش خود نگه دارید، روی منوی زمینه ( more_vert ) کلیک کنید و سپس روی «توقف آزمایش» کلیک کنید.

شناسایی کلاینت وب و پایداری آزمایش

وقتی کاربری برای اولین بار یک برنامه وب را با استفاده از Firebase A/B Testing در مرورگر اجرا می‌کند، یک شناسه نصب منحصر به فرد Firebase (FID) ایجاد می‌شود. این FID به طور مداوم در IndexedDB مرورگر ذخیره می‌شود تا نمونه برنامه در طول جلسات شناسایی شود.

Firebase A/B Testing از FID برای اختصاص دادن کاربران به انواع آزمایش استفاده می‌کند و Google Analytics از آن برای تجمیع رویدادها برای اندازه‌گیری و تحلیل رفتار کاربر در هر نوع استفاده می‌کند.

از آنجا که FID در IndexedDB ذخیره می‌شود، Firebase A/B Testing اگر کاربر از مرورگر دیگری یا در یک پنجره ناشناس به برنامه شما دسترسی پیدا کند، یا اگر IndexedDB مرورگر خود را پاک کند، با او به عنوان یک کاربر جدید رفتار می‌کند. این بدان معناست که یک کاربر ممکن است هنگام استفاده از مرورگرها یا جلسات مرور مختلف، در انواع مختلف آزمایش گنجانده شود.

هدف‌گیری کاربر

شما می‌توانید با استفاده از معیارهای هدف‌گیری کاربر زیر، کاربرانی را که می‌خواهید در آزمایش خود بگنجانید، هدف قرار دهید.

انواع قوانین زیر در کنسول Firebase پشتیبانی می‌شوند. ویژگی‌های معادل آن در Remote Config REST API موجود است، همانطور که در مرجع عبارت شرطی توضیح داده شده است.

معیارهای A/B Testing

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

برای مثال، فرض کنید از Remote Config برای راه‌اندازی دو جریان بازی مختلف در برنامه خود استفاده می‌کنید و می‌خواهید خریدهای درون‌برنامه‌ای و درآمد تبلیغات را بهینه‌سازی کنید، اما همچنین می‌خواهید پایداری و میزان حفظ کاربر هر نوع را پیگیری کنید. در این حالت، می‌توانید Estimated total income را به عنوان معیار هدف خود انتخاب کنید زیرا شامل درآمد خرید درون‌برنامه‌ای و درآمد تبلیغات می‌شود و سپس، برای سایر معیارها برای پیگیری ، می‌توانید موارد زیر را اضافه کنید:

• برای پیگیری میزان حفظ کاربر روزانه و هفتگی، «حفظ کاربر» (۲-۳ روز) و «حفظ کاربر» (۴-۷ روز) را اضافه کنید.
• برای مقایسه پایداری بین دو جریان بازی، کاربران بدون خرابی (Crash-free users) را اضافه کنید.
• برای مشاهده جزئیات بیشتر هر نوع درآمد، درآمد حاصل از خرید و درآمد تخمینی از تبلیغات را اضافه کنید.

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

معیارهای هدف

سایر معیارها

خروجی گرفتن از داده‌های BigQuery

علاوه بر مشاهده داده‌های آزمایش A/B Testing در کنسول Firebase ، می‌توانید داده‌های آزمایش را در BigQuery بررسی و تجزیه و تحلیل کنید. در حالی که A/B Testing جدول BigQuery جداگانه‌ای ندارد، عضویت‌های آزمایش و متغیر در هر رویداد Google Analytics در جداول رویداد Analytics ذخیره می‌شوند.

ویژگی‌های کاربری که حاوی اطلاعات آزمایش هستند، به شکل userProperty.key like "firebase_exp_%" یا userProperty.key = "firebase_exp_01" که در آن 01 شناسه آزمایش است و userProperty.value.string_value شامل اندیس (مبتنی بر صفر) نوع آزمایش است.

شما می‌توانید از این ویژگی‌های کاربر آزمایش برای استخراج داده‌های آزمایش استفاده کنید. این به شما قدرت می‌دهد تا نتایج آزمایش خود را به روش‌های مختلفی برش دهید و نتایج A/B Testing را به طور مستقل تأیید کنید.

برای شروع، موارد زیر را طبق توضیحات این راهنما انجام دهید:

1. فعال کردن خروجی BigQuery برای Google Analytics در کنسول فایربیس
2. دسترسی به داده‌های A/B Testing با استفاده از BigQuery
3. کاوش در نمونه سوالات

فعال کردن خروجی BigQuery برای Google Analytics در کنسول فایربیس

اگر از طرح Spark استفاده می‌کنید، می‌توانید از محیط سندباکس BigQuery برای دسترسی رایگان BigQuery استفاده کنید، البته با توجه به محدودیت‌های Sandbox . برای اطلاعات بیشتر به بخش قیمت‌گذاری و محیط سندباکس BigQuery مراجعه کنید.

ابتدا مطمئن شوید که داده‌های Analytics خود را به BigQuery منتقل می‌کنید:

1. در کنسول Firebase ، به مسیر زیر بروید: settings > برگه یکپارچه‌سازی‌ها .

2. در کارت BigQuery ، روی مدیریت (Manage) کلیک کنید و تأیید کنید که پروژه شما داده‌های Analytics را به BigQuery صادر می‌کند.

   اگر روی کارت عبارت «پیوند» نوشته شده باشد، باید خروجی گرفتن را تنظیم کنید (به مرحله بعدی بروید).

3. اگر نیاز به تنظیم صادرات دارید:

   1. درباره اتصال Firebase به BigQuery نظر بدهید، سپس روی Next کلیک کنید.

   2. در بخش پیکربندی ادغام ، Google Analytics فعال کنید.

   3. یک منطقه را انتخاب کنید و تنظیمات صادرات را انتخاب کنید.

   4. روی پیوند به BigQuery کلیک کنید.

بسته به نحوه‌ی انتخاب شما برای خروجی گرفتن از داده‌ها، ممکن است تا یک روز طول بکشد تا جداول در دسترس قرار گیرند. برای اطلاعات بیشتر در مورد خروجی گرفتن از داده‌های پروژه به BigQuery ، به بخش خروجی گرفتن از داده‌های پروژه به BigQuery مراجعه کنید.

دسترسی به داده‌های A/B Testing در BigQuery

قبل از جستجوی داده‌ها برای یک آزمایش خاص، باید برخی یا همه موارد زیر را برای استفاده در جستجوی خود به دست آورید:

• شناسه آزمایش: می‌توانید این را از آدرس اینترنتی صفحه مرور کلی آزمایش دریافت کنید. برای مثال، اگر آدرس اینترنتی شما به شکل https://console.firebase.google.com/project/my_firebase_project/config/experiment/results/25 باشد، شناسه آزمایش ۲۵ است.
• شناسه ویژگی Google Analytics : این شناسه ۹ رقمی ویژگی Google Analytics شماست. می‌توانید آن را در Google Analytics پیدا کنید؛ همچنین در BigQuery وقتی نام پروژه خود را باز می‌کنید تا نام جدول رویداد Google Analytics شما ( project_name.analytics_000000000.events ) نمایش داده می‌شود، ظاهر می‌شود.
• تاریخ آزمایش: برای نوشتن یک پرس‌وجوی سریع‌تر و کارآمدتر، بهتر است پرس‌وجوهای خود را به پارتیشن‌های جدول رویدادهای روزانه Google Analytics که حاوی داده‌های آزمایش شما هستند - جداولی که با پسوند YYYYMMDD مشخص می‌شوند - محدود کنید. بنابراین، اگر آزمایش شما از ۲ فوریه ۲۰۲۴ تا ۲ مه ۲۰۲۴ انجام شده است، باید یک _TABLE_SUFFIX between '20240202' AND '20240502' تعیین کنید. برای مثال، به بخش «مقادیر یک آزمایش خاص را انتخاب کنید» مراجعه کنید.
• Event names: Typically, these correspond with your goal metrics that you configured in the experiment. For example, in_app_purchase events, ad_impression , or user_retention events.

After you gather the information you need to generate your query:

1. In the Google Cloud console, go to BigQuery .
2. Select your project, then select Create SQL query .
3. Add your query. For example queries to run, see Explore example queries .
4. Click Run .

Query experiment data using the Firebase console's auto-generated query

If you're using the Blaze plan, the Experiment overview page provides a sample query that returns the experiment name, variants, event names, and the number of events for the experiment you're viewing.

To obtain and run the auto-generated query:

1. In the Firebase console, go to DevOps & Engagement > A/B Testing .
2. Select the A/B Testing experiment you want to query to open the Experiment overview .
3. From the Options menu, beneath BigQuery integration , select Query experiment data . This opens your project in BigQuery within the Google Cloud console console and provides a basic query you can use to query your experiment data.

The following example shows a generated query for an experiment with three variants (including the baseline) named "Winter welcome experiment." It returns the active experiment name, variant name, unique event, and event count for each event. Note that the query builder doesn't specify your project name in the table name, as it opens directly within your project.

  /*
    This query is auto-generated by Firebase A/B Testing for your
    experiment "Winter welcome experiment".
    It demonstrates how you can get event counts for all Analytics
    events logged by each variant of this experiment's population.
  */
  SELECT
    'Winter welcome experiment' AS experimentName,
    CASE userProperty.value.string_value
      WHEN '0' THEN 'Baseline'
      WHEN '1' THEN 'Welcome message (1)'
      WHEN '2' THEN 'Welcome message (2)'
      END AS experimentVariant,
    event_name AS eventName,
    COUNT(*) AS count
  FROM
    `analytics_000000000.events_*`,
    UNNEST(user_properties) AS userProperty
  WHERE
    (_TABLE_SUFFIX BETWEEN '20240202' AND '20240502')
    AND userProperty.key = 'firebase_exp_25'
  GROUP BY
    experimentVariant, eventName

  /*
    This query returns all experiment variants, number of unique users,
    the average USD spent per user, and the standard deviation for all
    experiments within the date range specified for _TABLE_SUFFIX.
  */
  SELECT
    experimentNumber,
    experimentVariant,
    COUNT(*) AS unique_users,
    AVG(usd_value) AS usd_value_per_user,
    STDDEV(usd_value) AS std_dev
  FROM
    (
      SELECT
        userProperty.key AS experimentNumber,
        userProperty.value.string_value AS experimentVariant,
        user_pseudo_id,
        SUM(
          CASE
            WHEN event_name IN ('in_app_purchase', 'ecommerce_purchase')
              THEN event_value_in_usd
            ELSE 0
            END) AS usd_value
      FROM `PROJECT_NAME.analytics_ANALYTICS_ID.events_*`
      CROSS JOIN UNNEST(user_properties) AS userProperty
      WHERE
        userProperty.key LIKE 'firebase_exp_%'
        AND event_name IN ('in_app_purchase', 'ecommerce_purchase')
        AND (_TABLE_SUFFIX BETWEEN 'YYYYMMDD' AND 'YYYMMDD')
      GROUP BY 1, 2, 3
    )
  GROUP BY 1, 2
  ORDER BY 1, 2;

  SELECT
    'EXPERIMENT_NAME' AS experimentName,
    CASE userProperty.value.string_value
      WHEN '0' THEN 'Baseline'
      WHEN '1' THEN 'VARIANT_1_NAME'
      WHEN '2' THEN 'VARIANT_2_NAME'
      END AS experimentVariant,
    event_name AS eventName,
    COUNT(*) AS count
  FROM
    `analytics_ANALYTICS_PROPERTY.events_*`,
    UNNEST(user_properties) AS userProperty
  WHERE
    (_TABLE_SUFFIX BETWEEN 'YYYMMDD' AND 'YYYMMDD')
    AND userProperty.key = 'firebase_exp_EXPERIMENT_NUMBER'
  GROUP BY
    experimentVariant, eventName