# Introduction

## About the White Label Loyalty Engine

The Loyalty Engine is a flexible, API-first platform that powers the logic behind your loyalty program. It’s designed to integrate into your existing systems—such as websites, mobile apps, or in-store POS—and gives you full control over how your loyalty program works.

#### <i class="fa-circle-check">:circle-check:</i> You can use the Loyalty Engine to:

* Track user actions using events
* Award points, vouchers, or other incentives based on those actions
* Define your own earn and burn logic using rules (reactors)
* Segment users into audiences for targeting
* Manage user profiles, points, tiers, and reward eligibility
* Create a loyalty program tailored to your brand, goals, and customer behaviours

#### <i class="fa-circle-x">:circle-x:</i> What the Loyalty Engine is not:

The **Loyalty Engine** focuses on the **backend logic of your loyalty program**. It is not:

* A CRM or email marketing platform (but you can integrate one)
* A user interface (you’ll need to build your own, or use our white-label microsite or mobile app)
* A user account system (authentication and account creation must be handled by your platform or our white-label tools)
* A standalone solution—it’s intended to be embedded into your wider ecosystem

If you need a frontend, user account management, or communication tools, we offer optional white-label interfaces—or you can integrate your own systems using our API.

{% hint style="info" %}

#### The Loyalty Engine section of the knowledge base is primarily targeted at clients who are integrating our API into their own systems.

For clients utilising WLL's pre-built customer interfaces, user authentication or end-to-end solution products, you may find some of the content useful but you should consult your account manager for more information on how the Loyalty Engine has been implemented in your solution.
{% endhint %}

### Key concepts of the Loyalty Engine

