Android Push Notification

پوش نوتیفیکیشن اندروید برای رشد و بازگشت کاربران اپلیکیشن

با SDK رسمی پوشفا، Firebase Cloud Messaging را به Subscriber ID پایدار، Topic، Alias، Deep Link، گزارش تحویل و Journeyهای RetenX متصل کنید؛ از پیام تراکنشی تا کمپین بازگشتی را از یک پنل فارسی و API یکپارچه مدیریت کنید.

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

FCM زیرساخت ارسال
Subscriber ID شناسه پایدار
Topic هدف‌گیری گروهی
Reports تحلیل کمپین

پوش نوتیفیکیشن اندروید در پوشفا فقط یک اتصال ساده به FCM نیست. SDK رسمی توکن و refresh آن را مدیریت می‌کند، Subscriber ID پایدار می‌سازد و Topic، External ID، Custom Alias و Eventهای RetenX را به Profile مخاطب متصل می‌کند. Backend شما می‌تواند پیام تراکنشی را به یک کاربر یا دستگاه مشخص بفرستد و تیم محصول نیز کمپین، Segment و Journey را از پنل اجرا کند؛ در هر دو حالت Deep Link، Delivery و Click قابل‌اندازه‌گیری باقی می‌مانند.

امکانات

چه چیزی به دست می‌آورید

اتصال مستقیم به FCM

توکن‌ها، refreshها و وضعیت دسترسی به Push با مدل استاندارد Firebase مدیریت می‌شود.

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

Subscriber ID حتی با تغییر توکن هم هویت کاربر را نگه می‌دارد.

هدف‌گیری دقیق

ارسال به topic، alias، سگمنت و فیلتر دستگاه را به‌سادگی از پنل یا API انجام دهید.

اعلان rich و actionable

عنوان، متن، تصویر، اکشن و deep link را در اعلان اندروید استفاده کنید.

گزارش و بهینه‌سازی

نرخ تحویل، کلیک و بازگشت را ببینید و کمپین‌ها را بهتر کنید.

چطور کار می‌کند

راه‌اندازی در چند گام ساده

  1. اپ اندروید را در Firebase و پوشفا به همان پروژه متصل کنید.
  2. SDK اندروید پوشفا را در پروژه قرار دهید و ثبت دستگاه را فعال کنید.
  3. اجازه اعلان، refresh token و شناسه پایدار مشترک را بررسی کنید.
  4. کمپین، پیام تراکنشی یا رویداد رفتاری را از پنل یا API ارسال کنید.
  5. گزارش تحویل، کلیک و مسیر بازگشت کاربر را در داشبورد تحلیل کنید.
راهنمای کامل

پوش نوتیفیکیشن اندروید چیست و پوشفا کجای مسیر قرار می‌گیرد؟

اعلان اندروید پیامی است که حتی وقتی اپ باز نیست روی دستگاه کاربر نمایش داده می‌شود. Firebase Cloud Messaging پیام را به دستگاه می‌رساند و پوشفا لایه مدیریت محصول را روی آن می‌سازد: ثبت و تازه‌سازی توکن، Subscriber ID پایدار، هدف‌گیری، زمان‌بندی، محتوای غنی، گزارش تحویل و کلیک و اجرای Journeyهای رفتاری. در نتیجه تیم فنی همچنان مالک Firebase Project خود است و تیم محصول و مارکتینگ برای هر ارسال مجبور نیست منطق FCM را از ابتدا پیاده کند.
اپ AndroidPermission، SDK و FCM token
پوشفاProfile، هدف‌گیری، Queue و گزارش
Firebase FCMتحویل امن پیام به دستگاه
کاربرنمایش اعلان و ورود به Deep Link
توکن FCM شناسه فنی و قابل‌تغییر دستگاه است؛ برای اتصال پایدار کاربر و هدف‌گیری چنددستگاهی از Subscriber ID، External ID و Custom Alias استفاده کنید.
قابلیت‌ها

از یک اعلان ساده تا کانال ارتباطی کامل داخل اپ

قابلیت‌های Android Push پوشفا فقط به نمایش عنوان و متن محدود نیستند.

Rich Notification

تصویر، آیکن، متن و حداکثر دو دکمه عملیاتی را در اعلان قرار دهید و هر کلیک را جداگانه به مقصد مرتبط ببرید.

Deep Link و App Link

کاربر را به‌جای صفحه اصلی مستقیماً به سفارش، محصول، گفتگو، فاکتور یا بخش درست داخل اپ هدایت کنید.

Collapse ID و Silent

وضعیت‌های پشت‌سرهم یک سفارش را با Collapse ID جایگزین کنید یا اعلان را بدون صدا و لرزش نمایش دهید.

Additional Data

