Skip to main content

How to Trigger Optimove Campaigns with Adact Gameplay Data

blair_m
  • Updated

This guide explains how to set up a connection that sends gameplay data from your Adact campaigns directly into Optimove. By creating a custom event in Optimove, you can capture valuable player data such as their score, the prize they won, and their leaderboard name.

Ultimately, this integration will enable you to launch real-time, triggered marketing campaigns in Optimove based on how your users interact with your Adact games.

Before You Begin (Prerequisites)

Before starting, please ensure you have the following:

  • Administrator-level access to your Optimove environment.
  • An Adact campaign that is ready to be published.
Please note
Data is only delivered from campaigns in a "Published" state. Draft, Expired, and Paused campaigns do not collect or send any data.

Part 1: Setting up the Adact Event in Optimove

The first step is to create a new "Simple Event" in Optimove that will listen for the data coming from Adact.

Step 1. Create a New Event

  1. In Optimove, navigate to Settings > Events > Add New Event.
  2. Set the Event Display name to adact-game-finished.
  3. Set the Event Type to Simple Event.

Step 2. Add Event Parameters

Next, add all the individual properties that will be captured from the Adact gameplay session.

Parameter Name Type Description
highestScore Number The highest score the player has achieved in this game.
gameType String The type of Adact game played (e.g., "Memory Game").
gameDurationInSeconds Number The duration of the gameplay session in seconds.
score Number The score the player achieved in this specific session.
gameplayCount Number The total number of times the player has played this game.
prizeCode String The unique code associated with the prize won, if applicable.
isWinner Boolean A true/false value indicating if the player won a prize.
prizeTitle String The public-facing name of the prize won (e.g., "10 Free Spins").
email String The email address of the player.
event_email String An alternative email field if required by your Optimove configuration.

Step 3. Save and Publish the Event

  1. Click the Save Event button on the bottom right of the screen.
  2. Return to the main Event list and click Publish to production.

After publishing, Optimove is now configured to listen for and capture incoming data from your Adact campaigns.

Part 2: Building a Real-Time Triggered Campaign

With the event now active, you can create a trigger that launches a campaign when specific conditions are met.

Step 1. Create a New Real-Time Trigger

  1. Navigate to Plan > Real-Time Triggers.
  2. Create a new trigger within a new or existing category.
  3. For the Trigger Name, enter a descriptive title that reflects its purpose, such as Adact Prize Winner.

Step 2. Configure the Trigger's Event

  1. For the event, choose the adact-game-finished event you created in Part 1.
  2. Specify the parameters required to activate the trigger. This allows for powerful segmentation. For instance:
    • To target only winners of a specific prize, set the parameter prizeTitle to equal 10 Free Spins. Note that this prize name must be specified exactly the same way in the Adact campaign setup.
    • To target high-scoring players, you could set score to be greater than 100.
    • To create a campaign for non-winners, you could set isWinner to equal false.

Step 3. Create and Link the Campaign

  1. From the Real-Time Trigger view, click Create campaign. Alternatively, you can navigate to Execute > Campaign Builder > Triggered Campaign.
  2. Assign the trigger you created in the previous step to this new campaign.
  3. The rest of the campaign is set up as usual within Optimove. For more details on this, please refer to the standard Optimove documentation.

This setup will now launch a new campaign that is triggered based on the specific criteria you defined.

Related articles