This guide explains how to set up a connection that sends gameplay data from your Optimove Minigames campaigns directly into Optimove.

Note
As of September 25th, this integration is automatic for new clients. The system now captures valuable player data, such as scores, prizes won, and leaderboard names, via the standard ootb_adact_game_finished event.

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

Before You Begin (Prerequisites)

Before starting, please ensure you have the following:

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

Part 1: Verifying the Optimove Gamify Event in Optimove

For clients onboarded after September 25th, the required event for this integration is available out of the box. You simply need to verify it is active.

Step 1. Check for the OOTB Event

In Optimove, navigate to Settings > Events.
Search for the event key: ootb_adact_game_finished.
Ensure the event is active.

(Note: If you are an older client or do not see this event, you may need to switch your existing campaigns to use this new event key).

Available Event Parameters

The ootb_adact_game_finished event automatically captures the following gameplay data, which you can use for segmentation and triggering:

Parameter Name	Type	Description
`score`	Number	The score the player achieved in this specific session.
`prizeTitle`	String	The public-facing name of the prize won (e.g., "10 Free Spins").
`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.
`timesPlayed`	Number	The cumulative number of times the player has played this game.
`gameType`	String	The type of Adact game played (e.g., "Wheel of Fortune").
`highestScore`	Number	Highest score the user has ever achieved in this game.
`gameDurationInSeconds`	Number	Total length of the game session in seconds.
`eventEmail`	String	Email specifically included in this event payload.
`campaignId`	Number	Identifier of the campaign.
`unexpectedFinish`	Boolean	1 if the game ended unexpectedly (tab closed, exit). 0 if completed normally.
`tag`	String	A tag to categorize or label the session, such as event type, user segment, or specific game variant.
`email`	String	The email address of the user who participated in the game session or the associated event.

Part 2: Building a Real-Time Triggered Campaign

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

Step 1. Create a New Real-Time Trigger

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

Step 2. Configure the Trigger's Event

For the event, choose the ootb_adact_game_finished event.
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 MInigames 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

From the Real-Time Trigger view, click Create campaign. Alternatively, you can navigate to Execute > Campaign Builder > Triggered Campaign.
Assign the trigger you created in the previous step to this new campaign.
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.