سفارشی‌سازی پیام‌های «پیام‌رسانی درون‌برنامه‌ای Firebase»


«پیام‌رسانی درون‌برنامه‌ای Firebase» مجموعه‌ای مفید از رفتارها و انواع پیام ازپیش پیکربندی‌شده با ظاهر و احساس پیش‌فرض ارائه می‌دهد، اما در برخی موارد ممکن است بخواهید رفتارها و محتوای پیام را گسترش دهید. «پیام‌رسانی درون‌برنامه‌ای» به شما امکان می‌دهد به پیام‌ها کنش اضافه کنید و ظاهر و حس‌وحال پیام را سفارشی‌سازی کنید.

افزودن کنش به پیام

با کنش‌ها می‌توانید از پیام‌های درون‌برنامه‌ای خود برای هدایت کاربران به وب‌سایت یا صفحه خاصی در برنامه‌تان استفاده کنید.

‫Firebase In-App Messaging از مدیریت‌کننده‌های پیوند برای پردازش کنش‌ها استفاده می‌کند. «کیت توسعه نرم‌افزار» می‌تواند از تعدادی مدیریت‌کننده استفاده کند، بنابراین اگر برنامه‌تان ازقبل مدیریت‌کننده‌ای داشته باشد، Firebase In-App Messaging می‌تواند بدون نیاز به راه‌اندازی بیشتر از آن استفاده کند. اگر هنوز گرداننده ندارید، می‌توانید از Firebase Dynamic Links استفاده کنید. برای کسب اطلاعات بیشتر، ایجاد پیوندهای پویا در iOS را بخوانید.

بااستفاده از کنسول Firebase، کنش را به پیامتان اضافه کنید

وقتی برنامه‌تان کنترل‌کننده پیوند داشته باشد، آماده‌اید تا پویشی با کنش بسازید.

  1. در کنسول Firebase، به DevOps و تعامل > پیام‌رسانی بروید.

  2. گردش کار راه‌اندازی پویش جدید راه‌اندازی کنید:

    • اگر این اولین پویش شما است:

      1. روی ایجاد اولین پویش کلیک کنید.
      2. پیام‌های درون‌برنامه‌ای Firebase را انتخاب کنید و روی ایجاد کردن کلیک کنید.

    • اگر قبلاً پویش‌هایی ایجاد کرده‌اید:

      1. در برگه پویش‌ها، روی پویش جدید کلیک کنید.
      2. پیام‌رسانی درون‌برنامه‌ای را انتخاب کنید.

  3. برای راه‌اندازی پویش، دستورالعمل‌های روی صفحه را دنبال کنید.

  4. کارت، نوشتار دکمه، و کنش دکمه، کنش تصویر، یا کنش برنمای ارائه دهید، که در آن کنش یک پیوند عمیق مرتبط است.

قالب کنش به چیدمان پیامی که انتخاب می‌کنید بستگی دارد. «حالت‌های» کنش دکمه‌هایی با محتوای نوشتار دکمه، رنگ نوشتار، و رنگ پس‌زمینه سفارشی‌سازی‌پذیر دریافت می‌کنند. از طرف دیگر، تصاویر و برنماهای برتر تعاملی می‌شوند و با ضربه زدن، کنش مشخص‌شده را فرا می‌خوانند.

اصلاح ظاهر و احساس پیام

Firebase In-App Messaging به شما امکان می‌دهد نمایش پیام‌ها را سفارشی‌سازی کنید تا نحوه پرداز کردن برنامه برای چیدمان پیام‌ها، سبک‌های قلم، شکل دکمه‌ها، و جزئیات دیگر تغییر کند. دو روش برای اصلاح نمایش پیام وجود دارد: اصلاح نمایش‌های پیش‌فرض Firebase In-App Messaging یا ایجاد کتابخانه نمایش پیام خودتان از ابتدا.

توجه: این محصول در هدف‌های macOS،‏ Mac Catalyst،‏ App Clip، یا watchOS دردسترس نیست.

اصلاح نمایش‌های پیش‌فرض

ساده‌ترین راه برای سفارشی‌سازی پیام‌هایتان این است که از Firebase In-App Messagingکد نمایش پیام پیش‌فرض استفاده کنید.

