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.

Click to enlargeClick to enlarge

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

Here's how you can configure Push for each OS:

Android

Click to enlargeClick to enlarge

Click to enlarge

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 Server Key

The FCM Server Key is a secret code of sorts 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.

Step 3: Click Save
Step 4: Enable more apps

Click the Plus icon to enable Push for more apps

iOS

Click to enlargeClick to enlarge

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 is selected at Step 1**

Click to enlargeClick to enlarge

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
Step 7: Enable more iOS apps

Click the Plus icon to enable Push for more iOS apps.

If Certificate is selected at Step 1

Click to enlargeClick to enlarge

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
Step 6: Enable more iOS apps

Click the Plus icon to enable Push for more iOS apps.

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.

Credentials

Click to enlargeClick to enlarge

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

Click to enlargeClick to enlarge

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

Click to enlargeClick to enlarge

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.

Click to enlargeClick to enlarge

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?