This manual will show you step by step how to setup an Airship account from A-Z
These are the steps you will need to complete in order to make sure Airship is configured correctly in all the relevant places:
1. Create a Distribution Certificate and P12
Steps to follow:
1. Access to the client's developer account here
2. Click on Certificates, IDs & Profiles:
3. If you already have a certificate created then you need to select on the relevant Certificate and click on Download - this is the public key:
4. Activate the Certificate by double-clicking the recent downloaded one and see that it's being added to Keychain.
5. On your Keychain right click on the Certificate and click on Export certificate. Change the type to P12, give it a relevant name (for example ApplicasterDistributionCertificate) and it will ask for a password. Use 12345.
***Note - if you are trying to save the certificate and the format p.12 is not available for you, please follow the steps bellow:
A. Open the 'keychain', delete the certificate that you just created from the list
B. go to 'category' (down on the left side) and click on 'My Certificate', drag the cer. to the list and repeat step 5. ( the p12 file format is available now ).
6. Make sure you keep the P12 file here for future use -
*** DO NOT DELETE CERTIFICATE FROM APPLE DEVELOPERS CONSOLE NOR FROM THE FOLDER.
2. Create a Firebase Server key and Sender ID for Firebase Cloud Messaging (If your client controls their own Firebase account, please ask them to provide the app's Server key and the app's Sender ID)
Steps to follow:
1. Go to your designated Firebase console or click here - https://console.firebase.google.com
2. Sign in using your credentials
3. Click on add project
4. In the example below , we create an app named Applicaster Support, or use the name of your existing app.
5. As we are focusing on the Server Key and Sender ID for Airship we'll skip the request to create Google Analytics for Firebase (You can change this later)
6. After the new project is created, click on continue:
7. This was just the project, now we'll go ahead and create the desired apps inside of that project. Since we recently created a new p12 from Apple Developer console and since this manual show's how to configure push notification in your app we will go ahead and create an Android app. Please mind that you will have to create an iOS app later if you want to use Google Analytics for Firebase.
Click on the Android icon:
8. Insert your Android package name (Bundle ID) e.g (com.company.appname), you can find your Android package name (Bundle ID) in Zapp (https://www.zapp.applicaster.com). Go to any version in zapp you want to be able to send pushes to and under the version settings on the General section you can find your Package name
Copy the Bundle Identifier and paste in Firebase now
9. On the same screen give your app a Nickname so you could always identify it (And others).
10. Leave the Debug signing certificate SHA-1 blank and click Register App
11. In step 2 you Download the google-services.json if you'd like to use later Firebase Analytics and click Next, if not you can skip this step and click Next
12. In step 3 just click Continue to Console
13. Now that the app have been created you need to extract the Server Key and Sender ID. Click on the new created app and go to the settings section
14. Click on the Cloud Messaging tab
15. Save your Server Key and Sender ID somewhere because you will need them later in this manual
3. Fill out the following form here
The form will open a new ticket for support team with your request and they will be in charge for opening the account in UA website.
4. Add Airship to Zapp
This is a mandatory step in order to make the pushes work from Airship.
We assume our app was already created on Airship as a new form has been placed to support in the previous step. The process is the same for iOS and Android.
Steps to follow:
1. Log into Airship and select your app.
2. Click on Settings -> APIs & Integrations.
3. Copy the App Key and the App Secret.
4. Log into Zapp, choose your app and version, and click on Plugin configurations.
5. Add the plugin Urban Airship (unless you already did) by writing it on the top right box and save it.
6. Update the plugin to it latest version
Edit the plugin by clicking on the Settings button.
7. Paste the keys from Airship that you copied in step 3 in the Debug key / Debug secret fields (or Pro key / Pro secret if we are talking about Production).
Make sure you have both Debug fields and Production fields filled (if you don't have debug keys, add production keys instead) - Otherwise, the app will crash.
8. Go to edit the main app page and click "edit app"
9. Type your Server key and Sender ID you stored in step 15 of Firebase configuration and then click save
10. Your are all set, run new builds for iOS and Android versions.
Related helpful articles:
- Upload iOS version to TestFlight in order to test push notifications on iOS
- Send a test push to iOS and Android
- Configure Alerts Page in case the customer wants to use segmented push notifications
- Configure new Segments