إنشاء تجارب "الإعداد عن بُعد في Firebase" باستخدام ميزة "اختبار A/B"

عند استخدام Firebase Remote Config لنشر الإعدادات لتطبيق يضم قاعدة مستخدمين نشطة، عليك التأكّد من أنّك اتّبعت الخطوات بشكلٍ صحيح. يمكنك استخدام A/B Testing تجربة لتحديد ما يلي على أفضل نحو:

• أفضل طريقة لاستخدام ميزة لتحسين تجربة المستخدم: في كثير من الأحيان، لا يعلم مطوّرو التطبيقات أنّ المستخدمين لا يحبون ميزة جديدة أو تجربة مستخدم محدّثة إلى أن ينخفض تقييم تطبيقهم في متجر التطبيقات. يمكن أن يساعد اختبار أ/ب في قياس ما إذا كان المستخدِمون يحبّون الصيغ الجديدة من الميزات أو ما إذا كانوا يفضّلون التطبيق كما هو. بالإضافة إلى ذلك، يضمن إبقاء معظم المستخدمين في مجموعة مرجعية أنّ معظم قاعدة المستخدمين يمكنهم مواصلة استخدام تطبيقك بدون مواجهة أي تغييرات في سلوكه أو مظهره إلى أن تنتهي التجربة.
• أفضل طريقة لتحسين تجربة المستخدِم لتحقيق هدف النشاط التجاري في بعض الأحيان، يتم تنفيذ تغييرات على المنتجات لزيادة مقياس معيّن إلى أقصى حد، مثل الأرباح أو الاحتفاظ بالمستخدمين. باستخدام اختبار A/B، يمكنك تحديد هدف نشاطك التجاري، ويقوم Firebase بإجراء التحليل الإحصائي لتحديد ما إذا كانت إحدى الصيغ تحقّق أداءً أفضل مقارنةً بالمرجع لهدفك المحدّد.

لإجراء اختبار أ/ب لفئات الميزة باستخدام مرجع أساسي، اتّبِع الخطوات التالية:

1. أنشئ تجربتك.
2. التحقّق من صحّة تجربتك على جهاز اختباري
3. أدِر تجربتك.

إنشاء تجربة

تتيح لك تجربة Remote Config تقييم صيغ متعدّدة على مَعلمة Remote Config واحدة أو أكثر.

1. سجِّل الدخول إلى وحدة تحكّم Firebase وتأكَّد من تفعيل Google Analytics في مشروعك لكي تتمكّن التجربة من الوصول إلى بيانات Analytics.

   إذا لم تفعِّل Google Analytics عند إنشاء مشروعك، يمكنك تفعيله من علامة التبويب عمليات الدمج ، والتي يمكنك الوصول إليها باستخدام settings > إعدادات المشروع في وحدة تحكُّم Firebase.

2. في قسم التفاعل من قائمة التنقّل في Firebase وحدة التحكّم، انقر على A/B Testing.

3. انقر على إنشاء تجربة، ثم انقر على Remote Config عندما يُطلب منك اختيار الخدمة التي تريد إجراء التجربة عليها.

4. أدخِل اسمًا ووصفًا اختياريًا لتجربتك، ثم انقر على التالي.

5. املأ حقول الاستهداف، مع اختيار التطبيق الذي يستخدم تجربتك أولاً. يمكنك أيضًا استهداف مجموعة فرعية من المستخدمين للمشاركة في تجربتك من خلال النقر على و، ثم اختيار خيارات من القائمة التالية:

   • الإصدار: إصدار واحد أو أكثر من إصدارات تطبيقك
   • رقم الإصدار: رمز إصدار التطبيق
   • اللغات: لغة واحدة أو أكثر وإعدادات لغة واحدة أو أكثر المستخدَمة لاختيار المستخدِمين الذين قد يتم تضمينهم في التجربة
   • البلد/المنطقة: بلد أو منطقة واحدة أو أكثر لاختيار المستخدِمين الذين يجب تضمينهم في التجربة
   • جمهور المستخدِمين: Analytics شرائح الجمهور المستخدَمة لاستهداف المستخدِمين الذين قد يتم تضمينهم في التجربة
   • خاصيّة المستخدِم: خاصيّة مستخدِم واحدة أو أكثر من Analytics لتحديد المستخدِمين الذين قد يتم تضمينهم في التجربة

   • عمليات بدء التشغيل لأول مرة: استهدِف المستخدِمين استنادًا إلى أوّل مرّة فتحوا فيها تطبيقك.

     تتوفّر ميزة استهداف المستخدِمين حسب وقت فتح التطبيق لأول مرّة بعد اختيار تطبيق Android أو iOS. وهي متوافقة مع إصدارات حزمة تطوير البرامج (SDK) التالية من Remote Config: الإصدار 9.0.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لمنصّات Apple والإصدار 21.1.1 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Android (Firebase BoM الإصدار 30.3.0 أو إصدار أحدث).

     يجب أيضًا أن يكون Analytics مفعّلاً على العميل أثناء الحدث المفتوح الأول.

