The integration between NuxGame and Optimove empowers clients to deliver smarter, faster marketing through both historical data synchronization and real-time customer engagement. This article outlines the key integration points and how each can be leveraged to maximize campaign performance and analysis.
Features Supported by NuxGame Integration:
Our integration capabilities, supported by NuxGame, include:
-
API Integration: Used for both Batch Data and Real-Time Event Streaming
- Batch Data Integration: Batch data ingestion for smarter segmentation
- Real-Time Streaming: Customer events are ingested immediately via Webhook
- Email (formerly OptiMail) account setup: DNS records implementation by Nux.
- Web Channel Integration (formerly OptiWeb): Engage players on your site via Web Pop-ups and Web Inbox messages.
- Promotions (formerly OptiPromo): Grant NuxGame bonuses to players from Optimove real-time campaigns.
API Integration Setup
The core of the NuxGame integration is a single, secure API connection that is used to facilitate both batch data transfers and real-time event streaming. The following steps must be completed to establish this connection.
- NuxGame Provides Credentials: NuxGame will provide their Base input endpoint and an API Key.
- Client Registers Webhook: You will register the secure webhook provided by Optimove, which includes a Base output endpoint and an API key.
- Optimove Finalizes Connection: Optimove will use the provided details to set up and finalize the connection.
How to Integrate
To activate the integration, you will need to exchange credentials between NuxGame and Optimove.
- Obtain Credentials from NuxGame: Before you can submit the integration request, you will need to obtain your Base Input Endpoint and X-API Key from your point of contact at NuxGame.
- Implement Optimove Credentials: Optimove will provide you with an Output Endpoint and an API Key. These details must be added to your NuxGame BO Admin panel to complete the setup.
Should you need assistance with either obtaining your NuxGame credentials or adding the final Optimove details to the NuxGame panel, please contact your NuxGame representative.
Batch Data Integration
Once the API is connected, you can leverage it to ingest historical, customer, and transactional data from NuxGame into Optimove. This enables rich, accurate segmentation for your campaigns. Please note: This integration only supports Sport and Casino.
Key Benefits:
- Enables accurate customer targeting with historical data.
- Automated ingestion ensures scalability and consistency.
Integration Steps:
- For live brands, NuxGame will provide an initial historical data load via CSV files.
- The historical data will be provided in Optimove's standard schema which can be found here.
- Optimove will then pull ongoing data via the API and begin the quality assurance (QA) phase.
- Once QA is complete and the ETL is finalized, all data will be available in Optimove for your campaigns. NuxGame will also share any delta historical data.
For full details on the integration process and timelines, please reach out to your dedicated project manager or CSM.
Real-Time Streaming Capability
The same API connection is used to push real-time customer events from NuxGame to Optimove's secure webhook. This allows you to react instantly to player actions like registrations, logins, and payments to improve engagement.
Key Benefits:
- Trigger real-time campaigns based on user behavior.
- Instantly update customer attributes in Optimove.
- Gain insight into recent activity for live personalization.
Supported Events:
Out of the Box Events
These events will be part of the standard integration. This means that these data points will be available on the platform as batch data fields once batch data integration is complete.
ootb_registrationootb_loginootb_depositootb_deposit_cancellationootb_withdrawalootb_withdrawal_cancellationootb_customer_details_updateootb_game_sessionootb_game_launchootb_sports_bet_placeootb_sports_bet_settled
Custom Events
These are custom events that will be added per client's request.
kyc_verificationemail_confirmation
Each event is automatically translated into Optimove’s format, making it immediately available for your marketing activities.
Email Account Setup – DNS Records Implementation
Email is Optimove’s native Email Service Provider (ESP), built to streamline every stage of your email marketing—from creation and delivery to performance analysis—all within the Optimove platform. It enables marketers to launch highly personalized, data-driven campaigns with ease and efficiency.
Integration Steps:
- Optimove Setup: Optimove allocates a new IP address within SendGrid and creates the necessary DNS records.
- Client Implementation: Nux implements the DNS records in their domain hosting provider.
- Email Configuration by Optimove: Email is added to the Optimove UI, and the DNS records are verified.
- IP Warm-up: Email templates are created in Email, and the IP warm-up process begins.
Web Channel Integration (formerly OptiWeb)
Web is Optimove's toolkit for personalized, browser-based messaging. Through the NuxGame integration, you can engage players on your site with two Web channels: Web Pop-up and Web Inbox. Both channels run on the Optimove Web SDK implemented by Nux, as described in the Web SDK section above.
Supported Channels:
- Web Pop-up: Display targeted pop-up messages to players while they browse your site.
- Web Inbox: Deliver messages to an on-site inbox that players can open and read at any time, so your message stays available after the session ends.
Key Benefits:
- Engage players in real-time while they are active on your site.
- Personalize messages based on on-site behavior and Optimove customer data.
- Use rich media, brand-consistent templates.
Integration Steps:
- Web Setup: Optimove sets up the Web channel for your account and provides your Tenant ID and Tenant Token.
- Credentials: Share your Tenant ID and Tenant Token with your NuxGame point of contact.
- Implementation by Nux: Nux implements the Optimove Web SDK on your site and enables Web Pop-up and Web Inbox on the front end.
- Test & Deploy: Run test campaigns for each channel to confirm display behavior, then deploy to production.
Set Page Visit (fires on each page load).For full details on the integration process and timelines, please reach out to your dedicated project manager.
Promotions Integration (Bonus API)
This integration lets your Optimove real-time campaigns grant NuxGame bonuses. The bonuses you create in NuxGame appear in Optimove Promotions automatically. You set the reward value where one is needed, add the promotion to a real-time campaign, and Optimove credits the bonus to each qualifying player through the NuxGame API.
Key Benefits:
- Grant any NuxGame bonus from a real-time campaign, with the bonus rules kept in NuxGame.
- No manual promotion setup. A bonus you create in NuxGame appears in Optimove within 10 minutes.
- Players receive the campaign message only after NuxGame confirms the bonus was credited.
How It Works:
- You create and configure the bonus in NuxGame, with CRM Activation enabled.
- Optimove reads your NuxGame bonus list every 10 minutes and creates one promotion per bonus, named
Brand_BonusName. A bonus renamed in NuxGame is renamed in Optimove, and a bonus removed in NuxGame is deactivated in Optimove. - For a cash bonus or a free spins template, you set the reward value on the promotion in the Rewards step. Other bonus types need no reward.
- You add the promotion to a real-time campaign (see Allocating Promotions in Your Campaigns).
- When the campaign fires for a player, Optimove checks the player against the promotion and credits the bonus on NuxGame.
- NuxGame confirms the credit. Only players who received the bonus get the campaign message. Credited bonuses appear in the NuxGame admin under Edit Player → Statistics, in the promotions table.
Integration Steps:
- Enable Bonuses for Optimove in NuxGame: In the NuxGame admin, enable CRM Activation on every bonus you want to grant from Optimove. Without it, the bonus is not credited to the player.
- Provide Connection Details to Optimove: Share the brand name, the NuxGame base endpoint, and the API key for each brand with your Optimove onboarding contact, through a secure channel.
-
Optimove Configures and Activates the Channel: Optimove configures the NuxGame bonus channel for your site, creates the two reward types (
cash amountandfreespin amount), and starts the bonus sync. Your NuxGame bonuses then appear as promotions in Optimove, ready for real-time campaigns.
Supported Bonus Types:
| NuxGame bonus type | What you set in Optimove | How it is credited |
|---|---|---|
| ManualBonus (cash) | Reward cash amount: the amount, credited in the player's currency |
The bonus is credited, then the amount is added to the player's bonus wallet |
| SystemBonus template (free spins) | Reward freespin amount: the number of spins |
The bonus is credited with that number of spins |
| All other bonus types (deposit, welcome, cashback, accumulative, free spin bonus, and others) | Nothing. The value is defined in NuxGame | The bonus is credited as configured in NuxGame |
Setting Up Promotions in Optimove:
You do not create promotions for NuxGame bonuses. The sync creates them, named Brand_BonusName, with the brand set and a promo code assigned.
For a cash bonus or a free spins template, open the promotion and go to the Rewards step. Choose Single Reward for one value for every player, or Tiered Reward for different values per segment, and pick the reward type:
-
cash amountfor a ManualBonus. The amount is credited in each player's own currency. -
freespin amountfor a SystemBonus template. The value is the number of spins.
Leave every other promotion as it is. Its value is defined in NuxGame.
The Rewards step with the two NuxGame reward types.
Examples:
-
Cash bonus: NuxGame bonus "Weekend Cash" of type ManualBonus, brand brand_one. The sync creates the promotion
brand_one_Weekend Cash. In the Rewards step you choose Single Reward, reward typecash amount, value 50. Every qualifying player is credited 50 in their own currency. -
Free spins: NuxGame bonus "Birthday Spins" of type SystemBonus template, brand brand_one. The sync creates the promotion
brand_one_Birthday Spins. In the Rewards step you choose Single Reward, reward typefreespin amount, value 25. Every qualifying player is credited 25 spins. -
Any other bonus: NuxGame bonus "First Deposit Boost" of type DepositBonus, brand brand_one. The sync creates the promotion
brand_one_First Deposit Boost. You set nothing on it. Add it to a real-time campaign and NuxGame credits it as configured.
Campaign Behavior and Limits:
- Real-time campaigns only: NuxGame bonuses cannot be granted from scheduled campaigns.
- Player currency: A cash bonus is credited in the currency stored on the player in Optimove. A player with no currency does not get a cash bonus.
- NuxGame eligibility rules apply: If NuxGame rejects the credit, for example a welcome bonus for a player who already deposited, that player does not get the bonus. If no bonus in the campaign was credited, the player does not get the campaign message either. Target each bonus campaign at players who qualify for that bonus in NuxGame.
- One active bonus per player: NuxGame keeps one bonus active per player at a time. A further bonus stays pending until the player completes the active one.
- Repeat credits: If a player is credited the same bonus again, NuxGame reports it as already credited and the player still gets the campaign message.
Key Considerations
- Multi-Brand Support: If your operation includes multiple brands, each will require its own separate API configuration (endpoint + key).
-
Multi-Brand Bonuses: Each brand has its own NuxGame credentials in Optimove. Promotions are named
Brand_BonusName, and the brand prefix decides which brand credits the bonus.