A push notification profile is a way to let Dotdigital know how to communicate with your app through Apple's APNS and Google's FCM push systems, as well as how to authorise a user for push.
You can have only one profile, which can be set up to send push notifications to both Android and iOS devices.
To set up your push notification profile:
Log into Dotdigital.
Expand the User menu in the bottom left and go to Settings > Facebook, Google, push notifications.
Under Channel, select Push notification, then select NEW PROFILE.
Select the text box under Edit profile and enter the name of your app.
In the Authentication section, the values are pre-populated for you. Make a note of the values for each field. You use these values to create a JSON Web Token (JWT) in your app and pass that token to our SDK to authorise the user for push.
Expand the Status drop-down menu and select Enabled.
A value is populated for you in the API space ID field, which you need to initialise an SDK, so note this down for your development team.
You now have configured your push notifications in Dotdigital
Our Android SDK uses Firebase Cloud Messaging (FCM) to send push notifications to your Android app users. Therefore, you need to give us some details about your Firebase project.
You need to have the Firebase console open. If you don't have a Firebase project, create one.
- In the Firebase console, slect the cog icon and go to Project settings
- In the General tab, copy your package name and paste it into the Package name field in Dotdigital
Don't see your package name?
If you don't see your package name in the General tab, you need to select Add Firebase to your Android app.
Complete only steps 1 and 2 (register your app, and download your config file).
- In the Cloud Messaging tab, copy your server key and paste it into the Server key field in Dotdigital
Our iOS SDK uses the Apple Push Notification Service (APNS) to send push notifications to your contacts. Therefore, you need to configure your APNS token details in order for us to send pushes to your app. Dotdigital utilises the APNS tokens rather than APNS Certificates, as the tokens do not expire annually. Instructions for creating an APNS token in the Apple Developer Portal can be found here.
You need to have your Apple Developer Portal open. If you don't have an app ID that has the Push Notifications service enabled, create one.
In your Apple Developer Portal:
- Open the Certificates, IDs & Profiles page.
- Select the Keys > All option and select the + icon to create a new key.
- Enter an appropriate name for the key and ensure the Apple Push Notifications service (APNs) option is selected, and create the key.
- Download the key (.p8 file) and store securely. Note down the Key ID displayed.
In the Dotdigital Push profile setup screen:
- For Private key, select CHOOSE FILE to upload your APNS Key file (.p8).
- For Key ID, enter the value of your APNS key's ID.
- For Team ID, enter the value of your team ID.
- Select SAVE.
The API space ID is used to initialise our mobile SDKs.
This ID is displayed at the bottom of your push notification profile page as shown below:
Updated 10 days ago