6. اضبط النسبة المئوية للمستخدمين المستهدَفين: أدخِل النسبة المئوية لقاعدة مستخدمي تطبيقك التي تتطابق مع المعايير المحدّدة ضمن المستخدمون المستهدَفون والتي تريد تقسيمها بالتساوي بين السعر الأساسي وسعر متغير واحد أو أكثر في تجربتك. ويمكن أن تكون أي نسبة مئوية بين 0.01% و100%. يتم تحديد كل تجربة للمستخدمين بشكلٍ عشوائي، بما في ذلك التجارب المكرّرة.

7. يمكنك اختياريًا ضبط حدث تنشيط لضمان احتساب البيانات من المستخدِمين الذين بدأوا أولاً بعض أحداث Analytics في تجربتك فقط. يُرجى العِلم أنّ جميع المستخدِمين الذين يتطابقون مع مَعلمات الاستهداف الخاصة بك سيتلقّون قيمًا تجريبية من Remote Config، ولكن لن يتم تضمين سوى المستخدِمين الذين يُشغِّلون حدث Remote Config في نتائج تجربتك.

   لضمان إجراء تجربة صالحة، تأكَّد من أنّ الحدث الذي تختاره يقع بعد أن يفعّل تطبيقك قيم الإعدادات التي تم جلبها. إضافةً إلى ذلك، لا يمكن استخدام الأحداث التالية لأنّها تحدث دائمًا قبل تفعيل القيم التي تم استرجاعها:

   • app_install
   • app_remove
   • app_update
   • dynamic_link_first_open

8. بالنسبة إلى أهداف التجربة، اختَر المقياس الأساسي الذي تريد تتبُّعه وأضِف أي مقاييس إضافية تريد تتبُّعها من القائمة. وتشمل هذه الأهداف المضمّنة (عمليات الشراء والأرباح ومعدل الاحتفاظ بالمستخدمين والمستخدمين الذين لم يواجهوا أي أعطال، وما إلى ذلك). أحداث Analytics الإحالات الناجحة وأحداث Analytics الأخرى عند الانتهاء، انقر على التالي.

9. في قسم الصيغ، اختَر الأساس وصيغة واحدة على الأقل للتجربة. استخدِم قائمة اختيار قائمة جديدة أو إنشاؤها لإضافة مَعلمة واحدة أو أكثر لتجربتها. يمكنك إنشاء مَعلمة لم يتم استخدامها من قبل في وحدة تحكّم Firebase، ولكن يجب أن تكون متوفّرة في تطبيقك لكي يكون لها أي تأثير. يمكنك تكرار هذه الخطوة لإضافة عدة مَعلمات إلى تجربتك.

10. (اختياري) لإضافة أكثر من سعر متغير واحد إلى تجربتك، انقر على إضافة سعر متغير آخر.

11. تغيير مَعلمة واحدة أو أكثر لخيارات سعر محدّدة إنّ أيّ مَعلمات لم تتغيّر تكون متطابقة للمستخدمين غير المدرَجين في التجربة.

12. وسِّع ترجيحات الصيغ لعرض الوزن المتغير للتجربة أو تغييره. بشكل تلقائي، يتم منح جميع الصيغ قيمًا تقديرية متساوية. يُرجى العلم أنّ القيم التقديرية غير المتساوية يمكن أن تؤدي إلى زيادة الوقت المُستغرَق في جمع البيانات، ولا يمكن تغييرها بعد بدء التجربة.

