Eagle Eye is a loyalty platform that allows you to reward participants with vouchers or loyalty points when they interact with your Playable campaign. This integration connects your campaign to your Eagle Eye loyalty program, enabling automatic reward distribution based on participant actions.
In this article
In this article, we’ll walk through how to set up and configure the Eagle Eye integration in Playable. We will cover how to:
What does the integration do?
With the Eagle Eye integration, you can:
Issue vouchers when users register
Award loyalty points when users win prizes
Combine both voucher issuance and points rewards
Validate whether a participant has an active loyalty account before allowing registration
Add the Eagle Eye integration
To add the integration:
Go to the Integrations tab in your campaign
Click Add Integration
Select Eagle Eye
Configure the Eagle Eye integration
After adding the integration, configure the following settings.
Authentication:
Enter the following credentials provided by Eagle Eye:
Environment
Client ID
Client Secret
Select integration mode
Mode (1) | Defines how rewards are distributed |
Eagle Eye campaign (2) | Defines which voucher is issued (if applicable) |
Enable validation (3) | Restricts participation to users with an active loyalty account |
Error page (only applicable if validation is enabled) | Redirect page if validation fails |
Select trigger and conditions
The Eagle Eye integration is event-based and triggers actions depending on user behavior.
Triggers
The triggers available depend on the placement of your registration form(s) and whether you have included prizes in the campaign.
Trigger Name | Event that Triggers Data Transfer |
Primary registration form submitted | Data is sent every time the primary registration form (containing the email field) is submitted |
Game completed | Data is sent as soon as the game status is known (winner or loser), only if the primary registration form has already been submitted. Note: this option is only available if registration form is placed BEFORE the game. |
Prize won | Data is sent when a regular prize has a winner assigned (whether or not the game has been completed) |
Bulk prize won | Data is sent when a bulk prize has a winner assigned (whether or not the game has been completed) |
Conditions
It is possible to add additional conditions to the trigger. Together with the trigger, these must be met in order for the data to be transferred.
Using the form field option you can define a specific field in the registration form(s) that must be filled out.
With the advanced option you have the option to set up a data flow based on more complex conditions. For example, the trigger could be based on performance in the game or a specific selection or data input in the registration form.
Reward modes
The Eagle Eye integration supports three reward modes. Each mode defines when rewards are triggered and what type of reward is issued.
Issue ticket
Issues a voucher when a participant registers.
Behavior | Details |
Trigger | Registration |
Reward | Voucher |
Wallet ID | Required |
Account ID | Not required |
Eagle Eye campaign | Required |
Use this mode when all participants should receive a voucher upon registration.
Points only
Awards loyalty points when a participant wins a prize.
Behavior | Details |
Trigger | Prize won |
Reward | Points |
Wallet ID | Required |
Account ID | Required |
Eagle Eye campaign | Not required |
Use this mode when only winners should receive rewards.
Issue points ticket
Combines both voucher issuance and points awarding.
Behavior | Details |
Trigger | Registration + Prize won |
Reward | Voucher + Points |
Wallet ID | Required |
Account ID | Required |
Eagle Eye campaign | Required |
Use this mode when all participants should receive a voucher, and winners should also receive points.
Set up Wallet ID and Account ID
The integration requires identifiers to match participants with their loyalty accounts.
If your campaign does not already include the required identifiers, Playable will automatically add them to your registration form when the Eagle Eye integration is configured.
The fields added depend on the selected mode:
Mode | Fields added |
Issue ticket | Wallet ID |
Points only | Wallet ID and Account ID |
Issue points ticket | Wallet ID and Account ID |
These fields are added as hidden fields, meaning they are not visible to participants.
You must still ensure that the correct values for these fields are passed into the campaign URL.
Parameters definition:
wallet_id
account_id
Wallet ID
Identifies the participant’s loyalty wallet
Automatically added as a hidden field in the registration form
Must be passed into the campaign URL
Account ID
Identifies the loyalty account used for point rewards
Required for any mode that includes points
Ticket validation
If validation is enabled:
Scenario | Result |
Wallet is valid | Registration continues |
Wallet is invalid or inactive | Participant is redirected to the error page |
Use validation when the campaign should only be available to existing loyalty members.
Points Mapping
When using a mode that includes points (Points only or Issue points ticket), points are configured directly on the prize level.
Go to your Bulk prize settings
Create or edit a bulk prize
Locate the Eagle Eye points field
Enter the number of points to award for that prize
Each bulk prize can have its own point value.
Test the Eagle Eye integration
Before going live, test your setup based on the selected mode.
Issue ticket
Open the campaign with a valid Wallet ID
Submit the registration form
Confirm that a voucher is issued
Points only
Open the campaign with Wallet ID and Account ID
Play the campaign and win
Confirm that points are awarded
Issue points ticket
Open the campaign with Wallet ID and Account ID
Submit the registration form and confirm voucher issuance
Win the campaign and confirm points are awarded
Troubleshooting
Issue | Cause | Solution |
Voucher not issued | Missing or invalid Wallet ID | Ensure Wallet ID is passed into the campaign URL |
Points not awarded | Missing Account ID | Ensure Account ID is included |
Validation fails | Wallet not found or inactive | Verify wallet exists in Eagle Eye |
Campaign not selectable | Campaign is inactive | Ensure the Eagle Eye campaign is active |
Rewards not triggered | Incorrect mode | Verify the selected mode matches your setup |