همسانه‌سازی مخزن firebase-ios-sdk

برای شروع، جدیدترین نسخه پخش مخزن firebase-ios-sdk را شبیه‌سازی کنید و دایرکتوری InAppMessaging را باز کنید.

نوع پیام را برای اصلاح انتخاب کنید

با شبیه‌سازی مخزن، می‌توانید هریک یا همه Firebase In-App Messaging نوع پیام را تغییر دهید: Card، Modal، Banner، و ImageOnly. هر نوع با چیدمان پیام در جریان ساخت پویش Firebase In-App Messaging مطابقت دارد.

بنابراین، هر نوع به مجموعه متفاوتی از داده‌ها دسترسی دارد که توسط گزینه‌های سفارشی‌سازی پویش در کنسول Firebase تعیین می‌شود:

نوع titleText bodyText رنگ نوشتار backgroundColor imageData دکمه کنش secondaryActionButton
کارت
مودال
بنر
فقط تصویر

اصلاح کد پردازش نمایش پیام

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

هنگام اصلاح نمایش پیام، دو نکته اصلی وجود دارد که باید به آن‌ها توجه کنید:

  • دایرکتوری‌های نوع پیام: هر نوع پیام دایرکتوری جداگانه‌ای دارد با فایل‌هایی که منطق آن نوع را تعیین می‌کنند:
  • تابلوی داستان: کتابخانه InAppMessaging همچنین فایل .storyboard دارد که به تعریف کردن میانای کاربر برای هر سه نوع پیام کمک می‌کند:

فایل‌ها را در فهرست‌های راهنمای انواع پیام دلخواهتان و بخش‌های مربوطه .storyboard اصلاح کنید تا نمایش‌های پیام سفارشی‌تان را ایجاد کنید.

فایل pod را به‌روز کنید تا از کد InAppMessaging اصلاح‌شده استفاده کنید

برای اینکه Firebase In-App Messaging از نمایشگرهای پیام اصلاح‌شده شما به‌جای نمایشگرهای پیش‌فرض استفاده کند، فایل pod را به‌روز کنید تا از کتابخانه سفارشی‌سازی‌شده InAppMessaging استفاده کند: 

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'

# Remove the default InAppMessaging pod:
# pod 'Firebase/InAppMessaging'

# Overwrite it with a version that points to your local copy:
pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/'

end
پس‌از انجام این کار، می‌توانید واحد‌های خود را به‌روزرسانی کنید، برنامه خود را بازسازی کنید، و نمایش‌های پیام سفارشی جدید خود را ببینید.

کتابخانه نمایش پیام خودتان را بسازید

برای ایجاد رابط کاربری برای نمایش پیام‌ها، محدود به کار کردن از کتابخانه InAppMessaging نیستید. همچنین می‌توانید کد خودتان را از ابتدا بنویسید.

کلاسی بسازید که پروتکل InAppMessagingDisplay را پیاده‌سازی کند

‫Firebase In-App Messaging از کلاس InAppMessaging برای مدیریت ارتباطات بین سرورهای Firebase و برنامه شما استفاده می‌کند. آن کلاس نیز به نوبه خود از پروتکل InAppMessagingDisplay برای نمایش پیام‌هایی که دریافت می‌کند استفاده می‌کند. برای ساختن کتابخانه نمایشگر خودتان، کلاسی بنویسید که پروتکل را پیاده‌سازی کند.

تعریف پروتکل و مستندات مربوط به نحوه مطابقت با آن در فایل FIRInAppMessagingDisplay.h کتابخانه InAppMessaging قرار دارد.

برای استفاده از کتابخانه نمایش پیام، messageDisplayComponent را تنظیم کنید

‫InAppMessaging از messageDisplayComponent دارایی برای تعیین اینکه هنگام نمایش پیام‌ها از کدام شیء استفاده کند استفاده می‌کند. آن دارایی را روی شیء کلاس نمایش پیام سفارشی‌تان تنظیم کنید تا Firebase In-App Messaging بداند از کتابخانه شما برای پرداز کردن پیام‌ها استفاده کند:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance