查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

یک صفحه خوش آمدگویی را سفارشی کنید

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

با استفاده از این دو ویژگی با هم، می توانید صفحه خوش آمدگویی برنامه خود را برای کاربر تکراری بر اساس ترجیحات یا فعالیت آنها در برنامه خود سفارشی کنید.

این راهنما شما را از طریق فرآیند ایجاد صفحه نمایش "بازگشت خوش آمدید" شخصی خود در اندروید راهنمایی می کند.

برای شروع، به یک برنامه Android متصل به پروژه Firebase نیاز دارید. اگر قبلاً ندارید، برای اتصال برنامه خود به شروع به کار برای Android مراجعه کنید.

مروری بر پیاده سازی

پیاده سازی صفحه خوش آمدگویی شخصی برنامه شما شامل 3 مرحله کلی است:

  1. پیکربندی از راه دور را تنظیم کنید تا پارامترهایی را برای عناصر شخصی سازی شده نگه دارد. برای مثال، ممکن است پیام صفحه خوش آمد گویی را به عنوان یک پارامتر ذخیره کنید. به این ترتیب می توانید پیام را بدون انتشار مجدد برنامه خود به روز کنید.
  2. Analytics را برای تعریف مخاطبان و/یا ویژگی های کاربر برای Remote Config تنظیم کنید تا کاربران شما را هدف قرار دهد. هر دو ویژگی را می توان برای هدف گیری استفاده کرد. با این حال، تفاوت های مهمی بین آنها وجود دارد. مزایای نسبی هر کدام بعداً در این راهنما مورد بحث قرار می گیرد.
  3. شرایط Remote Config را پیکربندی کنید تا پارامتر خود را بر اساس مخاطبان Analytics یا ویژگی‌های کاربری که تنظیم کرده‌اید سفارشی کنید.

تنظیم پارامترها در Remote Config

هنگامی که عناصر برنامه خود را که می خواهید سفارشی کنید شناسایی کردید، از Remote Config برای ذخیره پارامترها استفاده کنید. در ادامه این راهنما، شخصی‌سازی پیام صفحه خوش‌آمدگویی را بررسی می‌کنیم.

در کنسول Firebase چه باید کرد

  1. به صفحه پارامتر Remote Config در کنسول Firebase بروید. اگر هرگز Remote Config را در برنامه خود پیکربندی نکرده اید، روی Add Your First Parameter کلیک کنید.
  2. یک کلید پارامتر و مقدار پیش فرض را پر کنید. برای مثال welcome_message و Welcome to this sample app .

    پیکربندی پارامتر پیکربندی از راه دور.

  3. روی انتشار تغییرات کلیک کنید.

در برنامه اندروید چه باید کرد

  1. برای خواندن و نمایش پارامتری که به برنامه خود در کنسول 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 شما را از طریق اجرای نمونه برنامه کاربردی راهنمایی می‌کند.

  2. حالت توسعه دهنده را روشن کنید تا تغییرات پیکربندی را بلافاصله در حین آزمایش مشاهده کنید.

تست کنید که کار می کند

  1. برنامه خود را باز کنید و مطمئن شوید که مقدار فعلی پارامتر را در Remote Config UI نشان می دهد.
  2. مقدار را در کنسول تغییر دهید و روی Publish Changes کلیک کنید
  3. برنامه خود را مجددا راه اندازی کنید. مقدار پارامتر جدید باید نشان داده شود.

مخاطبان Analytics یا ویژگی های کاربر را تنظیم کنید

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

در کنسول Firebase چه باید کرد

  1. به صفحه دارایی کاربر Analytics در کنسول Firebase بروید. روی New User Property کلیک کنید.
  2. به ویژگی کاربر یک نام و توضیحات بدهید. برای مثال، اگر برنامه‌ای را بر اساس اینکه کاربر سگ‌ها یا گربه‌ها را ترجیح می‌دهد سفارشی می‌کردید، ممکن است نام آن را animal_preference .

    پیکربندی ویژگی کاربر Analytics.

  3. روی ایجاد کلیک کنید.

در برنامه اندروید چه باید کرد

  1. مراحل Set User Properties را دنبال کنید تا یاد بگیرید که ویژگی کاربر خود را در برنامه خود تنظیم کنید. به عنوان مثال، ممکن است از یک کاربر بپرسید که آیا گربه یا سگ را ترجیح می دهد و بر این اساس یک مقدار رشته تعیین کنید. همانطور که قبلاً در بخش قبلی انجام داده اید، می توانید مراحل ثبت ملک خود را در کنسول رد کنید.
  2. مراحل را در Debugging Events دنبال کنید تا حالت اشکال زدایی را برای برنامه خود فعال کنید.

تست کنید که کار می کند

  1. برنامه خود را باز کنید و به جایی بروید که ویژگی کاربر شما تنظیم شده است.
  2. صفحه Analytics DebugView را در کنسول Firebase باز کنید.
  3. نگاه کنید تا ببینید آیا ویژگی های کاربر تنظیم شده است (ممکن است چند دقیقه تاخیر قبل از نمایش چیزی وجود داشته باشد).

پیکربندی شرایط پیکربندی از راه دور

اکنون که برنامه شما دارای پارامترهایی است که می توان آنها را پیکربندی کرد و ویژگی های کاربر (یا مخاطبان) را برای استفاده به عنوان متغیر دارد، می توانید شرایطی برای شخصی سازی مقادیر پارامترهای خود ایجاد کنید.

در کنسول Firebase چه باید کرد

  1. در کنسول Firebase به Remote Config بروید.
  2. برای ویرایش روی پارامتر خود کلیک کنید.
  3. روی افزودن مقدار برای شرط کلیک کنید.
  4. تعریف شرط جدید را انتخاب کنید.
  5. برای وضعیت خود یک نام بگذارید. برای مثال، «گربه‌ها را ترجیح می‌دهد» تا اولویت کاربر را از قبل نشان دهد.
  6. در قسمت Applies if ، ویژگی کاربر (یا کاربر در مخاطب اگر مخاطبی در Analytics ایجاد کرده‌اید) را انتخاب کنید و پارامتر خود را انتخاب کنید و یک رابطه شرطی با مقادیر پارامتر خود تعریف کنید.

    یک شرط پیکربندی از راه دور جدید.

  7. روی ایجاد شرط کلیک کنید.

  8. مقداری را وارد کنید تا شرایط جدید را منعکس کند. به عنوان مثال، پیام خوشامدگویی "گربه ها را ترجیح می دهد" می تواند "میو!" باشد.

  9. برای ذخیره تغییرات خود روی Update کلیک کنید.

  10. برای فعال کردن شرایط و مقادیر جدید در برنامه خود، روی انتشار تغییرات کلیک کنید.

تست کنید که کار می کند

  1. برنامه خود را باز کنید و به جایی بروید که ویژگی کاربر شما تنظیم شده است.
  2. صفحه Analytics DebugView را در کنسول Firebase باز کنید.
  3. نگاه کنید تا ببینید آیا ویژگی های کاربر تنظیم شده است (ممکن است چند دقیقه تاخیر قبل از نمایش چیزی وجود داشته باشد).
  4. برنامه خود را مجددا راه اندازی کنید و بررسی کنید که عناصر شخصی شما تنظیم شده است.