Optimove campaigns

Create and send campaigns in Xtremepush using an Optimove integration

To create an Optimove campaign via Xtremepush you need first to create a campaign on the Xtremepush dashboard and then use this campaign as a template on the Optimove dashboard.

Make sure your Optimove integration is configured.

Create an Optimove campaign in Xtremepush

Navigate to Create Campaign and click on Optimove Campaign.

Enter a campaign name and choose engagement channels in the Setup tab. You can also enable A/B testing, multi language support and set a campaign goal to track conversions.

Enter message content for every engagement channel to be used in your campaign. If you have Optimove personalisation parameters configured, they will be available for use in the content. Use the Xtremepush Personalisation and dynamic programmable content capability as normal and if Optimove parameters are available, they will appear in the list of available parameters by clicking on the Optimove button and can be added with the format {{ optimove.PARAM_NAME }} as shown below. Insert them into your content as needed.


Optimove parameters

These need to be enabled beforehand. Get in touch with your Account Manager to get this configured.

Add additional segmentation rules in the Segment tab if needed. If you choose All Users the message will be sent to all users segmented by the Optimove campaign. If you choose Target Users and add additional segmentation rules, the message will be sent to the subset of users segmented by the Optimove campaign that match your criteria.


Optimove campaign templates are scheduled in Optimove, but options to stop the campaign can be set in this tab. There can be up to three channels to select from, of which only one can be selected. The channels available are dependent on the setup defined in the Optimove integration in set-up in Settings > Integrations > Marketplace. See Optimove for more information.

Schedule tab for Optimove campaigns.Schedule tab for Optimove campaigns.

Schedule tab for Optimove campaigns.

This example shows an integration with 3 options

  • Xtremepush: This will save an Optimove scheduled campaign template on the Xtremepush channel
  • Xtremepush WebPush: This will save an Optimove scheduled campaign template on the Xtremepush Web channel
  • Triggered In App - This will save a real time Optimove Track and Trigger campaign template

Put the template live when you are ready by clicking Save Optimove Template.

Live campaigns

Live Optimove campaigns will appear in Campaigns > Live Campaigns, with a campaign type of Optimove Triggered.

The campaign should now also be visible in Optimove under the Xtremepush or Xtremepush Web Channel.


For users integrated before the addition of the Optimove Campaign Button

If you were running Optimove Campaigns before the dedicated Optimove campaign button was added, your workflow would have been a little different. You would have added campaigns by going to the create campaign page and clicking on API Triggered Notification, then you would have saved your template campaign by clicking Save as Draft. You can now use the approach described above, but campaigns created using old approach are still supported.

Try with a test audience first

If you want to test your content internally before putting it live you can do so.

First get a list of user IDs for internal test users. Then navigate to Data > Audiences and click Create Segment in the Segments tab to create a new segment for your test users. Add a condition based on Identifiers > User ID (this is the player/customer user ID you are using to sync platforms). Choose the One of operator and enter the list of IDs.

When you want to test a campaign, add this segment to your campaign in the Campaign > Segment tab and then trigger it from Optimove. The condition you need to add is Segment > include > Test Users and when you click the Calculate button to check the number of recipients you should see it matches the number in the test list.

Create a campaign in the Optimove platform

When the campaign being sent is controlled by Optimove, navigate to One to One campaigns > Campaign builder from the Optimove dashboard and first choose the target group. Complete the Scheduling section and finally in the Execution Details section choose the action from the dropdown menu and select from the available Xtremepush channels:

  • XtremePush is typically used for mobile App push (and or SMS, Inbox and email campaigns).
  • XtremePush Web is typically used for Web Push (and or SMS, Inbox and email campaigns).

Finally select one of the existing Xtremepush campaigns by clicking on the Template(s) dropdown. It is possible to select more than one template at once.

Launch the campaign. It will be automatically created and executed by the Xtremepush platform.

Confirming execution of campaign

When an Xtremepush campaign is scheduled from Optimove, an API call is sent with a campaign send time and a list of Optimove campaign IDs that match to the Xtremepush user ID.

When this API call is received by Xtremepush a duplicate of the Optimove template is created in Xtremepush as a scheduled campaign. The Campaign name of this scheduled campaign will have the send time appended to it. This new campaign that is created can be found in Live Campaigns until it has been executed by Xtremepush, when it will be moved to the Past Campaigns menu. This new campaign will be a Scheduled campaign and stats will be attached to it (accessibly by clicking on the button on the right of the campaign > Analytics).

Updated 4 months ago

Optimove campaigns

Create and send campaigns in Xtremepush using an Optimove integration

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.