Creating coupons and gift cards
Creating coupons and gift cards is at the core of many promotional campaigns.
Use the Campaign Manager to generate the following types of codes:
- Random codes: Several coupon codes for single users.
- Universal codes: A single coupon code meant to be used by several customers.
- Gift cards: Codes that customers can use to pay for their orders.
- Personal codes: A coupon code meant to be used by a specific customer.
To prevent coupon fraud, you can combine profile, coupon and unique identifier budgets to limit how many coupons a single customer can redeem and how much discount they can get on a single campaign.
See our tutorial on custom identifiers in the Dev docs for further information on creating and using identifiers to prevent multiple accounts.
Before you start
Ensure that you have:
- Created a campaign.
- Enabled the coupons feature in your campaign.
- Configured your integration to support coupons.
- Checked your Application's case sensitivity settings for coupons.
Generating random codes
Random coupon codes are typically used when distributing unique coupon codes directly to customers, and they are intended for single users. For example, you can use this option to create a batch of individual codes, which can be redeemed once.
Click Coupons on the left-side menu of your campaign.
Click Create Coupons.
Click the Random Codes tab.
In Number of coupons, set the number of coupons to generate.
noteThe maximum amount of codes you can generate at a time is 5,000,000, and you can create up to 20,000 immediately. When creating more than 20,000 codes in a single request, you will receive an email notification once the coupon codes are generated. The asynchronous coupon generation takes up to 1 hour.
In Per-coupon redemption limit, set how many times the coupon can be redeemed by a single customer. You can also allow unlimited redemptions.
In Schedule (optional), select the dates between which the coupon can be redeemed.
If there are any coupon mandatory attributes enabled for the Application, use Mandatory attributes to set the value for them.
(Optional) If there are any coupon mandatory attributes enabled for the Application, you can use Custom Attributes to add one or more coupon attributes connected to this Application and set their value.
noteIf there are no mandatory attributes enabled for the Application, you can add custom attributes in the section below.
(Optional) Use the Advanced section to set the shape of the coupons:
- In Code length, choose the length of your codes, between 4 and 20 characters. The default length is 8 characters.
- In Character set, choose if you want your codes to be composed by letters only, numbers only, or both.
- Click the Segmented checkbox if you want the codes to be segmented. If you select this option, use the Segmentation character drop-down menu to choose between hyphen and underscore.
- In Prefix, set a prefix for your codes.
- In Suffix, set a suffix for your codes.
- Click the Segment prefix/suffix checkbox if you want the prefix and the suffix to be separated from the rest of the code by a hyphen or an underscore.
- In Coupon reservation limit, type how many times the coupons can be reserved
or choose one or more of the following options:
- Allow unlimited reservations: the coupon codes can be reserved as many times as required.
- Reservation mandatory: the coupon code can be redeemed only if it has been reserved first. You can reserve the code with the create coupon code reservation effect.
Click Create.
A pop-up appears, indicating that a code batch has been created. It contains the Batch ID that you can use to identify the coupon codes that you just generated.
Before you close the pop-up, you can click Create More Codes or click Export Codes to directly export the coupon codes.
Generating a universal code
Use this option to create one specific code, which can be used by all your customers.
Click Coupons on the left-side menu of your campaign.
Click Create Coupons.
Click the Universal Code tab.
In Coupon code, type the name of the coupon.
In Coupon redemption limit, set how many times the coupon can be redeemed. You can also allow unlimited redemptions.
In Per-customer redemption limit, set how many times the coupon can be redeemed by a single customer. You can also allow unlimited redemptions.
In Schedule (optional), select the dates between which the coupon can be redeemed.
If there are any coupon mandatory attributes enabled for the Application, use Mandatory attributes to set the value for them.
(Optional) If there are any coupon mandatory attributes enabled for the Application, you can use Custom Attributes to add one or more coupon attributes connected to this Application and set their value.
noteIf there are no mandatory attributes enabled for the Application, you can add custom attributes in the Advanced section that appears at the bottom of the page.
In Advanced > Coupon reservation limit, type how many times the coupon can be reserved or choose one or more of the following options:
- Allow unlimited reservations: the coupon code can be reserved as many times as required.
- Reservation mandatory: when the coupon code is used in a specific customer session, it is automatically reserved for the customer profile the session is linked to.
Click Create.
A pop-up appears, indicating that a code batch has been created. It contains the Batch ID that you can use to identify the coupon code that you just generated.
Before you close the pop-up, you can click Create More Codes or click Export Codes to directly export the coupon codes.
Generating a gift card
Use this option to create gift cards that customers can use to pay for part or all of their orders.
Click Coupons on the left-side menu of your campaign.
Click Create Coupons.
Click the Gift Card tab.
In Number of gift cards, set the number of gift cards to generate.
noteThe maximum amount of gift cards you can generate at a time is 5,000,000, and you can create up to 20,000 immediately. When creating more than 20,000 gift cards in a single request, you will receive an email notification once the gift cards are generated. The asynchronous gift card generation takes up to 1 hour.
In Gift card value, set the value of the gift card.
If there are any coupon mandatory attributes enabled for the Application, use Mandatory attributes to set the value for them.
(Optional) If there are any coupon mandatory attributes enabled for the Application, you can use Custom Attributes to add one or more coupon attributes connected to this Application and set their value.
noteIf there are no mandatory attributes enabled for the Application, you can add custom attributes in the section below.
(Optional) Use the Advanced section to set the shape of the gift cards:
- In Code length, choose the length of your codes, between 4 and 20 characters. The default length is 8 characters.
- In Character set, choose if you want the codes to be composed by letters only, numbers only, or both.
- Click the Segmented checkbox if you want the codes to be segmented. If you select this option, use the Segmentation character drop-down menu to choose between hyphen and underscore.
- In Prefix, set a prefix for the codes.
- In Suffix, set a suffix for the codes.
- Click the Segment prefix/suffix checkbox if you want the prefix and the suffix to be separated from the rest of the code by a hyphen or an underscore.
Click Create.
A pop-up appears, indicating that a code batch has been created. It contains the Batch ID that you can use to identify the gift cards that you just generated.
Before you close the pop-up, you can click Create More Codes or click Export Codes to directly export the gift cards.
Generating a personal code
These codes are intended for specific users. For example, you can use this option to create a unique code for a certain Integration ID so only a user with this ID can redeem this coupon. Later you can edit the Integration ID if this is a requirement.
Only Admin users see this feature.
Click Coupons on the left-side menu of your campaign.
Click Create Coupons.
Click the Personal Code tab.
In Recipient Integration ID, type the ID of the user you want to create the coupon for.
In Schedule (optional), select the dates between which the gift card can be redeemed.
If there are any coupon mandatory attributes enabled for the Application, use Mandatory attributes to set the value for them.
(Optional) If there are any coupon mandatory attributes enabled for the Application, you can use Custom Attributes to add one or more coupon attributes connected to this Application and set their value.
noteIf there are no mandatory attributes enabled for the Application, you can add custom attributes in the section below.
(Optional) Use the Advanced settings section to set the name of the coupon. Leave this field blank to have the code auto-generated.
Click Create.
A pop-up appears, indicating that a coupon batch has been created. It contains the Batch ID that you can use to identify the coupon code that you just generated. The customer will not be automatically notified.
Before you close the pop-up, you can click Create More Codes or click Export Codes to directly export the coupon code.
Creating a code as an effect
You can also create a coupon code or a gift card as an effect in your rules and set all its values directly.
Next steps
Once you have generated codes, you can, for example, share them with your customers via a rule or export them.