13. انقر على مراجعة لحفظ تجربتك.

يُسمح لك بإنشاء ما يصل إلى 300 تجربة لكل مشروع، ويمكن أن تتألف من 24 تجربة قيد التنفيذ كحد أقصى، مع تصنيف الباقي على أنّه مسودة أو مكتملة.

التحقّق من صحّة تجربتك على جهاز اختباري

لكل عملية تثبيت على Firebase، يمكنك استرداد الرمز المميّز لاعتماد التثبيت المرتبط بها. يمكنك استخدام هذا الرمز المميّز لاختبار صيغ محدّدة من التجارب على جهاز اختباري تم تثبيت تطبيقك عليه. للتحقّق من صحة تجربتك على جهاز اختبار، اتّبِع الخطوات التالية:

1. يمكنك الحصول على رمز المصادقة للتثبيت على النحو التالي:

   Swift

   do {
     let result = try await Installations.installations()
       .authTokenForcingRefresh(true)
     print("Installation auth token: \(result.authToken)")
   } catch {
     print("Error fetching token: \(error)")
   }

   Objective-C

   [[FIRInstallations installations] authTokenForcingRefresh:true
                                                  completion:^(FIRInstallationsAuthTokenResult *result, NSError *error) {
     if (error != nil) {
       NSLog(@"Error fetching Installation token %@", error);
       return;
     }
     NSLog(@"Installation auth token: %@", [result authToken]);
   }];

   Java

   FirebaseInstallations.getInstance().getToken(/* forceRefresh */true)
           .addOnCompleteListener(new OnCompleteListener<InstallationTokenResult>() {
       @Override
       public void onComplete(@NonNull Task<InstallationTokenResult> task) {
           if (task.isSuccessful() && task.getResult() != null) {
               Log.d("Installations", "Installation auth token: " + task.getResult().getToken());
           } else {
               Log.e("Installations", "Unable to get Installation auth token");
           }
       }
   });
   MainActivity.java

   Kotlin+KTX

   val forceRefresh = true
   FirebaseInstallations.getInstance().getToken(forceRefresh)
       .addOnCompleteListener { task ->
           if (task.isSuccessful) {
               Log.d("Installations", "Installation auth token: " + task.result?.token)
           } else {
               Log.e("Installations", "Unable to get Installation auth token")
           }
       }
   MainActivity.kt

   C++‎

   firebase::InitResult init_result;
   auto* installations_object = firebase::installations::Installations::GetInstance(
       firebase::App::GetInstance(), &init_result);
   installations_object->GetToken().OnCompletion(
       [](const firebase::Future<std::string>& future) {
         if (future.status() == kFutureStatusComplete &&
             future.error() == firebase::installations::kErrorNone) {
           printf("Installations Auth Token %s\n", future.result()->c_str());
         }
       });

   Unity

   Firebase.Installations.FirebaseInstallations.DefaultInstance.GetTokenAsync(forceRefresh: true).ContinueWith(
     task => {
       if (!(task.IsCanceled || task.IsFaulted) && task.IsCompleted) {
         UnityEngine.Debug.Log(System.String.Format("Installations token {0}", task.Result));
       }
     });

2. في شريط التنقّل في وحدة تحكّم Firebase، انقر على اختبار A/B.
3. انقر على مسودة (و/أو جارٍ لتجارب "الإعداد عن بُعد")، مرِّر مؤشر الماوس فوق تجربتك، انقر على قائمة السياقات (more_vert)، ثم انقر على إدارة الأجهزة الاختبارية.
4. أدخِل الرمز المميّز لمصادقة التثبيت لجهاز اختبار واختَر صيغة التجربة لإرسالها إلى هذا الجهاز الاختباري.
5. شغِّل التطبيق وتأكَّد من أنّ السعر المتغير المحدَّد يتم تلقّيه على الجهاز الاختباري.

لمعرفة المزيد من المعلومات عن عمليات تثبيت Firebase، يُرجى الاطّلاع على مقالة إدارة عمليات تثبيت Firebase.

إدارة تجربتك

