Push

Step-by-step guide to configuring Push as a channel

Push Notifications are messages that pop up on mobile devices. App publishers can send them at any time, even if users are not currenly active on the app or using their device.

🚧

Please Ensure That Your App is Integrated with WebEngage Before Proceeding

Enable Push Messaging for your App

Once you've integrated your app with WebEngage, you will need to implement additional configurations to ensure that your users receive the Push Notifications. Depending on the OS, you may need to implement additional configurations like:

🚧

Step-by-step Guides to Enable Push Messaging

As shown below, navigate to the Data Platform> Integrations> Channel Integration Status> Push Setup (Configure)> Push of your dashboard to enable the channel.

14251425

Click to enlarge

The section has been divided into two sub-sections, Credentials- which lists all the integrated Packages/ Bundle IDs and Select OS which allows you to configure Android and iOS for push notification.

Select OS

Select OS for which Push needs to be configured: Android or iOS:

Android

For Android, WebEngage offers multiple push messaging integration (listed below). But to get started adding FCM push service is mandatory.

Adding FCM keys

To get started, you are required to add FCM Push service keys.

14251425

As shown above:

Step 1: Add Package Name

The Android app's application ID is also referred to as the Package Name. You can find it in your module (app-level) Gradle file, usually app/build.gradle (example package name: com.yourcompany.yourproject).

Step 2: Add FCM Creds

The FCM App Secret is a secret key that enables your WebEngage dashboard to communicate with your Firebase project. It enables us to send the Push Campaigns for delivery to your target audience.

  • It can be found under the Firebase Project > Project Settings > Cloud Messaging section in your Firebase Developers Console.

  • Copy + paste it into your WebEngage dashboard.

Enhanced Delivery Options

18681868

For better delivery and impression rates on Chinese OEM devices like Xiaomi and Huawei, WebEngage allows clients to add and enable the push notification services offered by these OEMs.

🚧

Please Note

Having an FCM integration is mandatory to enable these service for your app.

Add Mi Push Service Creds (Optional)

📘

Prerequisite

To enable this service, you are required to register their app on Xiaomi developer portal.

To get started with enabling Mi Push services for your app refer to this doc.

This is an enhanced delivery service for Xiaomi devices for clients who are looking to improve their delivery and impression rates on devices manufactured by Xiaomi. Once enabled, we will attempt notification via FCM and Mi push services on these devices.

To enable Enhanced Push messaging via Mi Push Services, you are required to add 'App Secret' with the same package name.

Add Huawei Push Service Creds (Optional)

📘

Prerequisite

To enable this service, you are required to register their app on Huawei developer portal.

To get started with enabling Mi Push services for your app refer to this doc.

Similar to Xiaomi, this is an enhanced delivery service for devices manufactured by Huawei. Once enabled, we will attempt notification via FCM and Huawei push services on these devices.

To enable Enhanced Push messaging via Huawei Push Services, you are required to add 'Client ID' and 'Client Secret'. This needs to added in the following JSON format in App Secret field for Huawei Messaging Service:

{"clientId":"your client ID","clientSecret":" your Client Secret","grantType":"client_credentials"}

Image for reference:

16301630

Once all the required integrations are added, Click Save.

Enable more Android apps

WebEngage allows you to add more than one Android app in a single project. To add simple click on Android icon and follow the steps mentioned above.

iOS

14251425

Click to enlarge

As shown above:

Step 1: Select APNs Authentication Type
  • Select Auth Key to connect your app by uploading the Auth Key file created by your tech team.

    • This method allows you to connect multiple app with your WebEngage account as a common Auth Key can be shared by multiple apps, registered to the same Apple Developer Console. (Setting up multi-app support)

🚧

Continue Push configuration via Auth Key

  • Select Certificate to connect your app by uploading the APNs Push Certificate.
    • This method allows you to connect only one iOS app with your WebEngage account.
    • You will need to re-generate the Push Certificate every year.

🚧

Continue Push configuration via APNs Push Certificate

If Auth Key selected at Step 1

14401440

Click to enlarge

Step 2: Upload Auth Key file

As shown above, click the Upload button to add the Auth Key file.

  • You can download the Auth Key file from the Certificates, Identifiers & Profiles > Keys section in the Apple Developer Console. (Please don't rename the file).
Step 3: Add Team ID

The Team ID is located under Membership > Team ID in the Apple Developer Console.

Step 4: Add Bundle Identifier

The Bundle Identifier can be found in Xcode.

Step 5: Select Default Push Mode

As shown in the above visual:

  • Select Development to test Push integration for an iOS app that's currently under development (not available for download at the app store).

  • Select Production to start sending Push Notifications to all users who have downloaded your iOS app.

Step 6: Click Save

If Certificate selected at Step 1

14401440

Click to enlarge

Step 2: Upload Push Certificate

As shown above, click the Upload button to add the Push Certificate.

Please get in touch with your tech team to upload the Certificate and complete configuration. APNs Push Certificate can be created through the Certificates, Identifiers & Profile > Identifiers > App ID section in the Apple Developer Console. (Step-by-step guide)

Step 3: Enter Push Password

Enter your certificate Push Password.

Step 4: Select Default Push Mode

As shown in the above visual:

  • Select Development to test Push integration for an iOS app that's currently under development (not available for download at the app store).

  • Select Production to start sending Push Notifications to all users who have downloaded your iOS app.

Step 5: Click Save

Enable more iOS apps

WebEngage allows you to add more than one iOS app in a single project. To add simple click on iOS icon and follow the steps mentioned above.

Test Push Integration

Test your integration by sending a Push Campaign to an internal segment (including only yourself and your teammates). (Step-by-step Guide to Creating Segments)

👍

Congratulations!

You're now ready to engage users through Push Notifications.

Manage Credentials

14251425

Click to enlarge

As shown above, integrated channels are listed under the Credentials section. Here you can manage your configurations i.e., Edit or Delete the integration anytime you like by accessing the Actions menu placed on the extreme right.

Editing a Channel

You can choose to edit configuration details in cases where incorrect details were entered during configuration or update some details post-integration.

As shown below, select Edit from the Actions menu, make your changes.

For Android

14251425

Click to enlarge

As shown above, for Android devices, you can edit the Package Name and/ or FCM Server Key by clicking on the Pencil icon next to it. Click Save to save the changes.

For iOS

14251425

Click to enlarge

Click Reset to reset the configurations and click Save to save the changes after editing.

Deleting a Configuration

Deleting a configuration will cease campaign delivery for all Running and Upcoming campaigns where the respective configuration was selected for sending it. In such cases, you will be prompted by the message informing you that campaign(s) is running and hence the configuration cannot be deleted.

Thus, please ensure that no existing campaigns are dependant on the configuration (you intend to delete) for sending Push Campaigns to your users.

As shown below, select Delete from the Actions menu, and click the Delete button in the pop-up to confirm your decision.

14251425

Click to enlarge

Please feel free to drop in a few lines at [email protected] in case you have any queries or feedback. We're always just an email away!


So, what's next?

Let's help you launch your first Push campaign!

Did this page help you?