<table data-column-title-hidden data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Loyalty Engine</strong></td><td>The Loyalty Engine is an advanced cloud-based platform which allows you to run engaging and dynamic loyalty programs.</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2F6NPAMSW8q1xpZ6qMcLuy%2FFrame.png?alt=media&#x26;token=b4df8ffb-8a02-4bd9-a9b3-f2d7b9e01aae">Frame.png</a></td><td><a href="introduction">introduction</a></td></tr><tr><td><strong>Events</strong></td><td>The platform works by ingesting <strong>events</strong> — such as purchases, referrals, or sign-ups — reported via API. These events are the foundation for triggering loyalty logic.</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FrYZfKaGocfESSJGEM4CH%2Fschool_24dp_5F6368_FILL0_wght400_GRAD0_opsz24%203.png?alt=media&#x26;token=1ba492a5-422c-4d8f-a8e5-71a24be0176a">school_24dp_5F6368_FILL0_wght400_GRAD0_opsz24 3.png</a></td><td><a href="events">events</a></td></tr><tr><td><strong>Reactors</strong></td><td><strong>Reactors</strong> are rules that define how the system responds to events. Each reactor includes an event trigger, optional conditions and one or more reactions (i.e. award points, give voucher)</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FvYtwbWfNOXVwEVG6LuNt%2Fview_sidebar_24dp_5F6368_FILL0_wght400_GRAD0_opsz24%203.png?alt=media&#x26;token=89b6b122-b6d0-4e23-ad03-83ed60b0f27a">view_sidebar_24dp_5F6368_FILL0_wght400_GRAD0_opsz24 3.png</a></td><td><a href="reactors">reactors</a></td></tr><tr><td><strong>Users</strong></td><td>Each user has a wallet storing their points balance, tier status, available rewards (benefits), and activity history.</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2Fj2xKgG8cAjN3oG7t2BTd%2Fview_sidebar_24dp_5F6368_FILL0_wght400_GRAD0_opsz24%203.png?alt=media&#x26;token=882c615d-ca0c-464f-8172-be602e128cdc">view_sidebar_24dp_5F6368_FILL0_wght400_GRAD0_opsz24 3.png</a></td><td><a href="users/user-wallet">user-wallet</a></td></tr><tr><td><strong>Audiences</strong></td><td>Dynamic user segments used in conditions and targeting. <strong>Audiences</strong> can be based on profile attributes, event history, points balance, tier, or purchase behaviour.</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FfimD38DqCatIVUEdORpK%2Farchitecture_24dp_5F6368_FILL0_wght400_GRAD0_opsz24%203.png?alt=media&#x26;token=9f638a43-2e3c-4769-a620-8fe009d387df">architecture_24dp_5F6368_FILL0_wght400_GRAD0_opsz24 3.png</a></td><td><a href="audiences">audiences</a></td></tr><tr><td><strong>Rewards</strong></td><td>Includes vouchers, offers, and digital gift cards. Rewards can be browsed, targeted, and fulfilled using the API or Loyalty Console.</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2Fqfhiy79JKev1p2gt0dQj%2Farchitecture_24dp_5F6368_FILL0_wght400_GRAD0_opsz24%203.png?alt=media&#x26;token=176f7600-dadf-412a-a346-07d9aeb41791">architecture_24dp_5F6368_FILL0_wght400_GRAD0_opsz24 3.png</a></td><td><a href="rewards-and-points">rewards-and-points</a></td></tr><tr><td><strong>Points</strong></td><td>Configurable rules that govern point expiry, earn caps, spend caps, and balance caps.</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FIt6tc6CQhKrc7m9NGzgM%2Fcontact_support_24dp_5F6368_FILL0_wght400_GRAD0_opsz24%203.png?alt=media&#x26;token=2b38bf16-6c9b-4be7-9d7c-7a7d20ba8992">contact_support_24dp_5F6368_FILL0_wght400_GRAD0_opsz24 3.png</a></td><td><a href="rewards-and-points/points">points</a></td></tr><tr><td><strong>Loyalty Console</strong></td><td>Admin interface for non-developers to configure rules, create rewards, manage users, monitor activity, and test logic without needing to touch the API.</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FxtNwPAlddSXLeTVH61zB%2Fview_sidebar_24dp_5F6368_FILL0_wght400_GRAD0_opsz24%203.png?alt=media&#x26;token=4967e2f3-58dc-4702-b0a0-657721be0bb1">view_sidebar_24dp_5F6368_FILL0_wght400_GRAD0_opsz24 3.png</a></td><td><a href="loyalty-console">loyalty-console</a></td></tr><tr><td><strong>API-first Platform</strong></td><td>All core functionality is available via API — suitable for embedding loyalty features into existing apps, websites, and systems.</td><td><a href="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FORt6IsXFWHm4es4v0ru7%2Fview_sidebar_24dp_5F6368_FILL0_wght400_GRAD0_opsz24%203.png?alt=media&#x26;token=9168ee12-1878-4dbe-9972-1770a0f6ce2b">view_sidebar_24dp_5F6368_FILL0_wght400_GRAD0_opsz24 3.png</a></td><td><a href="https://docs.whitelabel-loyalty.com">https://docs.whitelabel-loyalty.com</a></td></tr></tbody></table>

***

## Loyalty logic

In the Loyalty Engine individual **event types, reactors, rewards, and audiences** are the building blocks of your loyalty program—each serving a specific purpose. We call these building blocks **loyalty logic.**

* [**Event types**](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/events/event-types) define the specific behaviours or interactions you want to track in your loyalty program. Each time one occurs, it’s reported to the Loyalty Engine as an [**event**](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/events/reporting-events).
* [**Reactors**](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/reactors) define the rules and actions triggered by user activity or events (e.g., awarding points for purchases).
* [**Rewards**](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/rewards-and-points) offer users tangible benefits or communicate promotions (e.g., a voucher for £10 off after spending 1,000 points).
* [**Audiences**](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/audiences) allow you to target specific user groups based on their profiles or activity (e.g., exclusive offers for VIP members).

### Building loyalty logic

The [**Loyalty Console**](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/loyalty-console) provides an intuitive interface to create, manage, and configure loyalty logic. By combining them strategically, you can build engaging **loyalty campaigns**, promotions, and program rules.

By combining these building blocks, you can design a loyalty experience tailored to your program’s objectives and user preferences. For instance, you could:

* Create a reactor that awards points when a user makes a purchase.
* Offer a reward that users can purchase with their points.
* Target a specific audience, such as high-spending users, to receive bonus points or exclusive perks.

See [loyalty-campaigns](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/loyalty-campaigns "mention") for inspiration on the various use cases loyalty logic can support.&#x20;