Create Promo Campaigns
Learn how to create and configure a Promo Campaign from scratch using the step-by-step campaign builder.
Overview
This document provides detailed instructions on creating and configuring a Promo Campaign using the Campaign Builder. It guides you through the key steps to set up your campaign, including defining your campaign goals, selecting the right target audience, choosing the campaign type, and customizing your settings.
Create Promo Campaign
Go to Promotions > Promo Campaigns and click Create Campaign. The New Promotion Campaign page opens. To create a Promo Campaign, perform the following five key steps:
- Define Qualification Criteria
- Select Target Segment
- Set Up Reward
- Set Up Delivery Preference
- Publish Campaign
Define Qualification Criteria
The Start Here section is where you choose how users will qualify for the reward. The qualification criteria provide the following options:
- Past behavior/Custom list: Target users based on actions performed in the past or custom list uploaded to the CleverTap dashboard. For example, you can target users who received a specific reward but have not redeemed it yet.
- Live behavior: Trigger rewards in real-time when a user performs or does not perform an event. For example, you can trigger a reward when a user adds items to their cart but does not complete the checkout process within a set timeframe.

Define Qualification Criteria
Select Target Segment
The Who section allows you to define who should receive the reward using the rule builder. The Target Segment rule builder Includes the following:
- Find users from segment: allows you to select users from an already existing segment.
- Create rules based on events:
- Users who have done specific events
- Users who have not done certain events
- Users who have common user properties such as device type, location, are part of a particular segment, and so on.
- Users who have common interests or behavior on your platform.
- Option to check Constant event property if needed to simplify the logic.

Select Target Segment
Set Up Reward
The What section allows you to define the reward type for your Promo Campaign. Choose from various reward options such as:

Set Up a Reward to Create Message
This section ensures you set up the right reward mechanism to engage your users effectively.
Promo Campaign with Wallet Points Selected
When you select Wallet Points as the type of reward when creating a Promo Campaign, you see the following options:
Option | Description | Example/Use Case |
---|---|---|
Loyalty Wallet | Note: The wallet must be created beforehand in your CleverTap account. | If you have multiple wallets (for example, a Cashback Wallet and a Loyalty Points Wallet), you can select the Cashback Wallet to credit points for users engaging in a specific promotion. |
Points Earning Scheme | Choose how users earn points when they trigger a qualifying event (typically a
| amount , user gets 10 points |
Maximum Recurrence per User | Control how many times a single user can receive the points reward. These limits can be used together. Click Add Limit to define or modify these constraints. Note: This option appears only for Live Behavior Segments. | If you set a total limit of 5 and a per-day limit of 2, the user can only redeem twice a day until they reach 5 redemptions. |
Budget | Define the maximum budget allocated for the wallet points distribution. Once the budget is exhausted, no further points will be issued, even if users qualify for the reward. This ensures promotional spending is capped and provides financial safeguards during high-volume campaigns. Note: This option appears only for Live Behavior Segments. | If you set a $5,000 budget for a cashback campaign, points will stop being issued once the total cashback distributed reaches $5,000, even if users continue to qualify. |
Reward Between | Select whether the points are a fixed value (in the case of Flat points type) or fall within a defined range (in the case of Random points type). | |
Distribution Bias | This option is available only when you select Random points type. This options allows you to control how the points are distributed across the defined range: | |
Custom Points Validity | Select this option to customize the lifecycle of the wallet points, including their activation and expiry.
|
|

Set Up Wallet Points Reward in the Message
Promo Campaign with Coupons Selected
When you select Coupons as the reward type when creating a Promo Campaign, you see the following options:
Option | Description | Example / Use Case |
---|---|---|
Select Coupon Type | Choose between the two available coupon types: | |
Choose Coupon | A dropdown shows available coupons that match the selected coupon type. You must select one coupon to proceed. Note: The coupon must be active and not fully redeemed to appear in the list. | |
Max Coupons per User | Available in Live Promo Campaigns only. Defines the maximum number of times a single coupon can be used by one user. | If set to 1, each user can only redeem the coupon once. A coupon that can only be used once per user for a promotion. |
Max Codes per User (Live Campaign - Bulk Codes) | Available in Live Promo Campaigns only. Defines the maximum number of unique coupon codes that can be assigned to each user. | If set to 1, each user receives only one unique coupon code. A campaign where each user gets a unique 10% off coupon, but only one code per user. |
Coupon Redemption Activation | Define when users can redeem the coupon after it is awarded. Two options are available: |

Set Up Coupon Reward in Message
Promo Campaign with Partner Vouchers Selected
When you select Partner Vouchers as the reward type when creating a Promo Campaign, you see the following options:
-
Choose provider: Select the Provider from the dropdown. This identifies the partner brand or service from which the vouchers originate. The dropdown shows all integrated and active voucher providers available in your account.
-
Choose code snippet: After selecting a provider, choose the associated code snippet. This snippet contains a batch of voucher codes ready for distribution. The list is filtered based on the selected provider.

Set Up Partner Vouchers Reward in Message
Note
- Only active and unexpired voucher lists will be displayed.
- No preview of the voucher or its properties is shown in this version.
- When a user qualifies for the campaign, a code is picked from the selected voucher list and assigned to them.
- The system ensures that each user receives a unique and unassigned voucher code.
Set Delivery Preferences
The When section defines when the campaign should start and whether it should be scheduled or sent immediately. It allows the following options:
- Send Now: Uses the current timestamp and account timezone. For example,
(GMT+05:30) Asia/Kolkata
. - Schedule for later: Opens a date/time picker to select a future start time.

Set Delivery Preferences
Publish Campaign
Once you define all the above sections, click Publish Campaign to activate or schedule the campaign.

Publish Campaign
Updated 1 day ago