شروع مستندات

راهنمای شروع پوشفا؛ از ساخت سرویس تا ارسال پوش

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

چرخه ارسال Push در پوشفاپیام از پنل یا API به پوشفا و Firebase می‌رود، در Web/PWA یا Android نمایش داده می‌شود و گزارش تحویل و کلیک برمی‌گردد. چرخه ارسال Push در پوشفا ساخت پیامپنلAPIهدف، متن و زمان Pushfaصف، هدف‌گیری و گزارش FirebaseCloud Messaging نمایش روی دستگاهWeb / PWAمرورگرAndroidاپلیکیشنهر کانال عضویت مستقل دارد گزارش تحویل و کلیکبازگشت نتیجه به پنل و Webhook

ارسال پیام به کاربر خاص مدنظرتان با شناسه ثبت‌شده در سایت/اپلیکیشن شما

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

ابتدا نوع راهنما را انتخاب کنید

اگر با پنل کار می‌کنید و می‌خواهید سرویس بسازید، مخاطب مدیریت کنید یا پیام بفرستید، از راهنمای کاربر شروع کنید. برای نصب SDK و اتصال پروژه، راهنمای توسعه‌دهندگان مناسب است. اگر از سرور پیام یا رویداد می‌فرستید، مرجع وب‌سرویس‌ها را بخوانید. اگر می‌خواهید یک دستیار برنامه‌نویسی هوش مصنوعی این کارها را در پروژه انجام دهد، وارد بخش چهارم شوید.

سپس پلتفرم را مشخص کنید

راهنمای مربوط به سایت یا اپلیکیشن خود را انتخاب کنید. روش نصب و گرفتن اجازه دریافت اعلان در وب، اندروید و iOS متفاوت است؛ با این حال، پس از اتصال هرکدام به پوشفا، می‌توانید مخاطبان را مدیریت کنید، پیام بفرستید و گزارش‌ها را از پنل ببینید.

برای هر کار از کدام صفحه شروع کنید؟

نیاز شماراهنمای مناسباولین صفحه
مدیریت سرویس و ارسال از پنل راهنمای کاربر Push چیست؟
نصب روی وب‌سایت یا PWA توسعه‌دهندگان / Web راهنمای توسعه Web Push
نصب داخل اپ Android توسعه‌دهندگان / Android راهنمای توسعه Android
نصب داخل اپ iOS توسعه‌دهندگان / iOS راهنمای Pushfa iOS SDK
ارسال از سرور، CRM یا فروشگاه وب‌سرویس‌ها شروع وب‌سرویس‌ها
ارسال خودکار پیام بر اساس رفتار مخاطب راهنمای کاربر / RetenX RetenX چیست؟

اصطلاحاتی که در این راهنما می‌بینید

برای استفاده از راهنمای کاربر لازم نیست همه اصطلاحات فنی را بدانید. توضیح‌های زیر کمک می‌کنند هنگام خواندن مستندات یا صحبت با توسعه‌دهنده، منظور هر اصطلاح را بشناسید.

اصطلاحمعنی و کاربرد
اعلان پوش (Push Notification) پیام کوتاهی که روی دستگاه مخاطب نمایش داده می‌شود؛ برای مثال، خبر ارسال سفارش یا یادآوری خرید.
SDK بسته کد آماده‌ای که توسعه‌دهنده به سایت یا اپ اضافه می‌کند تا امکانات پوشفا در آن قابل استفاده شود.
API و endpoint API راه ارتباط برنامه شما با پوشفاست. هر endpoint یک نشانی مشخص برای کاری مانند ارسال پیام یا دریافت گزارش است.
توکن FCM نشانی فنی دریافت پیام در مرورگر یا اپ. این مقدار ممکن است تغییر کند و SDK آن را مدیریت می‌کند.
Subscriber ID شناسه ثابت مخاطب یا نصب دستگاه در پوشفا که با تغییر توکن عوض نمی‌شود.
Topic یا تاپیک دسته‌ای از مخاطبان، مانند علاقه‌مندان به تخفیف، که می‌توانید برای اعضای آن پیام بفرستید.
Alias و External ID شناسه‌ای برای ارتباط مخاطب پوشفا با کاربر سیستم شما؛ مانند شناسه حساب او در سایت. Custom Alias امکان ثبت شناسه‌های دیگری را هم فراهم می‌کند.
Prompt و permission Prompt درخواست عضویت را به کاربر نشان می‌دهد. permission اجازه‌ای است که کاربر در مرورگر یا سیستم‌عامل برای دریافت اعلان می‌دهد.
Service Worker فایلی که مرورگر برای دریافت و مدیریت اعلان‌های وب در پس‌زمینه اجرا می‌کند.
Payload و Additional Data Payload مجموعه داده‌های پیام است. Additional Data داده دلخواه شماست که همراه پیام فرستاده می‌شود؛ مانند شناسه سفارش.
Deep Link لینکی که مخاطب را به صفحه مشخصی در اپلیکیشن، مانند جزئیات سفارش، می‌برد.
Event و Journey در RetenX Event یک رویداد، مانند افزودن کالا به سبد خرید، است. Journey یا سفر مشتری مشخص می‌کند پس از آن چه مراحلی و در چه زمانی اجرا شوند.
Conversion یا تبدیل رسیدن مخاطب به هدفی که برای سفر تعیین کرده‌اید؛ برای مثال، تکمیل خرید. این مفهوم با ارسال یا کلیک روی پیام متفاوت است.
Webhook نشانی سرور شما که پوشفا نتیجه یا رویداد را به آن می‌فرستد تا برنامه شما بتواند آن را پردازش کند.
Ctrl+I