داده ساخت‌یافته مانند order_id، screen یا campaign را همراه Push به Navigation و Analytics اپ تحویل دهید.

Delivery و Click Report

تحویل پس از نمایش واقعی و کلیک بدنه یا دکمه‌ها ثبت می‌شود و گزارش ناموفق با WorkManager دوباره تلاش می‌شود.

Foreground و Background

SDK پیام را در حالت باز، پس‌زمینه و بسته مدیریت می‌کند و برای Renderer اختصاصی نیز Listener ارائه می‌دهد.

هویت و هدف‌گیری

پیام را به دستگاه درست و کاربر درست برسانید

Pushfa هر نصب را با Subscriber ID پایدار نگه می‌دارد. پس از Login می‌توانید شناسه داخلی کاربر را به‌عنوان External ID ثبت کنید و شناسه‌های دیگری مانند شماره موبایل، CRM ID یا سطح مشتری را با Custom Alias به همان Profile متصل کنید. Topic برای عضویت گروهی و Segment برای انتخاب پویا براساس ویژگی و رفتار مناسب است.
روش هدف‌گیریمناسب براینمونه
FCM Tokenارسال فنی و موقت به یک نصب مشخصتست روی یک دستگاه
Subscriber IDهدف‌گیری پایدار یک یا چند نصب شناخته‌شدهپیام اختصاصی دستگاه
External IDکاربر واردشده در سیستم شماuser-123
Custom Aliasشناسه برچسب‌دار کسب‌وکارcrm_id، mobile، tier
Topicعضویت اختیاری یا دسته محتواییخبر فوری، تخفیف، شهر تهران
Segmentگروه پویا براساس Profile و رفتارخریداران فعال یا کاربران کم‌تعامل
کاربردها

Android Push برای چه سناریوهایی بیشترین ارزش را دارد؟

فروشگاه و مارکت‌پلیس

وضعیت سفارش، موجودشدن کالا، کاهش قیمت، سبد رهاشده، پیشنهاد مکمل و پیام فروشنده.

فین‌تک و حساب کاربری

تأیید تراکنش، ورود جدید، هشدار امنیتی، سررسید و تغییر وضعیت درخواست بدون افشای اطلاعات حساس.

تاکسی، ارسال و لجستیک

پذیرش سفر، رسیدن راننده، تغییر وضعیت مرسوله و هدایت مستقیم به نقشه یا جزئیات سفارش.

آموزش و محتوا

شروع کلاس، انتشار درس، ادامه دوره، پاسخ مدرس و بازگرداندن کاربری که یادگیری را متوقف کرده است.

SaaS و اپ اشتراکی

Onboarding، تکمیل تنظیمات، هشدار مصرف، تمدید اشتراک، معرفی قابلیت و جلوگیری از ریزش.

رسانه و شبکه اجتماعی

خبر فوری، پیام و Mention، محتوای مرتبط، دعوت و بازگشت کاربران کم‌تعامل.

پیاده‌سازی فنی

مسیر استاندارد راه‌اندازی Pushfa Android SDK

SDK رسمی پوشفا برای اپ‌های Kotlin و Java طراحی شده است. نسخه مستندشده فعلی 2.0.4 است، حداقل Android 6 (API 23) را پوشش می‌دهد و از Maven Central قابل نصب است. پروژه Firebase اپ و Service Account ثبت‌شده در پنل پوشفا باید دقیقاً متعلق به یک Firebase Project باشند.
  • اپ را با applicationId دقیق در Firebase ثبت و فایل google-services.json را در مسیر app قرار دهید.
  • Service Account همان Firebase Project را فقط در پنل پوشفا وارد کنید؛ این کلید هرگز نباید داخل APK یا Repository باشد.
  • SDK را با com.pushfa:pushfa-android-sdk:2.0.4 نصب و یک‌بار در Application مقداردهی کنید.
  • در Android 13 و بالاتر، پیش از POST_NOTIFICATIONS مزیت اعلان را در یک Soft Prompt کوتاه توضیح دهید.
  • Foreground، Background، اپ بسته، Token Refresh، Deep Link، Action و گزارش را روی دستگاه واقعی بررسی کنید.
اگر اپ از قبل FirebaseMessagingService اختصاصی دارد، فقط یک سرویس باید MESSAGING_EVENT را دریافت کند. پیام و Token را به SDK تحویل دهید و از فعال‌ماندن دو Service جلوگیری کنید.
سناریوهای آماده

سه جریان پیشنهادی برای شروع