سواء أكنت تنشئ تجربة باستخدام Remote Config أو أداة إنشاء الإشعارات أو Firebase In-App Messaging، يمكنك بعد ذلك التحقّق من صحتها وبدء تجربتك، ومراقبة تجربتك أثناء تشغيلها، وزيادة عدد المستخدمين المدرَجين في تجربتك الجارية.

عند انتهاء التجربة، يمكنك ملاحظة الإعدادات التي استخدمتها الصيغة الفائزة، ثم طرح هذه الإعدادات لجميع المستخدمين. أو يمكنك إجراء تجربة أخرى.

بدء تجربة

1. في قسم التفاعل ضمن قائمة التنقّل في Firebase وحدة تحكّم، انقر على A/B Testing.
2. انقر على مسودة، ثمّ انقر على عنوان تجربتك.
3. للتحقّق من أنّ تطبيقك يحتوي على مستخدمين يمكن تضمينهم في تجربتك، وسِّع تفاصيل المسودة وتحقَّق من أنّ رقمًا أكبر من 0% في قسم الاستهداف والتوزيع (مثلاً، 1% من المستخدمين الذين يتطابقون مع المعايير).
4. لتغيير تجربتك، انقر على تعديل.
5. لبدء تجربتك، انقر على بدء التجربة. يمكنك إجراء ما يصل إلى 24 تجربة لكل مشروع في المرة الواحدة.

مراقبة تجربة

بعد تشغيل التجربة لبعض الوقت، يمكنك التحقّق من مستوى تقدّمها والاطّلاع على شكل نتائجك للمستخدمين الذين شاركوا في تجربتك حتى الآن.

1. في قسم التفاعل من قائمة التنقّل في Firebase وحدة التحكّم، انقر على A/B Testing.

2. انقر على جارٍ، ثمّ انقر على عنوان تجربتك أو ابحث عنه. في هذه الصفحة، يمكنك الاطّلاع على إحصاءات مختلفة تم رصدها ووضع نماذج لها حول تجربتك الجارية، بما في ذلك ما يلي:

   • الفرق بالنسبة المئوية مقارنةً بالقيمة المرجعية: يشير ذلك إلى مقياس لتحسين مقياس معيّن لخيار منتج معيّن مقارنةً بالمرجع. يتم احتسابه من خلال مقارنة نطاق قيم السعر المتغير بنطاق قيم السعر الأساسي.
   • احتمالية تجاوز المعدّل المرجعي: الاحتمالية المقدَّرة بأنّ أحد التصاميم المتغيرة معيّنٍ يتجاوز المعدّل المرجعي للمقياس المحدّد.
   • observed_metric لكل مستخدم: استنادًا إلى نتائج التجربة، هذا هو النطاق المتوقّع الذي ستقع فيه قيمة المقياس بمرور الوقت.
   • إجمالي observed_metric: القيمة التراكمية المرصودة ل القيمة الأساسية أو الصيغة. تُستخدَم القيمة لقياس مدى جودة أداء كل صيغة من التجربة، وتُستخدَم لاحتساب التحسين ونطاق القيمة واحتمالية تجاوز القيم المرجعية واحتمالية أن تكون الصيغة الأفضل. استنادًا إلى المقياس الذي يتم قياسه، قد يتم تصنيف عمود "المدّة لكل مستخدم" أو "الأرباح لكل مستخدم" أو "نسبة الاحتفاظ" أو "نسبة الإحالات الناجحة".

3. بعد تنفيذ تجربتك لبعض الوقت (7 أيام على الأقل لكلّ من FCM وIn-App Messaging أو 14 يومًا لكلّ من Remote Config)، تشير البيانات في هذه الصفحة إلى الصيغة "الأكثر نجاحًا"، إن توفّرت. تصاحب بعض القياسات مخطط شريطي يعرض البيانات بتنسيق مرئي.

طرح التجربة لجميع المستخدمين

بعد تنفيذ التجربة لفترة كافية لكي تتوفّر لديك صيغة "رائدة" أو صيغة تحقّق أفضل أداء في ما يتعلّق بمقياس هدفك، يمكنك طرح التجربة على جميع المستخدمين. يتيح لك ذلك تحديد صيغة لنشرها لجميع المستخدمين من الآن فصاعدًا. حتى في حال عدم توفّر صيغة واضحة تحقّق أفضل أداء في تجربتك، لا يزال بإمكانك اختيار طرح صيغة لجميع المستخدمين.

