Skip to main content

The Mill Adventures

Blair Matheson
  • Updated

The partnership between The Mill Adventures and Optimove provides robust tools that empower clients to enhance customer engagement and drive more targeted campaigns. This article outlines the key integration points, detailing the processes and benefits of each integration.

Features Supported by The Mill Adventures Integration

Our integration capabilities, supported by The Mill Adventures, include:

  • Batch Data Integration: via S3 bucket (IAM role)
  • Real-time Event Streaming: Server-side integration for immediate customer interactions.
  • Transactional Emails: Native email execution via Optimove’s API.
  • Bonus Integration: Supports both scheduled and real-time campaigns with conditional execution flow.
  • Email Consent Management: Two-way email consent sync via API and batch data.
  • SMS Consent Management: SMS consent management via API and daily batch files. 

Batch Data Integration

Seamlessly transfer historical and transactional data to fuel data-driven campaigns and segmentation.

Data Delivery Method: Files, S3 bucket (IAM role)

Integration Steps:

  1. Connection Setup:
    • The Mill Adventures (TMA) shares the S3 bucket connection details — roleArn, roleName, and bucketName.
  2. Data Delivery & QA:
    • TMA uploads historical data files to the bucket.
    • Optimove retrieves the data and begins the quality assurance phase.
  3. ETL Setup:
    • TMA automates the batch data process.
    • Once data and ETL processes are finalized, the data is ingested into Optimove for enhanced campaign targeting and segmentation.

You can access the expected data schema used in Batch Data Integration for each vertical here. This documentation provides a comprehensive overview of the data's structure and relationships to support your integration efforts.

For full process details and timelines, please contact your dedicated project manager or customer success manager (CSM).

Streaming Data Integration

Real-Time Data Ingestion is Optimove’s real-time behavioral tracking solution, which enhances your marketing campaigns by responding to customer actions as they happen. The integration supports event streaming via server-side events.

Key Capabilities:

  • Real-Time Campaigns: Create personalized marketing campaigns based on real-time events like customer logins or transactions.
  • Conditional Execution: Adds an approval layer between Optimove and your internal systems, ensuring that campaigns are delivered only to customers who meet your internal eligibility criteria.
  • Real-Time Attribute Updates: Update customer attributes instantly to reflect their latest activity or status (e.g., last deposit amount).
  • Web and App Activity Tracking: Enhance segmentation and targeting based on streaming events.

Integration Steps:

  1. Prerequisite Configuration:
    • Complete the Real-time Integration Form for real-time integration projects.
    • Optimove’s CSM will provide the necessary connection details (Server-side endpoint, Tenant ID, and Tenant Token).
    • Provide these details to your provider.
  2. Production Implementation:
    • Grant The Mill Adventures access to your site to configure the necessary settings for production implementation.
  3. Test and Deploy:
    • Run test campaigns to validate the new capabilities.
    • Once sufficient testing is complete, you can start targeting live users according to your marketing needs.

Supported Events — Standard (OOTB):

  • ootb_added_to_bet_slip
  • ootb_balance_update
  • ootb_customer_details_update
  • ootb_deposit
  • ootb_deposit_cancellation
  • ootb_deposit_initiated
  • ootb_deposit_limit_exceeded
  • ootb_deposit_limit_updated
  • ootb_game_close
  • ootb_game_launch
  • ootb_game_session
  • ootb_login
  • ootb_registration
  • ootb_registration_started
  • ootb_self_exclusion_initiated
  • ootb_self_exclusion_lifted
  • ootb_sports_bet_placed
  • ootb_sports_bet_settled
  • ootb_sweepstakes_game_close
  • ootb_sweepstakes_game_launch
  • ootb_sweepstakes_game_session
  • ootb_user_details_update
  • ootb_withdrawal
  • ootb_withdrawal_cancellation

Supported Events — TMA Custom:

  • tma_bonus_cost_updated
  • tma_game_round_closed
  • tma_limits
  • tma_loyalty_points_balance_changed
  • tma_user_achievement_completed
  • tma_user_bonus_activated
  • tma_user_bonus_given
  • tma_user_tag

Transactional Emails

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.

