3rd party integrations
...
Firebase
Connect Firebase to your Purpl...

01 - Enable Firebase and connect it with an iOS App

18min

Purple Manager / 3rd party integrations



Summary

This article guides you step by step through the process of connecting Firebase to your iOS App.

You will activate Firebase for your Purple app, connect your Purple iOS app with Firebase and activate the following service:

For your Purple App (independent of operating System):

  • Firebase Analytics
  • Firebase Crashlytics

For your Purple iOS app (iOS only)

  • Firebase Analytics
  • Firebase Crashlytics
  • Firebase In-App Messaging
  • Firebase Cloud Messaging
  • Firebase Debug Mode (Preview App only, doesn't work for live apps)
  • Push for App
  • Push registration on App start

If you wish not to use one of the above mentioned services, just don't check the according check box in Purple Manager to skip it's activation.



Preconditions

If you don't have prepared these assets, you can find the appropriate instructions to create them in the Preconditions for Test & Submit of an iOS App folder.



How to

Set up your app in Firebase

1. Visit firebase.google.com and open your Firebase project

2. Click on 'Project Overview'

Click on 'Project Overview'


2. Click on the gear symbol

Click on the gear symbol


3. Click on 'Project settings'

Click on 'Project settings'


4. Below 'Your Apps' click on the iOS icon

Click on the iOS icon
Step 4 screenshot


5. Add the iOS-Bundle-ID of your app (App Package Name in Purple). Optionally, you can add your App Nickname and your App-Store-ID

Add the iOS-Bundle-ID of your app


6. Click on 'Register app'

Click on 'Register app'


7. Click on 'Next'

Click on 'Next'


8. Click on 'Next'

Click on 'Next'


9. Click on 'Next'

Click on 'Next'


10. Click on 'Continue to the console'

Click on 'Continue to the console'


11. Click on 'Cloud Messaging'

Click on 'Cloud Messaging'


12. Click on 'Upload'

Click on 'Upload'


13. Click on 'Browse' and upload your APN Auth Key

Click on 'Browse' and upload your APN Auth Key


14. Below 'Key ID' enter your Key ID

Below 'Key ID' enter your Key ID


15. Below 'Team-ID' enter your Team ID

Below 'Team-ID' enter your Team ID


16. Click on 'Upload'

Click on 'Upload'


17. Click on 'General'

Click on 'General'


18. Click on 'GoogleService-Info.plist' to download the file to your computer

Click on 'GoogleService-Info.plist' to download the file


Activate Firebase services and Push in Purple Mager

1. Go to Purple Manager -> 'Apps'

2. Click on 'Overview'

Click on 'Overview'


3. Click on the three dots in the top menu bar

Click on the three dots in the top menu bar


4. In the dropdown, click on 'Consent/Push/Analytics'

Click on 'Consent/Push/Analytics'


5. Go to 'Firebase Analytics' -> 'General' -> 'Basic Settings' and click on the arrow

Go to 'Firebase Analytics' -> 'General' -> 'Basic Settings' and click on the arrow


6. Next to 'Enable Firebase Analytics' check the checkbox

Next to 'Enable Firebase Analytics' check the checkbox


7. Next to 'Enable Firebase Crashlytics' check the checkbox

Next to 'Enable Firebase Crashlytics' check the checkbox


8. Go to 'iOS' -> Basic Settings' and click on the arrow

Go to 'iOS' -> Basic Settings' and click on the arrow


9. Next to 'Firebase configuration file' click on 'Select file' and upload the 'GoogleService-Info.plist' file from your computer

Upload the 'GoogleService-Info.plist' file from your computer


10. Wait until the upload is finished

Wait until the upload is finished


Next to 'Enable Firebase Analytics' check the checkbox

Next to 'Enable Firebase Analytics' check the checkbox


12. Next to 'Enable Firebase Crashlytics' check the checkbox

Next to 'Enable Firebase Crashlytics' check the checkbox


13. Next to 'Enable Firebase In-App Messaging' check the checkbox

13. Next to 'Enable Firebase In-App Messaging' check the checkbox


14. Next to 'Enable Firebase Cloud Messaging' check the checkbox

Next to 'Enable Firebase Cloud Messaging' check the checkbox


15. Next to 'Enable Firebase Debug Mode' check the checkbox

Next to 'Enable Firebase Debug Mode' check the checkbox


16. Go to 'Push' -> 'iOS' -> 'Basic Settings' and click on the arrow

Go to 'Push' -> 'iOS' -> 'Basic Settings' and click on the arrow


17. Next to 'Enable Push for App' check the check box

Next to 'Enable Push for App' check the check box


18. Next to 'Push registration at app start' check the check box

Next to 'Push registration at app start' check the check box


19. Click on 'Save'

Click on 'Save'


20. To finish the setup, rebuild your Purple App

You have successfully activated Firebase for your Purple app, connected your Purple iOS app with Firebase and activated the following service:

For your Purple App (independent of operating System):

  • Firebase Analytics
  • Firebase Crashlytics

For your Purple iOS app (iOS only)

  • Firebase Analytics
  • Firebase Crashlytics
  • Firebase In-App Messaging
  • Firebase Cloud Messaging
  • Firebase Debug Mode (Preview App only, doesn't work for live apps)
  • Push for App
  • Push registration on App start