سناریوTriggerهدف‌گیری و پیاممقصد
وضعیت سفارشتغییر وضعیت در BackendSubscriber یا External ID؛ Collapse ID برابر شناسه سفارشDeep Link جزئیات سفارش
سبد رهاشدهadd_to_cart بدون checkout_completedRetenX؛ پیام شخصی و در صورت نیاز SMS fallbackبازگشت مستقیم به سبد
بازگشت کاربر غیرفعالعدم فعالیت در بازه مشخصSegment یا Journey؛ پیشنهاد مرتبط با آخرین رفتارصفحه محتوای مرتبط
اتوماسیون و امنیت

RetenX و Auth Push در اپ Android

SDK می‌تواند رویدادهایی مانند product_view، add_to_cart و purchase را همراه ویژگی‌های رفتار و Aliasهای کاربر به RetenX بفرستد. Journey سپس می‌تواند Wait، شرط، Push، SMS fallback و Webhook را اجرا کند. برای ورود بین‌دستگاهی، Auth Push دستگاه مورداعتماد را با Subscriber ID به هویت کاربر Bind می‌کند؛ Challenge و Grant باید فقط در Backend امن ساخته و مصرف شوند.

RetenX Journey

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

Profile 360°

External ID، Custom Alias، Topic، رویداد و عضویت Push در یک نمای مشترک قرار می‌گیرند.

Auth Push

ورود یا تأیید حساس روی دستگاه مورداعتماد انجام می‌شود؛ Private Key و Grant وارد اپ نمی‌شوند.

اندازه‌گیری

فقط ارسال نکنید؛ کیفیت کانال را اندازه بگیرید

شاخصچه چیزی نشان می‌دهد؟اقدام پیشنهادی
Push opt-inچه درصدی از کاربران اجازه اعلان داده‌اندزمان و متن Soft Prompt را بهبود دهید
Token validityسلامت عضویت‌ها و چرخه Refreshتوکن نامعتبر را از هدف‌گیری خارج کنید
Delivery rateنسبت نمایش واقعی به تلاش ارسالFirebase، Permission، Queue و TTL را بررسی کنید
Click rateارتباط عنوان، متن و مقصد با نیاز کاربرپیام و Deep Link را آزمایش کنید
Conversionاقدام نهایی بعد از PushEvent هدف و Attribution را در RetenX تعریف کنید
Unsubscribe/disableخستگی یا نامرتبط‌بودن ارسالFrequency Cap و Segmentation را دقیق‌تر کنید
سوالات متداول

پرسش‌هایی که معمولاً قبل از شروع پیش می‌آیند

برای پوش نوتیفیکیشن اندروید حتماً Firebase لازم است؟
در مسیر استاندارد Android، بله. اپ توکن را از Firebase Cloud Messaging می‌گیرد و سرور پوشفا با Service Account همان Firebase Project پیام را ارسال می‌کند.
چه نسخه‌هایی از Android پشتیبانی می‌شوند؟
نسخه مستندشده Pushfa Android SDK حداقل Android 6 یا API 23 را پشتیبانی می‌کند. برای Android 13 و بالاتر درخواست Runtime Permission اعلان الزامی است.
اگر توکن FCM تغییر کند هویت کاربر از بین می‌رود؟
خیر. SDK توکن تازه را به Subscriber ID پایدار متصل می‌کند. برای هویت کسب‌وکاری نیز External ID و Custom Alias را بعد از Login ثبت کنید.
آیا اپ می‌تواند FirebaseMessagingService خودش را داشته باشد؟
بله، اما فقط یک Service باید پیام FCM را دریافت کند. سرویس اپ باید Token و RemoteMessage را به Pushfa SDK تحویل دهد تا نمایش و گزارش دو بار اجرا نشود.
آیا تصویر، دکمه و Deep Link پشتیبانی می‌شود؟
بله. Pushfa Android SDK تصویر، حداکثر دو Action، URL خارجی، App Link، Custom Scheme و مسیر نسبی داخل اپ را مدیریت می‌کند.
می‌توان به یک کاربر روی چند دستگاه پیام داد؟
بله. External ID یا Custom Alias می‌تواند چند Subscriber را به یک کاربر مرتبط کند. در API می‌توانید همه دستگاه‌ها، آخرین دستگاه یا Smart Targeting را انتخاب کنید.
Delivery Report چه زمانی ثبت می‌شود؟
SDK گزارش تحویل را پس از پذیرش واقعی اعلان توسط NotificationManager صف می‌کند و در صورت قطع اینترنت با WorkManager دوباره تلاش می‌کند.
RetenX و Auth Push روی Android قابل استفاده‌اند؟
بله. SDK رویداد و هویت لازم برای RetenX را ثبت می‌کند. در Auth Push نیز دستگاه مورداعتماد اعلان را دریافت می‌کند، ولی ساخت Challenge و مصرف Grant باید در Backend امن انجام شود.

پوش اندروید را همین امروز روشن کنید

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