Introduction

The integrated solution of Braze (formerly Appboy) and Optimove makes it easy to plan and execute mobile push notification campaigns, based on the advanced customer segmentation available in Optimove.

The Optimove software generates the specific lists of customer IDs that will receive each pre-planned marketing campaign and sends them to Braze, along with the Braze push notification message and scheduled send time. Optimove pushes this information to Braze via API for each campaign, and then Braze sends out the personalized push notifications at the specified time.

Setting Up the Integration

In order to set up the integration between your Optimove site and your Braze account, the following steps are required:

1. Enable Braze Push in Mobile Apps

You (or your app developer) must create an updated version of each mobile app that will support push notifications via the Braze platform, using the Braze SDK. This step must be repeated for each published app that will be used with Optimove.

Note: All app users must update their installed apps from the App Store in order to receive the new version which supports push notifications via Braze.

2. Prepare Customer Data for Import into Optimove

The customer data supplied to Optimove must contain app-user mapping information, i.e., a table indicating which apps are in use by each customer.

3. Connect Optimove to the Braze API

For Optimove to be able to connect to the Braze API, Braze must whitelist the IP addresses of Optimove’s servers. Your CSM will provide the IPs to whitelist.

No additional credentials are required.

Note: All communication between the Optimove and Braze servers is via the Braze API. For the technically inclined, the Braze Push API guide is available here.

4. Define the List of App Groups and Apps in Optimove

Braze Push manages apps using "app groups". You need to supply your CSM with the list of app group IDs to which Optimove will send push notifications.

You can find these IDs in the Braze Push dashboard’s Developer Console. When defining a campaign in Optimove, these app groups will be selectable when using the Braze channel.

5. Prepare a Braze User Account for Use by Optimove

In order for Optimove to access your Braze account, you will need to open a Braze account for Optimove, and then send the following account details to your CSM:

  1. Username
  2. Password
  3. AppGroupId (if you have multiple applications, send the name and AppGroupId for each app)
  4. The unique identifier that will be used in order to match customers between Optimove and Braze
  5. One or more test customer IDs that are contained in both your Optimove database and in your Braze Push database – this will enable us to test the integration setup

Executing Braze Push Notification Campaigns Using Optimove

1. Create and Retrieve the List of Campaigns in Braze

Since Braze Push does not support message templates, you must create specific API-triggered campaigns in Braze to be used as templates, for each app group in the Braze Push interface. These campaigns will be used to create campaign-specific messages by Optimove.

The campaigns must be created with type, "Push Notification," must have the delivery type set to "API-Triggered Delivery" and should be defined to target the "All Users" segment (for the relevant platform).

https://docs.optimove.com/wp-content/uploads/2017/04/cidimage002-png01d2bc54-2713f5e0.png

https://docs.optimove.com/wp-content/uploads/2017/04/cidimage003-png01d2bc54-2713f5e0.png

Optimove will import all the campaigns created for the listed app groups.

Note: It is recommended to use unique name prefixes for these campaigns, to help identify them as such (e.g., "Optimove_SummerSale").

2. Create a Push Notification Message Campaign

When creating a Braze Push campaign in Optimove, select "Braze Push" as the channel and then select the relevant app group from the list.

Once a specific app group is selected, the list of available templates will be filtered to display only those Braze Push campaigns that are associated with the selected group.

3. Optimove Automatically Generates the Campaign

Optimove will send the campaign to all apps in the selected app group, based on the platform defined in the Braze Push campaign. For example, if the campaign is defined for the Android platform, it will be executed for all Android apps in the selected app group.

Note: Braze’s API limits the number of push send requests to 250,000 per hour. If more requests are sent, Braze will not execute the campaign.