# Creating Automations

Automation campaigns in Open Loyalty allow you to automatically reward members based on scheduled triggers - daily, weekly, monthly, birthdays, or membership anniversaries.

## 🛠️ Step-by-Step Setup

Follow these steps to set up a new leaderboard in your Open Loyalty environment:

{% stepper %}
{% step %}

### Navigate to Automation Campaigns

* From the left-hand menu, go to **Automations**
* Click **Add automation campaign** (or use the ▼ to **Import** existing automation configuration)
  {% endstep %}

{% step %}

### Choose Your Trigger

Select the timing that best fits your automation campaign goal:

* **Daily** – runs every day
* **Weekly** – choose specific weekday(s)
* **Monthly** – pick exact date(s) or “Last day of month”
* **Member’s birthday** – runs on each member’s birthday
* **Membership anniversary** – runs on the join date anniversary

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FMoG7z8V50KvuvoCV9mqQ%2Fimage.png?alt=media&#x26;token=3373d6b2-09d6-4093-a024-a02ad3aaaa04" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Automation campaigns run at 00:00 (according to the configured tenant timezone)
{% endhint %}
{% endstep %}

{% step %}

### Define Target Audience

Who should participate in the automation campaign?

* **Everyone**
* A single **Segment**
* A single **Tier**

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FAIqVNuaWFATDbybHGbkm%2Fimage.png?alt=media&#x26;token=a697eaba-79d7-45b1-9ba5-2c2a5a8e216f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Basic Settings

Fill in these core details:

* **Name & Description** – Choose a distinctive name and optionally add the description. \
  If you added another language in the settings, you will be able to add translations.
* **Start & End Dates** – Start date is required; the end date is optional but must be after the start date.
* **Display Order** (optional)
* **Visibility** – Choose who sees the campaign: Everyone, specific Segments/Tiers, or Hidden.

{% hint style="warning" %}
**Campaign visibility** only determines to whom the challenge is presented. If you want to target given audience, the condition must be specified in the rules.

* **Visibility** - displaying the campaign, e.g. for a given segment or tier
* **Conditions** - being able to earn points, e.g. for a given segment or tier

Therefore, the precise targeting of the campaigns depends on the conditions specified in the rules section.
{% endhint %}

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FBaVBl88FypX3BnT1rnEE%2Fimage.png?alt=media&#x26;token=f3c1069e-9e81-4c03-9184-748aca9218f0" alt=""><figcaption></figcaption></figure>

Optionally define **custom attributes** (key:value pairs) to tag or filter the automation campaign in APIs and UI

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FwP7qHCztnxokRZxNl7t3%2Fimage.png?alt=media&#x26;token=857514c5-253f-49f9-99e0-811127f0663b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add Rules: Conditions & Effects

* Click **Add new rule**<br>

  <figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2F8sxwLgc1C3GFooyRoUCd%2Fimage.png?alt=media&#x26;token=25f3c81a-cd86-4732-94d9-1885477aa6b9" alt=""><figcaption></figcaption></figure>
* **Conditions**: e.g., membership tier, purchase history, custom attributes
* **Effects**: e.g., “Add units” (e.g., 10 points), coupons, or “Deduct units”
* Use multiple rules to cover diverse scenarios

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FP7mAyX4L9hylNtK9Bef6%2Fimage.png?alt=media&#x26;token=02bb3f57-205c-41c4-9545-3c9532984790" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Set Limits & Budget

Control how often a member can receive the automation campaign's reward:

**Automation Campaign Limit**

* **Per‑member limit**: per hour/day/week/month/year or total
* **Global budget**: total units issued, and per‑member units cap

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2F8izqwqBPIHndGRnVZn5S%2Fimage.png?alt=media&#x26;token=73afc6aa-8556-4671-a9cd-ff98d16047c4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Toggle Campaign Status&#x20;

* Use the **Active** switch to enable or pause the campaign
* Only active campaigns trigger at their scheduled times

<figure><img src="https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FXqgljmAnlS6RC0x8SlzC%2Fimage.png?alt=media&#x26;token=72aa91fa-aa1c-4da1-b34c-a43aa080dc5f" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## ✅ Best Practices

* Prefer longer-term triggers for special events (birthday, anniversary)
* Use automatic audience segments/tier filters in **Basic Settings**
* Scale gradually - fine-tune limits and budgets as you assess performance

***

## 🔍 Troubleshooting Tips

* **No effect?** \
  Check campaign status, scheduling, and rule conditions
* **Zero units issued?** \
  Review your per-member limits and global budget caps
* **Birthday/anniversary misfires?** \
  Validate member data - missing or future dates won’t trigger at 00:00
