تخصيص شاشة "مرحبًا بك من جديد"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن للمحتوى المخصص أن يسعد المستخدمين ويوفر تجربة من
التفاعل الأول مع التطبيق بناءً على تفضيلاته وسجلّ استخدامه
واللغة. يسمح لك Firebase بتحديد شرائح الجمهور استنادًا إلى
يمكنك Google Analytics مقاييس وتخصيص تطبيقك باستخدام
Firebase Remote Config مباشرةً من وحدة تحكُّم Firebase
باستخدام هاتين الميزتَين معًا، يمكنك تخصيص صفحة الترحيب في تطبيقك من جديد.
للمستخدم المتكرّر بناءً على إعداداته المفضّلة أو نشاطه في تطبيقك.
يرشدك هذا الدليل خلال عملية إنشاء
"مرحبًا من جديد" الشاشة على Android.
للبدء، يجب أن يكون لديك تطبيق Android مرتبط بمشروع على Firebase. في حال حذف
إذا لم يكن لديك حساب، راجع البدء على نظام Android
لربط تطبيقك.
نظرة عامة حول خطوات التنفيذ
يتألف تنفيذ شاشة الترحيب المخصّصة في تطبيقك من 3 خطوات عامة:
- إعداد Remote Config للاحتفاظ بالمعلمات للعناصر المراد وضعها
مخصّصة على سبيل المثال، يمكنك تخزين رسالة شاشة الترحيب
. بهذه الطريقة، يمكنك تعديل الرسالة بدون إعادة نشر تطبيقك.
- إعداد Analytics لتحديد شرائح الجمهور و/أو خصائص المستخدمين
Remote Config لاستهداف المستخدمين. يمكن استخدام كلتا الميزتين
الاستهداف إلا أن هناك اختلافات مهمة بينهما. تشير رسالة الأشكال البيانية
وسنناقش المزايا النسبية لكل منهما لاحقًا في هذا الدليل.
- ضبط شروط Remote Config لتخصيص المَعلمة استنادًا إلى
شرائح الجمهور أو خصائص المستخدِمين التي تُعدّها Analytics
إعداد المعلمات في Remote Config
بعد تحديد عناصر التطبيق التي تريد تخصيصها، استخدم
Remote Config لتخزين المعلَمات. سنستكشف تخصيص واجهة
على الشاشة في بقية هذا الدليل.
الإجراءات المطلوبة في "وحدة تحكُّم Firebase"
- انتقِل إلى المَعلمة Remote Config.
في وحدة تحكّم Firebase. في حال حذف
لم يسبق لك ضبط Remote Config في التطبيق، انقر على إضافة العنصر الأول
المَعلمة
املأ مفتاح مَعلمة وقيمة تلقائية. على سبيل المثال: welcome_message
وWelcome to this sample app
.
ضبط مَعلمة "الإعداد عن بُعد"">
انقر على نشر التغييرات.
ما يجب فعله في تطبيق Android
يمكنك إضافة رمز لقراءة المَعلمة التي أضفتها للتو إلى تطبيقك وعرضها في
وحدة تحكّم "Firebase" على سبيل المثال:
final FirebaseRemoteConfig config = FirebaseRemoteConfig.getInstance();
config.getInstance.fetch(CACHE_EXPIRATION_MS)
.addOnCompleteListener(this, new OnCompleteListener<Void>() {
@Override
public void onComplete(@NonNull Task<Void> task) {
if (task.isSuccessful()) {
config.activateFetched();
String welcomeMessage = config.getString("welcome_message");
}
}
});
يمكنك أيضًا اتّباع الخطوات الواردة في
استخدام Firebase Remote Config على Android
لقراءة وعرض المعلمة التي أنشأتها في وحدة التحكم. إذا حصلت على
، سترشدك جولة تفصيلية حول Android
من خلال نموذج العمل لتنفيذ التطبيق.
تفعيل
وضع المطوِّر
للاطّلاع على تغييرات الإعدادات على الفور أثناء الاختبار.
اختبار إمكانية العمل
- افتح تطبيقك وتأكَّد من أنّه يعرض القيمة الحالية للمَعلمة.
في واجهة مستخدم Remote Config.
- غيِّر القيمة في وحدة التحكّم وانقر على نشر التغييرات.
- أعِد تشغيل التطبيق. من المفترض أن تظهر قيمة المَعلمة الجديدة.
إعداد Analytics شرائح جمهور أو خصائص مستخدمين
في هذه الخطوة، ستستخدم Analytics لتحديد المستخدمين الذين يجب أن يظهروا لهم.
المحتوى المخصص. في هذه الجولة التفصيلية، سنستخدم خاصيّة مستخدم لإجراء ذلك
ولكن يمكنك أيضًا تحديد
الجمهور:
هذه الأساليب متشابهة، ولكن يجب أن تدرك أنه بمجرد إضافة مستخدم
إلى جمهور، فلا يمكنهم تركه أو إزالته. إذا كانت السمة التي تريد
استخدامه للاستهداف، قد يتغير، استخدِم خاصيّة مستخدِم بدلاً من ذلك.
الإجراءات المطلوبة في "وحدة تحكُّم Firebase"
- انتقِل إلى خاصّية المستخدِم Analytics
في وحدة تحكّم Firebase. انقر على خاصّية مستخدِم جديد.
أدخِل اسمًا ووصفًا لخاصيّة المستخدِم. على سبيل المثال، إذا كنت
تخصيص تطبيق بناءً على ما إذا كان المستخدم يفضل الكلاب أم القطط، يمكنك
ونسميه animal_preference
.
ضبط خاصيّة مستخدم "إحصاءات Google"">
انقر على إنشاء.
ما يجب فعله في تطبيق Android
- اتّبِع الخطوات الواردة في قسم ضبط خصائص المستخدمين.
للتعرّف على كيفية إعداد خاصيّة المستخدِم في تطبيقك. على سبيل المثال،
المستخدم عما إذا كان يفضل القطط أم الكلاب وتعيين قيمة سلسلة
وفقًا لذلك. يمكنك تخطّي خطوات تسجيل موقعك في
وحدة التحكم كما قمت بذلك بالفعل في القسم السابق.
- اتّبِع الخطوات الواردة في تصحيح أخطاء الأحداث لتفعيل الميزة.
وضع تصحيح الأخطاء لتطبيقك.
اختبار إمكانية العمل
- افتح تطبيقك وانتقِل إلى مكان ضبط خاصيّة المستخدِم.
- فتح صفحة DebugView Analytics
في وحدة تحكّم Firebase.
- انظر لمعرفة ما إذا كان قد تم ضبط أي خصائص للمستخدمين (قد يكون هناك
إلى الانتظار بضع دقائق قبل أن يظهر أي شيء).
والآن بعد أن أصبح تطبيقك يحتوي على مَعلمات يمكن ضبطها وخصائص المستخدِمين.
(أو شرائح الجمهور) لاستخدامها كمتغيّرات، يمكنك إنشاء شروط لتخصيصها
قيم معاملاتك.
الإجراءات المطلوبة في "وحدة تحكُّم Firebase"
- انتقِل إلى Remote Config.
في وحدة تحكّم Firebase.
- انقر على المَعلمة لتعديلها.
- انقر على إضافة قيمة للشرط.
- انقر على تحديد شرط جديد.
- أدخِل اسمًا لشرطك. على سبيل المثال، "يفضّل القطط" ليعكس المستخدم
تفضيلاً من السابق.
ضمن تنطبق إذا، اختَر خاصّية مستخدِم (أو مستخدِم في الجمهور إذا
أنشأت شريحة جمهور في Analytics)، واخترت المَعلمة
تحديد علاقة شرطية بقيم المعلمات.
حالة "الإعداد عن بُعد"">
انقر على إنشاء شرط.
أدخِل قيمة تعكس الشرط الجديد. على سبيل المثال، تستخدم رسالة الترحيب
بسبب "يفضّل القطط" يمكن أن تكون "ميو!".
انقر على تعديل لحفظ التغييرات.
انقر على نشر التغييرات لتفعيل الشروط والقيم الجديدة في
التطبيق.
اختبار إمكانية العمل
- افتح تطبيقك وانتقِل إلى مكان ضبط خاصيّة المستخدِم.
- فتح صفحة DebugView Analytics
في وحدة تحكّم Firebase.
- انظر لمعرفة ما إذا كان قد تم ضبط أي خصائص للمستخدمين (قد يكون هناك
إلى الانتظار بضع دقائق قبل أن يظهر أي شيء).
- أعِد تشغيل التطبيق وتأكَّد من ضبط العناصر المخصّصة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["Personalized content can delight your users and provide an experience from the\nvery first interaction with your app based on their preferences, usage history,\nand locale. Firebase allows you to define audiences based on\nGoogle Analytics metrics and customize your application with\nFirebase Remote Config directly from the Firebase console.\n\nUsing these two features together, you can customize your app's welcome back\nscreen for a repeat user based on their preferences or activity in your app.\n\nThis guide walks you through the process to create your own personalized\n\"welcome back\" screen on Android.\n\nTo get started, you'll need an Android app connected to a Firebase project. If\nyou don't already have one, see [Get started for Android](/docs/android/setup)\nto connect your app.\n\nImplementation overview\n\nImplementing your app's personalized welcome screen consists of 3 broad steps:\n\n1. **Set up Remote Config to hold parameters for the elements to be\n personalized.** For example, you might store the welcome screen message as a parameter. This way you can update the message without republishing your app.\n2. **Set up Analytics to define audiences and/or user properties for\n Remote Config to target your users.** Both features can be used for targeting; however, there are important differences between them. The relative advantages of each are discussed later in this guide.\n3. **Configure Remote Config conditions to customize your parameter based on\n the Analytics audiences or user properties you set up.**\n\nSet up parameters in Remote Config\n\nOnce you identify the elements of your app you want to customize, use\nRemote Config to store parameters. We'll explore personalizing the welcome\nscreen message in the rest of this guide.\n\nWhat to do in the Firebase console\n\n1. Go to the [Remote Config parameter](https://console.firebase.google.com/project/_/config) page in the Firebase console. If you've never configured Remote Config in your app, click **Add Your First\n Parameter**.\n2. Fill out a parameter key and default value. For example, `welcome_message`\n and `Welcome to this sample app`.\n\n Remote Config parameter configuration.\"\\\u003e\n3. Click **Publish Changes**.\n\nWhat to do in the Android app\n\n1. Add code to read and display the parameter you just added to your app in the\n Firebase console. For example:\n\n final FirebaseRemoteConfig config = FirebaseRemoteConfig.getInstance();\n config.getInstance.fetch(CACHE_EXPIRATION_MS)\n .addOnCompleteListener(this, new OnCompleteListener\u003cVoid\u003e() {\n @Override\n public void onComplete(@NonNull Task\u003cVoid\u003e task) {\n if (task.isSuccessful()) {\n config.activateFetched();\n\n String welcomeMessage = config.getString(\"welcome_message\");\n }\n }\n });\n\n You can also follow the steps in\n [Use Firebase Remote Config on Android](/docs/remote-config/get-started?platform=android)\n to read and display the parameter that you created in the console. If you get\n stuck, the [Android walkthrough](/docs/remote-config/android) guides you\n through the working sample app implementation.\n2. Turn on\n [developer mode](/docs/reference/android/com/google/firebase/remoteconfig/FirebaseRemoteConfigSettings.Builder#setDeveloperModeEnabled(boolean))\n to see config changes immediately while testing.\n\nTest that it works\n\n1. Open your app and make sure that it shows the current value of the parameter in the [Remote Config UI](https://console.firebase.google.com/project/_/config).\n2. Change the value in the console and click **Publish Changes**\n3. Restart your app. The new parameter value should be shown.\n\nSet up Analytics audiences or user properties\n\nIn this step you'll use Analytics to define the users who should see\npersonalized content. In this walkthrough, we'll use a user property to do this\nbut you could also define an\n[Audience](//support.google.com/firebase/answer/6317509?hl=en&ref_topic=6317489).\nThese approaches are similar, but you should be aware that once a user is added\nto an Audience, they cannot leave it or be removed. If the attribute you want to\nuse for targeting could change, use a user property instead.\n\nWhat to do in the Firebase console\n\n1. Go to the [Analytics user property](https://console.firebase.google.com/project/_/analytics/userproperty) page in the Firebase console. Click **New User Property**.\n2. Give the user property a name and description. For example, if you were\n customizing an app based on whether a user prefers dogs or cats, you might\n name it `animal_preference`.\n\n Analytics user property configuration.\"\\\u003e\n3. Click **Create**.\n\nWhat to do in the Android app\n\n1. Follow the steps in [Set User Properties](/docs/analytics/android/properties#set_user_properties) to learn to set your user property in your application. For example, you might ask a user if they prefer cats or dogs and set a string value accordingly. You can skip over the steps to register your property in the console as you've already done that in the previous section.\n2. Follow the steps in [Debugging Events](/docs/analytics/debugview) to enable debug mode for your app.\n\nTest that it works\n\n1. Open your app and navigate to where your user property is set.\n2. Open the [Analytics DebugView page](https://console.firebase.google.com/project/_/analytics/debugview) in the Firebase console.\n3. Look to see if any user properties have been set (there might be a few minutes of delay before anything shows up).\n\nConfigure Remote Config conditions\n\nNow that your app has parameters that can be configured, and user properties\n(or audiences) to use as variables, you can create conditions to personalize\nthe values of your parameters.\n\nWhat to do in the Firebase console\n\n1. Go to [Remote Config](https://console.firebase.google.com/project/_/config) in the Firebase console.\n2. Click your parameter to edit it.\n3. Click **Add value for condition**.\n4. Select **Define new condition**.\n5. Give your condition a name. For example, \"Prefers cats\" to reflect the user preference from earlier.\n6. Under **Applies if** , select **User property** (or **User in audience** if\n you created an Audience in Analytics), and select your parameter, and\n define a conditional relationship with your parameter values.\n\n Remote Config condition.\"\\\u003e\n7. Click **Create condition**.\n\n8. Enter a value to reflect the new condition. For example, the welcome message\n for \"Prefers cats\" could be \"Meow!\".\n\n9. Click **Update** to save your changes.\n\n10. Click **Publish Changes** to enable the new conditions and values in your\n app.\n\nTest that it works\n\n1. Open your app and navigate to where your user property is set.\n2. Open the [Analytics DebugView page](https://console.firebase.google.com/project/_/analytics/debugview) in the Firebase console.\n3. Look to see if any user properties have been set (there might be a few minutes of delay before anything shows up).\n4. Restart your app and verify that your personalized elements have been set."]]