Skip to content

Latest commit

 

History

History
201 lines (110 loc) · 8.06 KB

push-notifications-by-one-signal.md

File metadata and controls

201 lines (110 loc) · 8.06 KB

Push Notifications by One Signal

PLEASE NOTE:

At this time Push Notifications can only be tested on Android Devices.

You can add Push Notifications to iOS apps but testing can only be done after an app is published to the App Store.

One Signal is the world leader in push notifications and they offer their service for free.

Push notifications are one of the biggest advantages that mobile apps have over mobile websites, since they can send messages to users without the app being open.

However, annoying notifications---those that are irrelevant and too frequent---can be dismissed or blocked easily. We highly recommend sending notifications only when the content is relevant to the user.

Good examples:

App type Frequency Content
E-commerce Sales Coupon code
Game App updates Try this new level

{% hint style="info" %} Push Notifications are a component. While all Thunkers can add Push Notifications to their app projects and live test them in their apps (Android only), only PRO Thunkers can download and publish apps with Push Notifications. {% endhint %}

{% hint style="info" %} Availability

Add to Project Live Test Download Publish
Android All Thunkers All Thunkers **** only **** only
iOS All Thunkers Not available Not available only
{% endhint %}

Sign up with One Signal

One Signal is a free service that supports unlimited devices and notifications. They make money by selling your users' data to 3rd parties.

After you have signed up, click Add App and enter in your app name:

After adding your app, OneSignal will ask you to select a platform. Below, we have created guides for both Android and iOS.

At this time Push Notifications can only be tested on Android Devices.

You can add Push Notifications to iOS apps but testing can only be done after an app is published to the App Store.

Android Setup

Setting up push notifications for Android is relatively straightforward. Here's a quick overview of the steps, followed by a more detailed walk-through.

  1. Select Your Platform
  2. Configure Your Platform
  3. Select Your SDK
  4. Install Your SDK

1. Select Your Platform

After you have added an app and given it a name, select the Google Android option.

Click on "Google Android" to set up an Android app.

2. Configure Your Platform

For this next step, you will need a Firebase account.

For instructions on how to set up a Firebase account, please click here.

Once you are signed in with Firebase, create a new project.

Once you have created a new project, click on the gear icon beside Project Overview and select Project settings.

Select the Cloud Messaging option:

There are two things that you will need to copy and paste back into One Signal:

  1. Server Key
  2. Sender ID

Go back to the One Signal platform.

Earlier you should have selected the Android option on One Signal, and your screen should look like this:

Copy and paste the Firebase Server Key and the Firebase Sender ID sections into One Signal.

3. Select Your SDK

The last thing you need to do in OneSignal is choose your target SDK. Select Native Android and click next to continue.

4. Install Your SDK

Copy the alpha numeric code that OneSignal generates called Your App ID in the image below.

On Thunkable, drag and drop the Push Notifications component into your app.

On the right hand side, paste the code from One Signal into the Android App ID section.

Click the Live Test button. Once the app is on your phone, go back to One Signal. Click the "Check Subscribed Users" button.

If you are live testing or have downloaded your Android app, you should see a congratulations message. Click "DONE".

Select the "MESSAGES" option and then select "NEW PUSH". You will now be able to create push notifications and send them to your app users.

iOS Setup

Setting up push notifications involves a few more steps on iOS than on Android, but every step is covered in detail below.

  1. Select Platform
  2. Configure Platform
  3. Select SDK
  4. Install SDK

1. Select Platform

Get started by creating a new app. You need to do this even if your Thunkable project is intended for both iOS and Android.

After that, choose Apple iOS as your platform.

2. Configure Platform

OneSignal have provided extensive documentation on how to find your Production Certificate .p12 file as well as your Production Private Key Password. The most important steps are outlined below.

To begin, open the OneSignal Provisionator webpage. This tool will generate a .p12 file and the accompanying password for you.

Follow the on screen instructions. Enter your Apple Developer ID and password. This portal works with 2FA enabled as well. If prompted, enter your 2FA code. Choose your team and the relevant Bundle ID and click generate.

{% hint style="warning" %} You must be a Team Administrator to generate the files {% endhint %}

You can now download the .p12, .cer and .pem files that are generated for you.

{% hint style="warning" %} Don't forget to save your password somewhere safe. {% endhint %}

Click on Apple iOS

With that completed you can upload your .p12 file and enter the password in OneSignal. Click Save to proceed to the next step.

3. Select SDK

Click on Native iOS to choose the SDK you wish to target. Then click Next to generate your App ID.

4. Install SDK

Copy the alpha-numeric code labeled Your App ID and head back to Thunkable.

Paste your ID in the IOS_AppID field and you're almost done. In order to now publish your app your will have to create a .mobileprovision profile. You can find details of how to do this on the "Publish to App Store" page.

When you are ready to send your first push notification, select the "MESSAGES" option and then select "NEW PUSH". You will now be able to create push notifications and send them to your app users.