01 - Enable Firebase and connect it with an iOS App
Purple Manager / 3rd party integrations
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.
- Assets from your Apple Developer account:
- Team-ID: Your Team-ID can be found in the upper right corner of the Apple Developer Portal
- Assets from App Store Connect
- App Store ID
- Assets from Purple Manager
- Package Name of your app (to be used as iOS-Bundle-ID)
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.
1. Visit firebase.google.com and open your Firebase project
2. Click on 'Project Overview'

2. Click on the gear symbol

3. Click on 'Project settings'

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

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

6. Click on 'Register app'

7. Click on 'Next'

8. Click on 'Next'

9. Click on 'Next'

10. Click on 'Continue to the console'

11. Click on 'Cloud Messaging'

12. Click on 'Upload'

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

14. Below 'Key ID' enter your Key ID

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

16. Click on 'Upload'

17. Click on 'General'

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

1. Go to Purple Manager -> 'Apps'
2. Click on 'Overview'

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

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

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

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

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

8. 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

10. Wait until the upload is finished

Next to 'Enable Firebase Analytics' check the checkbox

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

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

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

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

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

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

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

19. 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