1. في قسم التفاعل من قائمة التنقّل في Firebase وحدة التحكّم، انقر على A/B Testing.
2. انقر على مكتمل أو جارٍ، ثمّ انقر على التجربة التي تريد طرحها لجميع المستخدمين، ثمّ انقر على رمز قائمة السياقات (more_vert) طرح الصيغة.

3. يمكنك طرح تجربتك لجميع المستخدمين من خلال إجراء أحد الإجراءات التالية:

   • بالنسبة إلى التجربة التي تستخدِم أداة إنشاء الإشعارات، استخدِم مربّع حوار رسالة الطرح لإرسال الرسالة إلى المستخدِمين المستهدفين المتبقّين الذين لم يكونوا جزءًا من التجربة.
   • بالنسبة إلى تجربة Remote Config، اختَر صيغة لتحديد قيَم مَعلمة Remote Config التي تريد تعديلها. تتم إضافة معايير الاستهداف التي تم تحديدها عند إنشاء التجربة كشرط جديد في نموذجك، وذلك للتأكّد من أنّ عملية الطرح لن تؤثر إلا في المستخدِمين الذين تستهدفهم التجربة. بعد النقر على مراجعة في صفحة "الإعداد عن بُعد" لمراجعة التغييرات، انقر على نشر التغييرات لإكمال عملية الطرح.
   • بالنسبة إلى تجربة In-App Messaging، استخدِم مربّع الحوار لتحديد الصيغة التي يجب طرحها كحملة In-App Messaging مستقلة. بعد اختيار الإجراء، ستتم إعادة توجيهك إلى شاشة كتابة الرسالة لتعديلها (إذا لزم الأمر) قبل نشرها.

توسيع نطاق تجربة

إذا تبيّن لك أنّ إحدى التجارب لا تجذب عددًا كافيًا من المستخدمين A/B Testing لتتمكّن من تحديد تجربة فائزة، يمكنك زيادة توزيع تجربتك للوصول إلى نسبة مئوية أكبر من قاعدة مستخدمي التطبيق.

1. في قسم التفاعل من قائمة التنقّل في Firebase وحدة التحكّم، انقر على A/B Testing.
2. اختَر التجربة الجارية التي تريد تعديلها.
3. في نظرة عامة على التجربة، انقر على قائمة السياقات (more_vert)، ثم انقر على تعديل التجربة قيد التنفيذ.
4. يعرض مربّع الحوار الاستهداف خيارًا لزيادة النسبة المئوية للمستخدمين المشاركين في التجربة الجارية. اختَر رقمًا أكبر من النسبة المئوية الحالية وانقر على نشر. سيتم طرح التجربة على النسبة المئوية للمستخدمين التي حدّدتها.

تكرار تجربة أو إيقافها

1. في قسم التفاعل من قائمة التنقّل في Firebase وحدة التحكّم، انقر على A/B Testing.
2. انقر على مكتملة أو قيد التشغيل، ومرِّر مؤشر الماوس فوق تجربتك، وانقر على قائمة السياقات (more_vert)، ثمّ انقر على تكرار التجربة أو إيقاف التجربة.

استهداف المستخدِمين

يمكنك استهداف المستخدِمين المطلوب تضمينهم في تجربتك باستخدام معايير استهداف المستخدِمين التالية.

‫A/B Testing مقياس

عند إنشاء تجربتك، عليك اختيار مقياس أساسي أو مقياس هدف يتم استخدامه لتحديد الصيغة الفائزة. يجب أيضًا تتبُّع مقاييس أخرى ل help you better understand each experiment variant's performance and track important trends that may differ for each variant, like user retention, app stability and in-app purchase revenue. يمكنك تتبُّع ما يصل إلى خمسة مقاييس غير مرتبطة بالهدف في تجربتك.

على سبيل المثال، لنفترض أنّك تستخدم Remote Config لإطلاق مسارَين مختلفَين للألعاب في تطبيقك وتريد تحسين عمليات الشراء داخل التطبيق وأرباح الإعلانات، ولكنّك تريد أيضًا تتبُّع الثبات والحفاظ على المستخدمين لكل صيغة. في هذه الحالة، ننصحك باختيار إجمالي الأرباح المقدَّرة كمقياس لهدفك لأنّه يتضمّن أرباح عمليات الشراء داخل التطبيق وأرباح الإعلانات، ثم يمكنك إضافة ما يلي ضمن المقاييس الأخرى لتتبُّعها:

