What limits can I create with validation rules?
In this section:
- Introduction to validation rules
- How to create a rule
- Discount applicable to particular products/SKUs
- Validation rules with Metadata Schema Validation
- Validation rules with product metadata
- Time limits for vouchers
The aim of creating validation rules is to model the desired buying circumstances. Rules are built with attributes and operators divided into 5 categories:
By using customer segments you can choose a target segment of your customers or exclude particular customer segments from clients allowed for redemption. While adding validation rules based on segments, you can choose to include/exclude one of the existing segments or create a new segment from scratch.
You can also use custom attributes defined previously in Metadata Schema and create unique validation rules based on their values. For example, imagine you have a gym and your customers have different memberships. Despite that Voucherify doesn't have such attributes assigned to customers by default, you can use metadata to put in into customer profiles. By adding property membership to Metadata Schema you can target a specific group of members.
There aren't any limits on the type or amount of custom attributes. You can define your customers with properties unique for your business.
| Customer segment
(is/ is not)
| The first property enables you to limit redemptions to specific customer segments. It can be useful if you want to take into account only new customers, or regular clients or any other segments you come up with.
||Redemption is available if a customer enters a segment "regularCustomers" and redemption is not available for customers who enter the segment "new customers".|
|Customer metadata satisfy||You don't have to create a customer segment based on metadata as Voucherify can automatically target customers who meet metadata criteria||For instance, you can state that only customers with revenue above 2000$ are eligible for a discount without creating a separate customer segment beforehand|
Order structure 🛒
With the following rules, you can create product-specific promotions based on a cart structure and quantity/ price of items in the cart.
💡Please note that you have to import your product catalog to use the rules listed below. Learn more.
| Validation attribute
| Contains product
|| With this attribute, a customer gets a discount on the condition that the order contains a product
||A customer can redeem the code if the order contains at least 3 products X in the cart.|
|Does not contain product||You can add the products excluded from the promotion||A customer can get a discount only if the cart does not contain product X.|
|Contains SKU||SKU (Stock Keeping Unit) is an attribute that differentiates product variants. Used in a validation rule, it makes a coupon active only if the particular variant is in a cart (and optionally set the required amount in the cart). Choose SKU/SKUs which have to be in the cart, and then mark a checkbox "Discount is applicable to this SKU" to make a discount valid for the added items.||A customer can use a gift card only for black and silver iPhones and cannot use it to buy white variant (SKU) of the product|
|Product and order metadata satisfy|| Rules based on custom attributes assigned to your products and orders, e.g., series. You can add as many metadata attributes as you wish.
You can read more here.
| A discount is applicable only to products which series begins from AT54.
|Any order item's product metadata satisfy||These rules allow you to make order eligible for a discount if any item in your customer's cart meets metadata set for the given campaign.||Customers will get the discount if at least one product in his/her cart meets metadata.|
|Each order item's product metadata satisfy||These rules allow you to make order eligible for a discount if all items in your customer's cart meet metadata set for the given campaign.||For example, your customer has to purchase only products in a certain color for his/her order to be eligible for a discount.|
Order volume 👜
Introduce cart’s price-related constraints to up-sell and boost sales.
| Total amount
||You can define a maximum/minimum value of a customer's cart that enables them to use the code.||Discount applies only if the total amount of the order is more than $50.|
| Items quantity
|| You can select a required quantity (min/max) of products that need to be in a customer's cart.
|| Discount applies only if a customer bought at least 5 products at once.
| Price of each item
|| You can set a minimum/maximum price of each product from a customer's cart.
|| Discount applies only if a price of every item in a cart is more than $50.
| Price of any item
|| This rule defines a minimum/maximum price required for at least one product from a customer's cart.
|| If a customer's cart contains at least one product for more than $100, the code can be redeemed.
Budget constraints 💰
Control promotion budget setting up safety limits which automatically deactivate your promotion.
| Total discounted amount
|| It defines the overall value of the discount that your customers can get by redeeming codes from a particular campaign.
||The total value of applied discounts from campaign X has to be less than $10 000.|
| Total orders value
|| You can select a maximum value of all orders made within the campaign. When this limit is reached, customers cannot redeem more codes.
|| The value of all orders made within the Y campaign cannot be more than $20 000.
| Total number of redemptions
|| It's a total number of redemptions allowed per entire campaign.
|| Customers can redeem codes from X campaign 3 000 times.
| Total redeemed gift amount
|| It defines a total value of redeemed gift cards amongst the whole
|| Customers can spend $10 000 of the balance from X gift cards campaign.
| Redemptions count per customer
|| It defines
|| Customers can redeem max. 3 codes within a campaign but only once per code.
Control redemption with rules based on custom fields and access policy.
| Redemption metadata satisfy
|| Read more here.
| Redeeming user
|| With this
|| User "Denver_department" can invoke redemptions and the user "Central_department" cannot redeem codes.
|Redeeming API key Count||This attribute allows you to limit redemption to particular API keys.||For instance, you can limit redemptions to 3 per specific users with the same API key.|
| Only for customers who are holders of the card
|| With this attribute, you can improve fraud detection and reduce coupon misuses. By using this rule, you ensure that a voucher is redeemed by the same person that it was published for (sent).
(Once you send a code to your customer through one of the distribution channels, publication details are visible in Voucherify).
| When you save the campaign and share the codes, a customer will be able to utilize a coupon only if its publication is assigned to his/her id.
You can build rules and limits in the 4th stage of a campaign creation or in the 'Validation Rules' dashboard section. The flexible mechanism allows you to implement a wide range of promotion ideas.
Building a rule 🏗️
There are two ways you can create validation rules in Voucherify dashboard:
- You can go to the Validation Rules section in the dashboard, create and save a set of rules, and use them later on while creating a campaign or
- you can create validation rules from scratch while creating a campaign in the campaign manager
💡 Validation Rules section comes in handy when you need the same validation rules in your future campaigns. You can save the rules and add them to any campaign without the need to create the rules from scratch every time.
Add and save your rules - Validation Rules dashboard section
Go to the 'Validation Rules' section in the dashboard and choose the Plus to create new rules. Add a name for your new rule/set of rules
You can see 5 categories of rules to choose from:
- In the 1st category, you can choose a customer segment who can/cannot redeem the codes. To build a rule, you need to add an operator is/is not in the first input and choose the desired customer segment from the list of segments in the 2nd input.
Rules from the remaining categories are built in a similar way.
All active rules that you have confirmed are visible in the grey background below the category.
You can SAVE each rule or set of rules and use them later while creating campaigns in the Campaign manager.
Validation rules in the Campaign Manager
- Firstly you need to run the Campaign Manager and choose a campaign type you'd like to create.
- Go through the first 2 stages of a campaign creation process
In the 3rd step, you can add validation rules and define what criteria customers and their orders have to match to make a valid redemption.
How to build a rule? 🤔
1. Add a name for your validation rule/set of rules (they will be automatically saved in 'Validation Rules' dashboard section)
2. Expand the available rules from the category you're interested in and build a restriction.
3. Confirm with ADD. All active rules will be visible on the grey background below each category.
Discount applicable to particular products/SKUs ⚠️
Some validation rules are based on the structure of products in the cart. Sometimes you want to make a discount applicable only to particular items ( products or SKUs). This can be achieved with the checkbox ' Discount applicable to this order item'. When defining items required in the cart (Order items list > Contains product), you can define separately which of products/SKUs required in the cart will be discounted (or not) when a customer redeems a coupon.
When a customer invokes redemption, Voucherify validates voucher and allows for discounting only products with this rule applied (ticked checkbox).
If you are a developer, go here to learn more details about the applicable_to validation rule.
Validation rules with Metadata - Schema Validation
💡 This guide assumes you are already familiar with the Metadata - Schema Validation. If you need help with that, follow this link.
Voucherify Metadata - Schema Validation enables you to create
- 'image URL'
- and 'date-time' metadata attributes.
These custom properties can relate to all Voucherify object types:
You can use them to add specific campaign limits or customer segment rules. Different types of attributes allow you for creating rules based on specific numbers, dates and time frames. Let's explore some examples.
Redemption metadata with date and time ⏰
Metadata attributes assigned to redemption objects can be used to create validation rules during the 4th stage of a campaign manager.
Firstly, you need to add metadata properties to the project's Metadata Schema.
In the picture, you can see one metadata attribute assigned to redemption objects:
- booking_time type 'date-time'
Validation rules with products/SKUs metadata
Each custom attribute that you add to product objects using API or Metadata Schema, can be used to create validation rules.
You don't have to import your inventory to use product-specific rules in your campaigns. That means there is no need of storing products catalog in Voucherify upfront and up-to-date. If you use API to invoke codes' redemptions, then you can add products with metadata while invoking redemption (to the redemption request). You can read more in this guide.
To use Metadata - Schema Validation created for products or SKUs, you need to choose the validation rule from 'Order structure' > 'Product metadata satisfy'. Similarly to the previous case, assigned properties will be listed automatically after choosing the rule.
You can use assigned properties to build product-specific rules
When you choose a required value for a property, confirm with 'Add'. The campaign redemptions will be restricted by added limits and redemption request needs to be equipped with product metadata attributes with assigned values. Otherwise, the system will reject the redemption request.