یک صفحه خوش آمدگویی را سفارشی کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
محتوای شخصی‌سازی‌شده می‌تواند کاربران شما را خوشحال کند و تجربه‌ای را از همان اولین تعامل با برنامه شما بر اساس اولویت‌ها، سابقه استفاده و موقعیت مکانی آنها ارائه دهد. Firebase به شما امکان می دهد مخاطبان را بر اساس معیارهای Google Analytics تعریف کنید و برنامه خود را با Firebase Remote Config مستقیماً از کنسول Firebase سفارشی کنید.
با استفاده از این دو ویژگی با هم، می توانید صفحه خوش آمدگویی برنامه خود را برای کاربر تکراری بر اساس ترجیحات یا فعالیت آنها در برنامه خود سفارشی کنید.
این راهنما شما را از طریق فرآیند ایجاد صفحه نمایش "بازگشت خوش آمدید" شخصی سازی شده خود در اندروید راهنمایی می کند.
برای شروع، به یک برنامه Android متصل به پروژه Firebase نیاز دارید. اگر قبلاً ندارید، برای اتصال برنامه خود به شروع به کار برای Android مراجعه کنید.
مروری بر پیاده سازی
پیاده سازی صفحه خوش آمدگویی شخصی برنامه شما شامل 3 مرحله کلی است:
- Remote Config را برای نگه داشتن پارامترهایی برای شخصی سازی عناصر تنظیم کنید. به عنوان مثال، ممکن است پیام صفحه خوش آمد گویی را به عنوان یک پارامتر ذخیره کنید. به این ترتیب می توانید پیام را بدون انتشار مجدد برنامه خود به روز کنید.
- Analytics برای تعریف مخاطبان و/یا ویژگی های کاربر برای Remote Config تنظیم کنید تا کاربران شما را هدف قرار دهد. هر دو ویژگی را می توان برای هدف گیری استفاده کرد. با این حال، تفاوت های مهمی بین آنها وجود دارد. مزایای نسبی هر کدام بعداً در این راهنما مورد بحث قرار می گیرد.
- شرایط Remote Config را پیکربندی کنید تا پارامتر خود را بر اساس مخاطبان Analytics یا ویژگی‌های کاربری که تنظیم کرده‌اید سفارشی کنید.
پارامترها را در Remote Config تنظیم کنید
هنگامی که عناصر برنامه خود را که می خواهید سفارشی کنید شناسایی کردید، از Remote Config برای ذخیره پارامترها استفاده کنید. در ادامه این راهنما، شخصی‌سازی پیام صفحه خوش‌آمدگویی را بررسی می‌کنیم.
در کنسول Firebase چه باید کرد
- به صفحه پارامتر Remote Config در کنسول Firebase بروید. اگر هرگز Remote Config در برنامه خود پیکربندی نکرده اید، روی Add Your First Parameter کلیک کنید.
یک کلید پارامتر و مقدار پیش فرض را پر کنید. برای مثال welcome_message و Welcome to this sample app .
پیکربندی پارامتر پیکربندی از راه دور.">
روی انتشار تغییرات کلیک کنید.
در برنامه اندروید چه باید کرد
برای خواندن و نمایش پارامتری که به تازگی به برنامه خود در کنسول 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 شما را از طریق اجرای نمونه برنامه کاربردی راهنمایی می‌کند.
حالت توسعه دهنده را روشن کنید تا تغییرات پیکربندی را بلافاصله در حین آزمایش مشاهده کنید.
تست کنید که کار می کند
- برنامه خود را باز کنید و مطمئن شوید که مقدار فعلی پارامتر را در Remote Config UI نشان می دهد.
- مقدار را در کنسول تغییر دهید و روی Publish Changes کلیک کنید
- برنامه خود را مجددا راه اندازی کنید. مقدار پارامتر جدید باید نشان داده شود.
مخاطبان Analytics یا ویژگی های کاربر را تنظیم کنید
در این مرحله Analytics برای تعریف کاربرانی که باید محتوای شخصی‌سازی شده را ببینند، استفاده می‌کنید. در این راهنما، از یک ویژگی کاربر برای انجام این کار استفاده می‌کنیم، اما می‌توانید یک Audience را نیز تعریف کنید. این رویکردها مشابه هستند، اما باید توجه داشته باشید که وقتی کاربر به یک مخاطب اضافه می‌شود، نمی‌تواند آن را ترک کند یا حذف شود. اگر مشخصه ای که می خواهید برای هدف گذاری استفاده کنید می تواند تغییر کند، به جای آن از یک ویژگی کاربر استفاده کنید.
در کنسول Firebase چه باید کرد
- به صفحه ویژگی کاربر Analytics در کنسول Firebase بروید. روی New User Property کلیک کنید.
به ویژگی کاربر یک نام و توضیحات بدهید. برای مثال، اگر برنامه‌ای را بر اساس اینکه کاربر سگ‌ها یا گربه‌ها را ترجیح می‌دهد سفارشی می‌کردید، ممکن است نام آن را animal_preference بگذارید.
پیکربندی ویژگی کاربر Analytics.">
روی ایجاد کلیک کنید.
در برنامه اندروید چه باید کرد
- مراحل Set User Properties را دنبال کنید تا یاد بگیرید که ویژگی کاربر خود را در برنامه خود تنظیم کنید. به عنوان مثال، ممکن است از یک کاربر بپرسید که آیا گربه یا سگ را ترجیح می دهد و بر این اساس یک مقدار رشته تنظیم کنید. همانطور که قبلاً در بخش قبلی انجام داده اید، می توانید مراحل ثبت ملک خود را در کنسول رد کنید.
- مراحل را در Debugging Events دنبال کنید تا حالت اشکال زدایی را برای برنامه خود فعال کنید.
تست کنید که کار می کند
- برنامه خود را باز کنید و به جایی بروید که ویژگی کاربر شما تنظیم شده است.
- صفحه Analytics DebugView را در کنسول Firebase باز کنید.
- نگاه کنید تا ببینید آیا ویژگی های کاربر تنظیم شده است (ممکن است چند دقیقه تاخیر قبل از نمایش چیزی وجود داشته باشد).
اکنون که برنامه شما دارای پارامترهایی است که می توان آنها را پیکربندی کرد و ویژگی های کاربر (یا مخاطبان) را برای استفاده به عنوان متغیر دارد، می توانید شرایطی را برای شخصی سازی مقادیر پارامترهای خود ایجاد کنید.
در کنسول Firebase چه باید کرد
- در کنسول Firebase به Remote Config بروید.
- برای ویرایش روی پارامتر خود کلیک کنید.
- برای شرط روی افزودن مقدار کلیک کنید.
- تعریف شرط جدید را انتخاب کنید.
- برای وضعیت خود یک نام بگذارید. برای مثال، «گربه‌ها را ترجیح می‌دهد» تا اولویت کاربر را از قبل منعکس کند.
در قسمت Applies if ، ویژگی کاربر را انتخاب کنید (یا کاربر در مخاطب اگر مخاطبی را در Analytics ایجاد کرده‌اید)، و پارامتر خود را انتخاب کنید و یک رابطه شرطی با مقادیر پارامتر خود تعریف کنید.
شرط پیکربندی از راه دور.">
روی ایجاد شرط کلیک کنید.
مقداری را وارد کنید تا شرایط جدید را منعکس کند. به عنوان مثال، پیام خوشامدگویی برای "گربه ها را ترجیح می دهد" می تواند "میو!" باشد.
برای ذخیره تغییرات خود روی Update کلیک کنید.
برای فعال کردن شرایط و مقادیر جدید در برنامه خود، روی انتشار تغییرات کلیک کنید.
تست کنید که کار می کند
- برنامه خود را باز کنید و به جایی بروید که ویژگی کاربر شما تنظیم شده است.
- صفحه Analytics DebugView را در کنسول Firebase باز کنید.
- نگاه کنید تا ببینید آیا ویژگی های کاربر تنظیم شده است (ممکن است چند دقیقه تاخیر قبل از نمایش چیزی وجود داشته باشد).
- برنامه خود را مجددا راه اندازی کنید و بررسی کنید که عناصر شخصی شده شما تنظیم شده است.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-09-06 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-09-06 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
