سلام به دوستان عزیز توی این مقاله میخوام نحوه راه اندازی in-app messaging فایربیس رو توضیح بدم و بعد از اون نحوه کاستومایز کردن ui پیام هاش رو باهم بررسی خواهیم کرد.
اول از همه باید ببینیم FIAM ( مخفف Firebase In-App Messaging ) چی هست و برای چه کاری استفاده میشه. FIAM سرویس ارسال پیام فایربیس هست و این پیام ها زمانی ارسال میشن که اپلیکشن در حال اجرا هست یا به اصطلاح تو foreground قرار داره و کاربر در حال استفاده از اپلیکیشن هست. علاوه بر اون این قابلیت رو داره که به صورت اختصاصی زمانی ارسال بشه که کاربر داخل اپلیکشن اکشن خاصی رو انجام میده مثلا وقتی کاربر روی دکمه ی خاصی کلیک کرد یک پیام براش ارسال بشه.
راه اندازی اولیه FIAM ( مخفف Firebase In-App Messaging ) بسیار کار ساده ای هست که در ادامه با هم میبینیم.
نکته۱: تو این مقاله فرض بر این گرفته شده که شما از قبل پروژتون رو داخل کنسول فایربیس اضافه کردید.
نکته۲: کدها با زبان کاتلین خواهند بود.
مرحله اول برای راه اندازی FIAM اضافه کردن Dependency های موردنیازش تو gradle هست:
dependencies { implementation platform('com.google.firebase:firebase-bom:29.0.3') implementation 'com.google.firebase:firebase-inappmessaging-display-ktx' implementation 'com.google.firebase:firebase-analytics-ktx' }
خب بعد از sync کردن اپلیکیشن شما اماده دریافت FIAM هست.
حالا نحوه ارسال یه FIAM رو با هم بررسی میکنیم:
برای این کار اول وارد کنسول فایربیس بشید و اپلیکیشن مورد نظرتون رو انتخاب کنید و وارد داشبورد اون بشید و از منوی سمت چپ گزینه ی In-App Messaging رو انتخاب کنید.
تو این قسمت روی دکمه Create your first campaign کلیک کنید:
تو قسمت اول این صفحه میتونید نوع پیامی که در نظر دارید ارسال بشه رو مشخص کنید که چهار حالت مختلف داره: card, modal, image only, top banner
به عنوان مثال حالت modal رو انتخاب میکنیم. تو این قسمت میتونیم خصوصیات ظاهری مثل رنگ متن و رنگ پس زمینه و رنگ دکمه و لینک عکس موردنظرمون و موارد دیگه رو مشخص کنیم.
مرحله بعدی مشخص کردن تارگت پیاممونه که با شرط های مختلف میتونیم مشخص کنید برای کدون پلتفرم ، کدوم نسخه از اپلیکیشنمون و ... پیام ارسال بشه.
تو مرحله بعدی میتونیم مشخص کنید که چه زمانی پیاممون نشون داده بشه. به عنوان مثال زمانی که اپ میاد تو foreground یا هر event خاص دیگه ای که تو اپلیکیشنمون مشخص کردید.
در انتها میتونید یا این کمپین رو save as draft کنید یا publish کنید. پیشنهاد میشه در زمانی که مشغول توسعه FIAM توی اپلیکیشنتون هستید از حالت save as draft استفاده کنید و برای تست کردن هم از روشی که در ادامه توضیح میدیم استفاده کنید.
اگر کمپین رو پابلیش بکنید فقط یک بار پیام رو داخل اپ مشاهده میکنید ولی در زمان توسعه شما نیاز دارید که چندین بار پیام رو ببینید موارد مختلف رو تست کنید برای این کار ابتدا باید Id مربوط به دیوایستون رو پیدا کنید. برای پیدا کردن این id به قسمت logcat اندروید استودیو برید و متن زیر رو سرچ کنید:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
مقداری که به جای YOUR_INSTALLATION_ID مشاهده میکنید رو کپی کنید و از منوی زیر گزینه test on device رو انتخاب کنید:
حالا id دیوایستون رو اینجا paste کنید و دکمه + رو بزنید و در اخر دکمه test رو کلیک کنید و برنامه تون رو اجرا کنید تا خروجی کار رو مشاهده کنید.
خروجی رو باید به صورت زیر مشاهده کنید:
تو مقاله ی بعدی نحوه ی کاستومایز کردن ui پیام ها رو بررسی خواهیم کرد.