Key Capabilities:

  • Visual and HTML Editors: Build email templates using either a full HTML editor or a drag-and-drop Visual Template Editor with ready-made components.
  • Advanced Personalization: Use Optimove’s Personalization Tags to tailor messages based on customer data, and apply conditional logic with if/then/else rules.
  • Seamless Integration: Directly access your Optimove customer database to personalize content without leaving the platform.

Integration Steps:

  1. Email Setup:
    • Submit the Email request form.
    • Optimove allocates a new IP address within SendGrid and creates the necessary DNS records.
  2. Client Implementation:
    • Implement the provided DNS records in your domain hosting provider.
    • Email is added to your Optimove UI, and the DNS records are verified.
  3. Transactional API Setup:
    • Request the integration setup from The Mill Adventures’ point of contact and provide them with an API key. Guidelines on creating an API key can be found here.

Promotion System Integration

Integrating your external promotion or bonus system with Optimove allows seamless execution of marketing campaigns. Through Optimove’s API, campaigns can automatically trigger promotional offers, ensuring personalized and timely promotions.

Key Capabilities:

  • Scheduled Campaign Support: Automatically deliver promos to your target segments at scheduled times.
  • Real‑Time Campaign Support: Push promotions instantly when customers meet defined triggers via Optimove’s streaming data engine.
  • Promotion Synchronization: Add, update, delete, and fetch valid promo codes through a dedicated API, making them available in Optimove’s campaign builder.

Integration Steps:

  1. API Key Setup:
    • Request the integration setup from The Mill Adventures’ point of contact.
    • Provide The Mill Adventures with an API key (refer to API key creation guidelines).
  2. Support & Testing:
    • Consult your Optimove Customer Solutions Engineer for use case support, if needed.
    • Once The Mill Adventures confirms that the integration is complete, you can begin testing.

Email Consent Management

Optimove maintains a two-way consent sync with your platform for email marketing, keeping Optimove’s Unsubscribers list continuously aligned with each subscriber’s status.

Unsubscribe Methods:

  • Optimove Managed Link: A link included in your emails that is handled entirely by Optimove. Once clicked, the user is immediately unsubscribed in Optimove and SendGrid without requiring action from your internal systems.
  • Website Unsubscribe: If a user opts out via your own website profile or UI, The Mill Adventures (TMA) uses an API call to update that status in Optimove, and also updates this data via the batch (including timestamp).

Two-Way Sync Flow:

  • When a user opts out of email marketing on your platform, or becomes Locked (any lock type except Wrong Password), the platform adds the user to Optimove’s Unsubscribers list via the Add Unsubscribers endpoint.
  • When a user opts in to email marketing on your platform, the platform removes the user from Optimove’s Unsubscribers list via the Delete Unsubscribers endpoint.
  • When a user opts out via Optimove (for example, by clicking the Unsubscribe link in an email footer), the platform picks up the change via the Get Unsubscribers endpoint, which is polled every 30 minutes.

Prerequisites — API Key (Integration Permissions):

  • Email, Customer ID, and Email Unsubscribed permissions.
  • Optimove will provide the brandId to finalize the sync.

Prerequisites — Batch Data Attributes:

  • Email address
  • Timestamp — dd/mm/yy - hh:mm (time and date)
  • Subscription status — Opt-in = true/false

SMS Consent Management

SMS consent is managed through a hybrid of Optimove-native features, real-time API updates, and daily batch files.

Unsubscribe Options Managed by Optimove:

  • One-Way Opt-Out: Ideal for Short Codes or Toll-Free numbers that do not support replies. You include a link in your SMS template; when clicked, the customer confirms their opt-out on a hosted landing page.
  • Two-Way Opt-Out: Works for 10-DLC and supported Toll-Free numbers. Customers can reply to your SMS with a keyword such as STOP. Optimove automatically scans incoming messages and unsubscribes the user if the keyword is detected.

Unsubscribe Options Managed by The Mill Adventures:

  • Website/Profile Update: If a user opts out directly through your website UI, TMA uses an API call to ensure this change is reflected in Optimove immediately.

Batch Synchronization and Logic:

  • The daily batch file serves as the final source of truth for all consent data.
  • Consistency: TMA manages the batch synchronization to ensure your internal database and Optimove remain aligned.


Ready to unlock powerful marketing insights? Reach out to your contacts at The Mill Adventures or Optimove to get started on maximizing these features for your business.

Related articles