«پیام‌رسانی درون‌برنامه‌ای Firebase» مجموعه‌ای مفید از رفتارها و انواع پیام ازپیش‌پیکربندی‌شده با ظاهر و احساس پیش‌فرض ارائه می‌دهد، اما در برخی موارد ممکن است بخواهید رفتارها و محتوای پیام را گسترش دهید. «پیام‌رسانی درون‌برنامه» به شما امکان می‌دهد کنش‌هایی را به پیام‌ها اضافه کنید و ظاهر و حس پیام را سفارشی‌سازی کنید.
افزودن کنش به پیام
با کنش‌ها می‌توانید از پیام‌های درون‌برنامه‌ای برای هدایت کاربران به وب‌سایت یا صفحه‌نمایش خاصی در برنامه‌تان استفاده کنید.
پیاده‌سازی گرداننده پیوند عمیق
Firebase In-App Messaging از گرداننده‌های پیوند برای پردازش کنش‌ها استفاده می‌کند. این کیت توسعه نرم‌افزار می‌تواند از تعدادی گرداننده استفاده کند، بنابراین اگر برنامه‌تان ازقبل گرداننده‌ای داشته باشد، Firebase In-App Messaging می‌تواند بدون هیچ راه‌اندازی دیگری از آن استفاده کند. اگر هنوز گرداننده ندارید، می‌توانید از Firebase Dynamic Links استفاده کنید. برای کسب اطلاعات بیشتر، ایجاد پیوندهای پویا در iOS را بخوانید.
بااستفاده از کنسول Firebase، کنش را به پیامتان اضافه کنید
وقتی برنامه‌تان گرداننده پیوند داشته باشد، آماده‌اید تا پویشی با کنش ایجاد کنید.
در کنسول Firebase، به DevOps و تعامل > پیام‌رسانی بروید.
برای راه‌اندازی پویش جدید، گردش کار را راه‌اندازی کنید:
اگر این اولین پویش شما است:
- روی ایجاد اولین پویش کلیک کنید.
- پیام‌های درون‌برنامه‌ای Firebase را انتخاب کنید و روی ایجاد کلیک کنید.
اگر قبلاً پویش ایجاد کرده‌اید:
- در برگه پویش‌ها، روی پویش جدید کلیک کنید.
- پیام‌رسانی درون‌برنامه را انتخاب کنید.
برای راه‌اندازی پویش، دستورالعمل‌های روی صفحه را دنبال کنید.
کارت، نوشتار دکمه، و کنش دکمه، کنش تصویر، یا کنش برنما ارائه دهید که کنش آن پیوند عمیق مربوطه باشد.
قالب کنش به طرح‌بندی پیامی که انتخاب می‌کنید بستگی دارد. مدال‌ها دکمه‌های کنش با محتوای نوشتاری دکمه، رنگ نوشتار، و رنگ پس‌زمینه قابل‌سفارشی‌سازی دریافت می‌کنند. ازسوی‌دیگر، تصاویر و برنماهای برتر تعاملی می‌شوند و با تک‌ضرب زدن، کنش مشخص‌شده را فراخوانی می‌کنند.
اصلاح ظاهر و احساس پیام
Firebase In-App Messaging به شما امکان می‌دهد نمایش پیام‌ها را سفارشی‌سازی کنید تا نحوه ارائه چیدمان، سبک قلم، شکل دکمه، و جزئیات دیگر پیام‌ها را در برنامه‌تان تغییر دهید. دو روش برای اصلاح نمایش پیام وجود دارد: اصلاح نمایش‌های پیش‌فرض Firebase In-App Messaging یا ایجاد کتابخانه نمایش پیام خودتان از ابتدا.
اصلاح نمایش‌های پیش‌فرض
ساده‌ترین راه برای سفارشی‌سازی پیام‌هایتان این است که از کد نمایش پیام پیش‌فرض 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 | textColor | backgroundColor | imageData | actionButton | secondaryActionButton |
|---|---|---|---|---|---|---|---|
| کارت | |||||||
| مودال | |||||||
| بنر | |||||||
| ImageOnly |
کد پردازشی نمایش پیام را اصلاح کنید
با درنظر گرفتن محدودیت‌های نوع پیام، می‌توانید آن‌ها را هرطور که می‌خواهید اصلاح کنید. می‌توانید برنمایی ایجاد کنید که در پایین برنامه‌تان نمایش داده شود، دکمه کنش را در یک مدال جابه‌جا کنید، پیام درون‌برنامه را در فید کاربر جاسازی کنید، یا هر تغییر دیگری که باعث شود ظاهر و حس پیام‌ها با برنامه‌تان مطابقت داشته باشد.
هنگام اصلاح نمایش پیام، دو نکته اصلی وجود دارد که باید به آن‌ها توجه کنید:
- دایرکتوری‌های نوع پیام: هر نوع پیام دایرکتوری جداگانه‌ای دارد که فایل‌های آن منطق آن نوع را تعیین می‌کنند:
- داستان‌سرا: کتابخانه
InAppMessagingهمچنین دارای فایل.storyboardاست که به تعریف واسط کاربر برای هر سه نوع پیام کمک می‌کند:
فایل‌ها را در فهرست‌های راهنمای نوع پیام دلخواهتان و بخش‌های مربوطه
.storyboard اصلاح کنید تا نمایش پیام سفارشی‌تان را ایجاد کنید.
podfile خود را به‌روز کنید تا از کد InAppMessaging اصلاح‌شده‌تان استفاده کنید
برای اینکه Firebase In-App Messaging از نمایش پیام اصلاح‌شده شما به‌جای نمایش پیش‌فرض استفاده کند، podfile خود را به‌روز کنید تا از کتابخانه سفارشی‌شده 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