• لتتبُّع معدل الحفاظ على المستخدمين يوميًا وأسبوعيًا، أضِفالحفاظ على المستخدمين (من يومَين إلى 3 أيام) والحفاظ على المستخدمين (من 4 إلى 7 أيام).
• لمقارنة استقرار عمل مسارَي اللعبة، أضِف المستخدمون الذين لم يواجهوا أي تعطّل.
• للاطّلاع على عروض أكثر تفصيلاً لكل نوع من أنواع الأرباح، أضِف الأرباح من عمليات الشراء والأرباح المقدَّرة من الإعلانات.

تقدم الجداول التالية تفاصيل عن كيفية حساب مقاييس الأهداف والمقاييس الأخرى.

مقاييس الهدف

المقاييس الأخرى

تصدير بيانات 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 في وحدة تحكّم Firebase
2. الوصول إلى بيانات A/B Testing باستخدام BigQuery
3. الاطّلاع على نماذج طلبات البحث

تفعيل عملية تصدير BigQuery لـ "Google Analytics" في وحدة تحكُّم Firebase

إذا كنت مشتركًا في خطة Spark، يمكنك استخدام وضع الحماية BigQuery للوصول إلى BigQuery بدون أي تكلفة، مع مراعاة حدود وضع الحماية. اطّلِع على مقالة الأسعار وBigQuery وضع الحماية للحصول على مزيد من المعلومات.

أولاً، تأكَّد من تصدير بيانات Analytics إلى BigQuery:

1. افتح علامة التبويب عمليات الدمج، التي يمكنك الوصول إليها باستخدام settings > إعدادات المشروع في وحدة تحكّم Firebase.
2. إذا كنت تستخدم BigQuery مع خدمات Firebase أخرى، انقر على إدارة. بخلاف ذلك، انقر على ربط.
3. راجِع لمحة عن ربط Firebase بخدمة BigQuery، ثم انقر على التالي.
4. في قسم إعداد الدمج، فعِّل مفتاح التبديل Google Analytics.

5. اختَر منطقة واختَر إعدادات التصدير.

6. انقر على ربط بـ BigQuery.

استنادًا إلى الطريقة التي اخترتها لتصدير البيانات، قد يستغرق توفُّر الجداول ما يصل إلى يوم. لمزيد من المعلومات حول تصدير بيانات المشروع إلى BigQuery، يُرجى الاطّلاع على تصدير بيانات المشروع إلى BigQuery.

الوصول إلى بيانات A/B Testing في BigQuery

قبل إجراء طلب بحث عن بيانات لتجربة محدّدة، يجب الحصول على بعض أو كل ما يلي لاستخدامه في طلب البحث:

• رقم تعريف التجربة: يمكنك الحصول على هذا الرقم من عنوان URL لصفحة نظرة عامة على التجربة. على سبيل المثال، إذا كان عنوان URL يبدو على النحو التالي: https://console.firebase.google.com/project/my_firebase_project/config/experiment/results/25، يكون رقم تعريف التجربة هو 25.
• رقم تعريف الموقع Google Analytics: هو رقم تعريف الموقع المكوّن من 9 أرقام Google Analytics. يمكنك العثور على هذا الجدول ضمن Google Analytics، ويظهر أيضًا في BigQuery عند توسيع اسم مشروعك لعرض اسم جدول أحداث Google Analytics (project_name.analytics_000000000.events).
• تاريخ التجربة: لإنشاء طلب بحث أسرع وأكثر فعالية، من الجيد حصر طلبات البحث في أقسام جدول الحدثGoogle Analytics اليومية التي تحتوي على بيانات تجربتك، وهي الجداول المحدَّدة بلاحقة YYYYMMDD. بالتالي، إذا تم تنفيذ تجربتك في الفترة من 2 شباط (فبراير) 2024 إلى 2 أيار (مايو) 2024، عليك تحديد _TABLE_SUFFIX between '20240202' AND '20240502'. على سبيل المثال، اطّلِع على اختيار قيم تجربة معيّنة.
• أسماء الأحداث: تتوافق هذه الأسماء عادةً مع مقاييس الأهداف التي ضبطتها في التجربة. على سبيل المثال، أحداث in_app_purchase أو ad_impression أو user_retention.

