راهنمای جامع توسعه Android با Pushfa SDK
اپ اندروید را با نسخه 2.0.4 به پوشفا متصل کنید. این راهنما از نصب و راهاندازی شروع میشود و سپس مدیریت مخاطبان، دریافت اعلان، بازکردن صفحه مقصد و مشاهده گزارشها را توضیح میدهد.
SDK چه کارهایی را خودکار انجام میدهد؟
SDK ثبت دستگاه، دریافت توکن FCM و بهروزرسانی آن را انجام میدهد و برای مخاطب یک Subscriber ID میسازد. همچنین پیامها را دریافت و نمایش میدهد و گزارش تحویل و کلیک را با WorkManager ثبت میکند. برای دستهبندی مخاطبان، اتصال آنها به حساب کاربری و ثبت رفتار در RetenX نیز متدهای آماده دارد. در نصب معمول، به فراخوانی دستی وبسرویس ثبت توکن یا ساخت FirebaseMessagingService جداگانه نیاز ندارید.
| قابلیت | متد یا رفتار SDK |
|---|---|
| راهاندازی و ثبت خودکار | Pushfa.initialize() |
| درخواست اجازه دریافت اعلان و ثبت Push | requestNotificationPermission() / registerForPush() |
| شناسه ثابت مخاطب (Subscriber ID) و توکن | getSubscriberId() / getPushToken() |
| Topic | subscribeTopic() / unsubscribeTopic() / getTopics() |
| هویت کاربر | setExternalId() / getExternalId() |
| شناسههای مستعار سفارشی | addAlias(es) / removeAlias(es) / getAliases() |
| RetenX | trackEvent() |
| دریافت سفارشی | setNotificationListener() / displayNotification() |
| ادغام با Service موجود | handleMessage() / handleNewToken() |
مسیر پیشنهادی پیادهسازی
SDK را نصب کنید
Maven Central روش پیشنهادی است؛ JitPack و ماژول سورس نیز پشتیبانی میشوند.
Firebase همان سرویس را متصل کنید
google-services.json و Service Account پنل باید متعلق به یک Firebase project باشند.
در Application مقداردهی کنید
Pushfa.initialize() پروفایل را میسازد و در صورت داشتن اجازه دریافت اعلان، توکن را خودکار ثبت میکند.
اجازه دریافت اعلان را در زمان مناسب بگیرید
در Android 13+ پس از قبول کاربر، registerForPush() را اجرا کنید.
هویت و دستهبندی را متصل کنید
پس از Login، شناسه کاربر در سیستم شما (External ID) و شناسههای مستعار را تنظیم و تاپیکهای لازم را ثبت کنید.
دریافت و کلیک را بررسی کنید
حالت پیشفرض SDK کافی است؛ فقط برای رفتار سفارشی Listener یا Service اختصاصی بسازید.
ادامه این راهنما
راهنمای رسمی نسخه 2.0.4
Maven Central، فایل ZIP، SHA-256، ارتقا و راهنمای Firebase پنل.
نصب و راهاندازی سریع
Gradle، Firebase، initialize و permission.
مرجع تمام متدها
امضا، خروجی و کاربرد API عمومی SDK.
Topic و هویت کاربر
شناسه ثابت مخاطب (Subscriber ID)، شناسه کاربر در سیستم شما (External ID) و Custom Alias.
RetenX Event
ثبت رفتار و پارامترهای سفر مشتری از داخل اپ.
دریافت و نمایش اعلان
حالت خودکار، Listener و Firebase Service موجود.
رفع اشکال
Gradle، Firebase، اجازه دریافت اعلان، نمایش، لینک و Collapse.
پیشنیاز نسخه فعلی
| مورد | مقدار |
|---|---|
| نسخه SDK | 2.0.4 |
| minSdk | 23 (Android 6.0) |
| compileSdk | 35 یا بالاتر |
| Firebase Messaging | توسط خود SDK اضافه میشود |
| JDK 17 | فقط برای Build کردن SDK از سورس |