This glossary defines the key terms and concepts used throughout the OptiPromo integration documentation. Understanding these terms is essential for a successful implementation.

Promotion

A structured marketing offer defined in OptiPromo. It includes tiers, rewards, constraints, and metadata. Promotions are the central entity tied to campaigns and are executed via API or webhook triggers.

Promocode

A code, which can be unique or shared, used to trigger a promotion. Promocodes link a promotion to customer activity and reward delivery. They can be:

• Reusable: Shared across multiple users (e.g., WELCOME2025).
• Unique: Issued to a single customer.

Reward

The benefit given to a customer, such as free spins or cashback. Rewards are assigned based on the logic defined in tiers and are subject to budget constraints. Reward settings may have their own usage limits and logic for delivery and tracking. Examples include:

• 20 Free Spins
• €10 Bonus
• 10% Cashback

Tiers

Conditional reward definitions within a single promotion. Tiers determine which reward a customer receives based on their behavior or attributes. Tiers are evaluated automatically when a promotion is activated.

• Example Tier Structure:
  • Tier 1: Deposit ≥$50 → 10 Spins
  • Tier 2: Deposit ≥$100 → 20 Spins

Budgets & Capping

Defines the limits on how many rewards can be issued for a promotion.

Budgets

• Set at the promotion level.
• Specify the total reward spend or a cap on the number of items (e.g., "Max 10,000 spins overall").

Capping

• Optional, time-based restrictions that prevent over-distribution of rewards. This can be a daily, weekly, monthly, or lifetime cap. For example, a daily cap only allows a certain number of users to redeem the reward per day.

Constraints

Rules that are tied to reward usage. Unlike budgets, which are promotion-wide, constraints have the following characteristics:

• They are defined at the reward configuration level.
• They apply across all promotions that use the same reward.
• They can include limits like the total number of uses.
  Constraints are used to protect reward systems from abuse and overuse.

Additional Properties

Also known as Promotion Properties, these are custom metadata key-value pairs that you can attach to promotions. They are often used for filtering, targeting, integration logic, or visibility rules.

• Example:

{
  "eligibleGames": ["gameA", "gameB"],
  "region": "EU-West",
  "abTestGroup": "variantA"
}

 

• Defined in Two Stages:
  • 1. Tenant-Level (Schema Definition): You must first define the allowed promotion properties and their data types at the tenant level. This ensures consistency, validation, and governance.
  • 2. Promotion-Level (Value Assignment): Once the schema is defined, you can assign specific values to the properties for each individual promotion.

Attributes

There are two types of attributes that Optimove evaluates to determine promotion eligibility, depending on the campaign type.

Customer Attributes

These are static or historical fields related to a customer, such as their VIP level, last deposit amount, location, or lifecycle stage. They are used in scheduled campaigns and for tier evaluation.

Session Properties

These are dynamic, real-time fields based on a customer's recent activity or event data. Examples include the current game being played, the deposit amount in the current session, device type, or referrer source. They are passed during triggered campaigns.