بعد جمع المعلومات التي تحتاجها لإنشاء طلب البحث:

1. افتح BigQuery في وحدة تحكّم Google Cloud.
2. اختَر مشروعك، ثم اختَر إنشاء طلب بحث بلغة الاستعلامات البنيوية (SQL).
3. أضِف طلب البحث. للاطّلاع على أمثلة على طلبات البحث التي يمكن تنفيذها، يُرجى الاطّلاع على مقالة استكشاف أمثلة على طلبات البحث.
4. انقر على تشغيل.

طلب بيانات التجربة باستخدام طلب البحث الذي تم إنشاؤه تلقائيًا في وحدة تحكُّم Firebase

إذا كنت تستخدم خطة Blaze، تقدّم صفحة نظرة عامة على التجربة مثالاً على طلب بحث يعرض اسم التجربة والصيغ وأسماء الأحداث ومقدار عدد الأحداث للتجربة التي تطّلع عليها.

للحصول على الاستعلام الذي تم إنشاؤه تلقائيًا وتنفيذه:

1. من وحدة تحكّم Firebase، افتح A/B Testing واختَر تجربة A/B Testing التي تريد الاستعلام عنها لفتح نظرة عامة على التجربة.
2. من قائمة "الخيارات"، ضِمن BigQuery الدمج، اختَر طلب بيانات التجربة. يؤدي ذلك إلى فتح مشروعك في BigQuery ضمن وحدة تحكّم Google Cloud، كما يوفّر طلب بحث أساسيًا يمكنك استخدامه لطلب البحث عن بيانات تجربتك.

يعرض المثال التالي طلب بحث تم إنشاؤه لتجربة تتضمّن ثلاثة صِيَغ (بما في ذلك السعر الأساسي) باسم "تجربة الترحيب بالشتاء". ويعرض اسم التجربة النشطة واسم الصيغة والحدث الفريد و عدد الأحداث لكل حدث. يُرجى العِلم أنّ أداة إنشاء طلبات البحث لا تحدّد اسم مشروعك في اسم الجدول، لأنّها تفتح مباشرةً ضمن مشروعك.

  /*
    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

للحصول على أمثلة إضافية على طلبات البحث، انتقِل إلى الاطّلاع على أمثلة على طلبات البحث.

أمثلة على طلبات البحث في ميزة "استكشاف"

تقدِّم الأقسام التالية أمثلة على طلبات البحث التي يمكنك استخدامها لاستخراج بيانات تجربة A/B Testing من جداول أحداث Google Analytics.

استخراج قيم الانحراف المعياري للشراء والتجربة من جميع التجارب

يمكنك استخدام بيانات نتائج التجربة للتحقّق بشكل مستقل من نتائج Firebase A/B Testing. تستخرج عبارة BigQuery SQL التالية صيغ تجربت ، وعدد المستخدِمين الفريدين في كل صيغة، وتُجمِّع إجمالي الأرباح من حدثَي in_app_purchase وecommerce_purchase، والانحرافات المعيارية لجميع التجارب ضمن النطاق الزمني المحدّد كتاريخَي _TABLE_SUFFIX البدء والانتهاء. يمكنك استخدام البيانات التي تحصل عليها من طلب البحث هذا مع أداة إنشاء الأهمية الإحصائية لاختبارات t أحادية الطرف للتحقّق من أنّ النتائج التي يوفّرها Firebase تتطابق مع تحليلك الخاص.

لمزيد من المعلومات حول طريقة احتساب A/B Testing للاستنتاج، يُرجى الاطّلاع على القسم تفسير نتائج الاختبار.

  /*
    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;

اختيار قيم تجربة معيّنة

يوضّح مثال طلب البحث التالي كيفية الحصول على بيانات تجربتَين معيّنتَين في BigQuery. يعرض نموذج الاستعلام هذا اسم التجربة، وأسماء الأسعار المتغيرة (بما في ذلك السعر الأساسي)، وأسماء الأحداث، وعدد الأحداث.

  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