WonderPush allows you to create popups and push notifications on mobile and web and track the key performance indicators of your campaigns. Once you've linked your WonderPush contacts with Brevo, you can combine WonderPush with Brevo's features.

Good to know

• We provide a quick overview of how to get started with WonderPush in Brevo. For more complete and detailed instructions, check the WonderPush documentation.

• From Brevo, you can view and launch push and popup campaigns and check basic statistics, but most features are handled in the WonderPush dashboard. As an external tool, WonderPush isn’t fully integrated into Brevo yet. To learn more about WonderPush, check our dedicated article What is WonderPush?.

⚙️ Install push notifications and popups

The configuration for push notifications and popups is the same, and only depends on what platform you want to install them on.

Step 1: Select your installation option

1. From Brevo, go to Campaigns.
2. Click Create campaign.
3. Click Push.
4. Click Configure push notifications. You are redirected to the WonderPush dashboard.
5. Select your setup type. You can check the related guide under the different options for more information, depending on the installation option you choose.
   

Step 2: Install push notifications 

Each installation option has different instructions. You can install push notifications on:

• your website
• iOS or Android

🌐 Set up Web push notifications

For a typical website installation:

1. Fill in your website information:
   • Site name
   • Site URL
   • Site icon
2. Activate, deactivate, and customize the subscription prompts.
   ➡️ To learn more, check the dedicated WonderPush article Subscription Prompts.
3. To activate WonderPush on your website, copy and paste the code from your dashboard into every page of your website. If you do not have access to your site's code, get help from a developer.
4. Upload SDK files:
   💡 Good to know

   If your website uses its own service worker, check the dedicated WonderPush article Service Worker Integration.

   1. Click Download SDK files to download wonderpush-sdk-files.zip.

   2. Unzip the archive and upload its content to the top-level root of your website directory to make it publicly accessible.

5. (Optional) If you want to integrate WonderPush into your Progressive Web Apps (PWA):
   1. Check your PWA manifest.
   2. Check your Service Worker integration.
      ➡️ To learn more about integrating WonderPush to your PWA, check the dedicated WonderPush article Progressive Web Apps.

➡️ To learn more about installing web push notifications, check the dedicated WonderPush article Web Push Notifications.

📱 Set up iOS or Android push notifications

To install push notifications on iOS or Android:

1. Go to Platforms.
2. Select iOS application or Android application.
   💡 Good to know

   If you're using a cross-platform framework, check the dedicated WonderPush articles for specific instructions for Cordova, React Native, and Flutter.
   iOS application Android application

   If you've selected iOS application as a platform:

   1. Upload your push credentials.
   2. Create the notification service extension.
   3. Integrate WonderPush to your Xcode project.
   4. Add device capabilities.
   5. Add the required code.

   ➡️ To learn more about installing push notifications on iOS, check the dedicated WonderPush article iOS Push Notifications.

   If you've selected Android application as a platform:

   1. Configure Firebase credentials for Android.
   2. Add the SDK as a dependency.
   3. Configure the SDK and prompt users.
   4. Sync Gradle and build.

   ➡️ To learn more about installing push notifications on Android, check the dedicated WonderPush article Android Push Notifications.

You will receive the default welcome notification a few minutes after completing the setup.

Step 3: Link your WonderPush contacts with Brevo

Use a common identifier to link your existing Brevo contacts with the User ID in the WonderPush SDK. Without this connection, new push notification subscribers will create separate contacts that won't have access to the contact attributes you have carefully built over time.

➡️ To learn how to link your WonderPush contacts with Brevo, check the dedicated WonderPush article User IDs. Depending on your use of Brevo, there are a few options available to achieve a good integration.

💬 Create your first notification or popup

You can now create and send push notifications and popups on the platform for which you've completed the setup.

Push notification Popup 

To create a notification:

Go to: From the Push dashboard: Notifications > Create notification. From Brevo: Campaigns > Create campaign > Push. Configure your notification. Click Save notification. To launch the campaign: If you've chosen to send this notification manually, click FIRE. If you've chosen to send this notification on a specific date, periodically, when a subscriber performs an event, or after a subscriber becomes part of the audience, click ACTIVATE.

➡️ To learn more, check the dedicated WonderPush article Push notification editor.

To create a popup:

From the Push dashboard, go to Popups > Create popup. Select an HTML template or a basic format requiring no coding. Configure your popup. Click Save popup. Activate the popup.

➡️ To learn more, check the dedicated WonderPush article Getting started with popups.

📊 Overview dashboard

The Overview dashboard provides detailed analytics of your push notifications and popups.

There are two sets of metrics on the Overview page:

• metrics related to notifications,
• metrics related to unique subscribers.

The following tables show the metrics available by default in the Overview page and a short description, for push notifications and popups.

You can choose which metric to show, select a date range and precision, filter by platform, and even add your own metrics.

➡️ To learn more, check the dedicated WonderPush article Using the dashboard.

🕵 UTM parameters

UTM parameters are tracking tags that you add to the end of URLs to measure your campaign performance. You can globally configure utm_* (and other) query string parameters to be added to your push notifications and popups target URLs.

Configure your UTM parameters

To configure UTM parameters, from your WonderPush dashboard, go to Settings > UTM parameters.

The following table shows what settings you can use to start:

➡️ To learn more, check the dedicated WonderPush article UTM Parameters.

🫖 Pressure management

Pressure management provides tools to avoid overwhelming users with push notifications while efficiently re-engaging them. Using pressure management helps prevent users from deactivating push notifications on your website or app, helping your retain subscribers. Pressure management is also recommended for automation.

To manage pressure settings, from your WonderPush dashboard, go to Settings > Pressure.

Pressure settings allow you to define:

• Frequency capping: limits the maximum number of messages per hour, day, or week that a device can receive from a given app or website.
• TTL (Time To Live): defines the maximum amount of time that push gateways (Apple, Google...) try to deliver the notification.
• Delivery speed: regulates the rate at which notifications are sent, preventing overloading your server.
• Display rules (web): configures the intrusiveness of the display mode on the user's device, or following a long shutdown of the device.

To learn more, check the dedicated WonderPush article Pressure management.

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.