پوش نوتیفیکیشن iOS؛ زیرساخت حرفهای Push برای آیفون و آیپد آزمایشی
APNs، Firebase، Pushfa iOS SDK، Subscriber ID، Rich Notification و Deep Link را در یک مسیر روشن به پنل ارسال، API، گزارش و Journeyهای RetenX متصل کنید.
برای اپهای آیفون، آیپد، فروشگاهها، سرویسهای اشتراکی و محصولاتی که تجربه iOS برایشان حیاتی است.
پوش نوتیفیکیشن iOS برای تیمهایی است که میخواهند روی آیفون و آیپد نیز هویت مخاطب، ارسال تراکنشی، کمپین و اتوماسیون را یکپارچه مدیریت کنند. Pushfa iOS SDK ثبت دستگاه و Subscriber ID را به Firebase و APNs متصل میکند، Notification Service Extension امکان تصویر و گزارش دقیقتر را فراهم میسازد و Handlerهای اپ کاربر را از اعلان به مسیر درست هدایت میکنند. این صفحه هم تصمیمهای محصول را توضیح میدهد و هم پیشنیازهای واقعی Apple Developer، Firebase و Xcode را روشن میکند.
چه چیزی به دست میآورید
اتصال APNs و Firebase
زیرساخت iOS را با Apple Push Notification service و Firebase بهدرستی به هم وصل کنید.
مدیریت permission و token
ثبت کاربر، refresh شدن توکن و حفظ هویت مشترک را در یک مسیر شفاف دنبال کنید.
اعلانهای rich
برای آیفون و آیپد از تصویر، action button و payload غنی استفاده کنید.
دیپلینک و مسیر داخل اپ
کاربر را بعد از لمس اعلان به صفحه درست داخل اپ هدایت کنید.
گزارش کامل کمپین
تحویل، کلیک و بازگشت کاربر را مثل یک کانال جدی بازاریابی اندازهگیری کنید.
راهاندازی در چند گام ساده
- پروژه Apple Developer، Bundle ID و Firebase را برای اپ iOS آماده کنید.
- Pushfa iOS SDK را به پروژه اضافه کنید و APNs را متصل کنید.
- مجوز اعلان، توکن و مسیرهای deep link را در اپ بررسی کنید.
- پیامهای تراکنشی یا کمپینهای بازگشتی را از پنل یا API بفرستید.
- نتایج را در گزارشهای پوشفا بررسی و مسیر بازگشت را بهتر کنید.
پوش نوتیفیکیشن iOS چگونه از پنل تا آیفون میرسد؟
تجربه اعلان iOS را به یک پیام ساده محدود نکنید
پیام باید در لحظه درست نمایش داده شود و کاربر را به مقصد درست داخل اپ ببرد.
Rich Notification
با Notification Service Extension تصویر را پیش از نمایش دانلود کنید و محتوای اعلان را در محدودیت زمانی iOS غنی کنید.
Universal Link و Custom Scheme
کلیک بدنه یا Action را به محصول، سفارش، گفتگو یا صفحه درست اپ هدایت و ورودی URL را اعتبارسنجی کنید.
Foreground و Tap Handler
برای اعلان هنگام بازبودن اپ و برای Tap در Background یا Cold Start رفتار مستقل تعریف کنید.
Collapse و Expiration
اعلانهای همنوع را جایگزین کنید و TTL مناسب بگذارید تا پیام تاریخگذشته به کاربر نرسد.
Additional Data
داده ساختیافتهای مانند screen، order_id یا campaign را به Router و Analytics اپ تحویل دهید.
Delivery و Click
گزارش دریافت و کلیک را در کنار محدودیتهای Background iOS برای تحلیل واقعیتر کمپین ثبت کنید.
هماهنگی Apple Developer، Firebase و Pushfa
| جزء | محل تنظیم | قاعده مهم |
|---|---|---|
| Bundle ID | Xcode و Firebase Apple App | باید دقیقاً یکسان باشد |
| Push Notifications | Signing & Capabilities | برای Target اصلی اپ فعال شود |
| Remote notifications | Background Modes | برای دریافت Background فعال شود |
| APNs Authentication Key | Apple Developer و Firebase | Key ID و Team ID صحیح ثبت شوند |
| GoogleService-Info.plist | Target اپ | متعلق به همان Firebase App باشد |
| Service Account JSON | فقط پنل Pushfa | داخل Bundle، Git یا Extension قرار نگیرد |
| API Public Key | PushfaConfig داخل اپ | تنها کلید Pushfa مجاز در Client است |
کاربر را فراتر از APNs Token بشناسید
| روش | کاربرد | نمونه |
|---|---|---|
| Subscriber ID | هدفگیری پایدار یک نصب | UUID تولیدشده توسط SDK |
| External ID | شناسه اصلی کاربر واردشده | user-123 |
| Custom Alias | شناسههای برچسبدار کسبوکار | mobile، crm_id، membership |
| Topic | عضویت در دسته محتوایی | خبر فوری یا پیشنهادها |
| Segment | انتخاب پویا از Profile و رفتار | کاربران فعال iOS یا مشترکان در آستانه تمدید |
iOS Push کجا بیشترین اثر را ایجاد میکند؟
فروشگاه و سفارش
تأیید خرید، تغییر وضعیت سفارش، موجودشدن محصول، کاهش قیمت و بازگشت مستقیم به جزئیات کالا یا سبد.
بانک، فینتک و بیمه
هشدار تراکنش، ورود جدید، وضعیت احراز هویت و سررسید؛ با متن حداقلی و بدون نمایش داده حساس روی Lock Screen.
رزرو، سفر و لجستیک
یادآوری زمان، تغییر گیت یا پرواز، رسیدن خودرو، وضعیت مرسوله و بازشدن Route مرتبط داخل اپ.
رسانه و محتوای پولی
خبر فوری، انتشار محتوای دنبالشده، پیشنهاد شخصی و بازگرداندن مشترکی که مصرف محتوا را متوقف کرده است.
سلامت و خدمات
یادآوری نوبت و اقدام لازم با رعایت حریم خصوصی و پرهیز از درج اطلاعات پزشکی حساس در متن اعلان.
SaaS و اپ اشتراکی
Onboarding، تکمیل تنظیمات، هشدار حساب، تمدید و فعالسازی دوباره کاربران کمتعامل.
راهاندازی Pushfa iOS SDK با Swift Package Manager
- Package رسمی https://github.com/pushfa/pushfa-ios-sdk.git را با Rule نسخه Tag شده به پروژه اضافه کنید.
- Product اصلی Pushfa را فقط به Target اپ و PushfaExtension را فقط به Notification Service Extension متصل کنید.
- SDK را با API Public Key در AppDelegate یا چرخه SwiftUI مقداردهی و Permission را پس از توضیح ارزش اعلان درخواست کنید.
- اگر Firebase swizzling غیرفعال است، APNs Token و callbackهای لازم را دستی به Firebase و SDK تحویل دهید.
- Foreground، Background، Terminated، Cold Start، Action، Universal Link و Rich Image را روی دستگاه واقعی بررسی کنید.
Permission و Deep Link را بخشی از طراحی محصول بدانید
| مرحله | رفتار پیشنهادی | اشتباه رایج |
|---|---|---|
| قبل از Permission | ارزش اعلان را در Context مناسب توضیح دهید | درخواست در اولین اجرای اپ بدون دلیل |
| پس از قبول | ثبت Push و State را همگام کنید | فرضکردن اینکه Permission همیشه فعال میماند |
| پس از رد | فقط با اقدام کاربر مسیر Settings را پیشنهاد دهید | نمایش مکرر پیام مزاحم |
| هنگام Tap | URL و Additional Data را validate و Route کنید | اجرای مستقیم داده کنترلنشده |
| Cold Start | Route را تا آمادهشدن Navigation نگه دارید | از دستدادن مقصد هنگام Launch |
| Lock Screen | حداقل داده لازم را نمایش دهید | نمایش اطلاعات مالی یا شخصی حساس |
RetenX، پیام چندمرحلهای و Auth Push در iOS
سبد یا فرایند نیمهتمام
Event شروع، زمان انتظار و Exit event مانع ارسال پیام بیموقع پس از تکمیل کار میشوند.
تمدید و فعالسازی
Profile، وضعیت اشتراک و رفتار اخیر برای انتخاب پیام و کانال مناسب ترکیب میشوند.
ورود امن
دستگاه مورداعتماد درخواست را نمایش میدهد؛ Backend Grant یکبارمصرف را تأیید و Session را صادر میکند.
عملکرد iOS Push را با شاخص درست بسنجید
| شاخص | معنی | تصمیم بعدی |
|---|---|---|
| Permission rate | نسبت کاربران دارای اجازه اعلان | زمان و متن Pre-prompt را اصلاح کنید |
| Delivery | رسیدن/پردازش اعلان در محدودیتهای iOS | APNs، Token، Extension و TTL را بررسی کنید |
| Click rate | جذابیت و ارتباط پیام با نیاز مخاطب | عنوان، زمان، Action و مقصد را آزمایش کنید |
| Cold-start completion | رسیدن صحیح کاربر به مقصد پس از Launch | Router و Pending Route را اصلاح کنید |
| Conversion | اقدام نهایی مانند خرید یا تمدید | Event هدف و Attribution را در RetenX تعریف کنید |
| Disable/opt-out | خستگی یا بیاعتمادی مخاطب | Frequency Cap و Segmentation را بهبود دهید |
پرسشهایی که معمولاً قبل از شروع پیش میآیند
برای iOS حتماً APNs لازم است؟
Pushfa iOS SDK چه نسخههایی را پشتیبانی میکند؟
چرا Permission اعلان دوباره نمایش داده نمیشود؟
میتوان اعلان همراه تصویر فرستاد؟
فرق Universal Link و Custom URL Scheme چیست؟
آیا Push در Foreground هم نمایش داده میشود؟
چرا Push روی Simulator معیار کافی نیست؟
آیا RetenX و Auth Push روی iOS پشتیبانی میشوند؟
این خدمات را هم ببینید
پوش iOS را با یک مسیر روشن شروع کنید
حساب رایگان بسازید، مستندات iOS را ببینید و از همان ابتدا زیرساخت Push آیفون را حرفهای بچینید.