یکپارچه‌سازی OneSignal

1حساب OneSignal بسازید#

برای شروع اعلان‌های پوش یک حساب رایگان OneSignal بسازید. OneSignal اعلان‌های پوش نامحدود را رایگان ارائه می‌دهد.

رفتن به OneSignal.com ←

2اپلیکیشن جدید بسازید#

در داشبورد OneSignal:

• روی «New App/Website» بزنید
• نام اپلیکیشن خود را وارد کنید
• «Google Android (FCM)» را به عنوان پلتفرم انتخاب کنید
• روی «Next» بزنید

3پروژه Firebase بسازید#

برای کار کردن OneSignal به یک پروژه Firebase نیاز دارید. به Firebase Console بروید و یک پروژه جدید بسازید یا از پروژه موجود استفاده کنید.

باز کردن Firebase Console ←

4اپلیکیشن Android را به Firebase اضافه کنید#

در پروژه Firebase خود:

• روی «Add App» بزنید و Android را انتخاب کنید
• نام بسته اپلیکیشن خود را وارد کنید (باید با نام بسته‌ای که در سازنده تعیین کرده‌اید مطابقت داشته باشد)
• فایل «google-services.json» را دانلود کنید
• ⚠️ مهم: این فایلی است که بعداً در سازنده Web2APK بارگذاری می‌کنید.
• روی «Continue» بزنید و راه‌اندازی را تمام کنید

5کلید حساب سرویس Firebase بسازید#

OneSignal برای ارسال اعلان‌ها از سرور خود به یک JSON حساب سرویس Firebase نیاز دارد.

در Firebase Console:

• به Project Settings > تب Service accounts بروید
• روی «Generate new private key» بزنید
• تأیید کنید و فایل JSON را دانلود کنید

⚠️ هشدار: این فایل فقط برای داشبورد OneSignal است. این فایل را در سازنده Web2APK بارگذاری نکنید.

باز کردن Firebase Console ←

6OneSignal را با حساب سرویس پیکربندی کنید#

بازگشت به راه‌اندازی داشبورد OneSignal:

• وقتی اطلاعات Firebase خواسته شد، «Upload Service Account File» را انتخاب کنید
• JSON حساب سرویسی را که از Firebase دانلود کرده‌اید بارگذاری کنید
• روی «Save & Continue» بزنید
• OneSignal App ID خود را کپی کنید (در سازنده به آن نیاز دارید)

7تنظیم در Web2APK Generator#

در اپلیکیشن generator:

1. کلید «OneSignal» را در مرحله 3 روشن کنید
2. روی دکمه «Upload google-services.json» بزنید
3. فایل «google-services.json» را انتخاب کنید (همان فایل مرحله 4)

⚠️ کلید حساب سرویس مرحله 5 را اینجا بارگذاری نکنید!

1. OneSignal App ID خود را بچسبانید
2. APK خود را بسازید

OneSignal App ID format:
12345678-1234-1234-1234-123456789012

8آزمایش اعلان‌های پوش#

پس از نصب APK ساخته‌شده:

• اپلیکیشن را روی دستگاه خود باز کنید
• به داشبورد OneSignal بروید
• به «Messages» > «New Push» بروید
• یک اعلان آزمایشی بنویسید و بفرستید
• باید ظرف چند ثانیه آن را روی دستگاه خود دریافت کنید

9نکات مهم#

⚠️ نام بسته: نام بسته در Firebase باید دقیقاً با نام بسته اپلیکیشن شما یکی باشد

⚠️ بارگذاری فایل: هنگام استفاده از OneSignal همیشه google-services.json را بارگذاری کنید، وگرنه اعلان‌ها کار نمی‌کنند

⚠️ اولین اجرا: کاربران باید حداقل یک بار اپلیکیشن را باز کنند تا اعلان‌ها را دریافت کنند

✅ برای همیشه رایگان: OneSignal 100٪ رایگان است و اعلان‌های نامحدود دارد