iOS configuration for rich notifications

How to configure my iOS build for rich push notifications?

To send rich notifications to your app users, you must first configure your app build first. The sections below outline the process of configuring rich push notifications:

Step 1: Set up Firebase

  • Navigate to Google Firebase and create a new project, if you haven’t already created one during the Andoid build configuration process. Refer to the guide to learn how to create a Firebase project.

iOS configuration for rich notifications
  • On the Project Overview screen, click on Add app and select iOS.

  • Next, you will be required to enter your Apple bundle ID. Navigate back to your AppMySite app dashboard and copy your Apple bundle ID.

  • Enter the bundle ID, give your app a nick name and enter your App Store ID. Then click on "Register app."

Step 2: Obtain and Configure Your Firebase Service Account Key

  • Go to your Google Firebase account.

  • Select the project you created for your iOS app.

  • In the Project Overview screen, click the gear icon near the top-left and select Project settings from the dropdown menu.

  • In the Settings page, navigate to the Service accounts tab.

  • Under the Firebase Admin SDK section, click on Generate new private key.

  • Confirm the action in the popup dialog. A file with a .json extension containing your service account key will be downloaded automatically.

  • Locate this .json file on your computer.

  • Go to your AppMySite app dashboard.

  • Navigate to Notification Build Settings under the relevant app.

  • Upload the .json file to the Google Firebase configuration field.

  • Save the changes to finalize the configuration.

Step 3: Generate APNS certificate and Upload

  • Log in to your Apple developer account.

  • Click on Certificates, Identifiers & Profiles.

  • Navigate to the Certificate screen. Click on the add(+) button to generate a new Certificate.

  • Select Apple Push Notification services SSL (Sandbox & Production).

  • Next, click on Continue.

  • Select the App ID (Bundle ID) corresponding to your app.

  • Upload a Certificate Signing Request. Follow this guide to generate a CSR file.

  • Download the certificate.

  • The downloaded to certificate will be in the CER format, which will need to be converted into p12 using keychain access.

  • Double click .cer file to open Keychain Access window.

  • Click on Login and navigate to the My Certificates tab in the Keychain Access window.

  • Right-click on the .cer file and export it to your system.

  • Give your certificate a unique name and select .p12 File Format.

  • Protecting your certifcate with a password is optional

  • Upload the certificate in the APNS Certificate in your AppMySite account.

  • Submit the password if you protected your certificate.

Step 4: Generate Notification Identifier

  • Log in to your Apple developer account.

  • Click on Certificates, Identifiers & Profiles.

  • Select Identifiers from the side bar.

  • Click on + next to the Identifiers.

  • Select App IDs then click on Continue to proceed.

  • Select App & enter a description of the identifier.

  • Copy the Notification Bundle ID from the Build Settings screen from AppMySite.

  • Paste it in the Bundle ID field.

  • Then, click on Continue to proceed.

  • Register to confirm the app identifier that you’ve created.

  • Your Notification Identifier has been created.

Step 5: Obtain and Upload Your Notification Provisioning Profile

  • Navigate to the Certificates, Identifiers & Profiles section in your dashboard.

  • In the sidebar, click on Profiles under the Provisioning Profiles section.

  • Click the + icon in the top-right corner to create a new provisioning profile.

  • In the profile creation screen, select App Store Connect as the distribution type and click Continue.

  • From the list of available App IDs, select your Notification Bundle ID associated with the app and click Continue.

  • Choose the certificate associated with your app's provisioning profile and click Continue.

  • Provide a name for your provisioning profile in the Profile Name field (e.g., "Notification Provisioning Profile").

  • Click Generate to create the profile.

  • Once the profile is generated, click Download to save the file. It will have a .mobileprovision extension.

  • Return to your AppMySite dashboard.

  • Navigate to the Notification Build Settings section for your app.

  • Upload the .mobileprovision file in the Provisioning Profile field.

  • Save the changes to complete the configuration.

Last updated