Using effects
Using discount effects
Discounting session total
It allows you to apply a discount to the total value of a customer session. For example, use it to offer a discount when customers reach a certain minimum amount or redeem a coupon.
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Discount, click Discount session total.
- In Discount name, type a suitable name for your effect.
- In Discount value, enter the value of the discount. It can be a number or a formula including attributes from the Attribute Selector such as the total value of the session.
- (Optional) In Advanced Settings > Allow lower discount value if budget is insufficient, select:
- Click Done.
This effect returns the setDiscount API effect.
Discounting individual items
It allows you to apply a discount to certain items in the cart or to any additional costs applied to them. For example, use it to run a promotion on some specific item categories or have part of your catalog on sale.
Before you start, you can create a cart item filter or a bundle definition to set which items you want to apply the discount to. Otherwise, the only list available includes all the items in the customer's cart.
This effect is often used in conjunction with cart item flattening.
You can then discount individual items in your rule:
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Discount, click Discount individual items.
- In List of items, select a list of cart items. The list can be a bundle definition.
- In Discount name, type a suitable name for your effect.
- In Discount value, enter the value of the discount. It can be a number or a formula including attributes from the Attribute Selector such as the value of the item.
- (Optional) In Discount scope, select where you want the discount effect to be applied:
- Price (default): The price of the item without taking into account additional costs.
- Additional costs: The total value of any additional costs applied to the item.
- Item total: The price of the item together with any additional costs.
- (Optional) In Advanced Settings > Allow lower discount value if budget is insufficient, select:
- Click Done.
This effect returns the setDiscountPerItem API effect.
Discounting individual items pro rata
It allows you to apply a pro rata discount to certain items in the cart. The value of the discount is divided among the eligible items in direct proportion to the price of each of them.
Prorated discounts are rounded to the nearest hundredth. If the sum of all rounded individual discounts does not equal the total discount, the difference is subtracted or added to the values of the largest individual discounts. For example, a €20 discount spread evenly across 6 items will have a deficit discount value of €0.02. The deficit value will be added to 2 items.
Try creating a pro rata discount campaign for better understanding.
Before you start, you can create a cart item filter to set which items you want to apply the discount to. Otherwise, the only list available includes all the items in the customer's cart.
This effect is often used in conjunction with cart item flattening.
You can then discount individual items in your rule:
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Discount, click Discount individual items pro rata.
- In List of items, select a list of cart items.
- In Discount name, type a suitable name for your effect.
- In Discount value, enter the value of the discount. It can be a number or a formula including attributes from the Attribute Selector such as the value of the item.
- (Optional) In Advanced Settings > Allow lower discount value if budget is insufficient, select:
- Click Done.
This effect returns the setDiscountPerItem API effect.
Discounting bundles pro rata
It allows you to apply a pro rata discount to the items in one or more item bundles. The discount value is applied to each of the bundles formed from the same bundle definition and is divided among the items in those bundles in direct proportion to their individual prices.
Prorated discounts are rounded to the nearest hundredth. If the sum of all rounded individual discounts does not equal the total discount, the difference is subtracted or added to the values of the largest individual discounts. For example, a €20 discount spread evenly across 6 items will have a deficit discount value of €0.02. The deficit value will be added to 2 items.
Try creating a pro rata discount campaign for better understanding.
Before using this effect, create a bundle definition to set which items you want to apply the discount to.
You can then create the rule to discount the items in the bundles created from that bundle definition:
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Discount, click Discount bundles pro rata.
- In Bundle definition, select a bundle definition that you have created.
- In Discount name, type a suitable name for your effect.
- In Discount value for each bundle, enter the value of the discount. It can be a number or a formula including attributes from the Attribute Selector such as the value of the item.
- (Optional) In Advanced Settings > Allow lower discount value if budget is insufficient, select:
- Click Done.
This effect returns the setDiscountPerItem API effect.
Discounting additional costs
It allows you to discount additional costs applied to the entire customer session. Additional costs are extra costs such as shipping costs or other additional fees that you want to charge to customers.
Before you start, create one or more additional costs per cart (session).
You can then discount an additional cost in your rule:
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Discount, click Discount additional cost.
- In Select additional cost, choose the cost you want to discount.
- In Discount name, type a suitable name for your effect.
- In Discount value, enter the value of the discount. It can be a number or a formula including attributes from the Attribute Selector such as the value of the additional cost.
- (Optional) In Advanced Settings > Allow lower discount value if budget is insufficient, select:
- Click Done.
This effect returns the setDiscountPerAdditionalCost API effect.
Discounting additional costs per item
It allows you to discount additional costs applied to individual cart items. Additional costs are extra costs such as shipping costs or other additional fees that you want to charge to customers.
Before you start, create one or more additional costs per item.
You can also create a cart item filter to define which items you want to apply the discount to. Otherwise, the only list available includes all the items in the cart.
This effect is often used in conjunction with cart item flattening.
You can then discount an additional cost in your rule:
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Discount, click Discount additional cost per item.
- In Select additional cost, choose the cost you want to discount.
- In Pick a list of items, select a list.
- In Discount name, type a suitable name for your effect.
- In Discount value, enter the value of the discount. It can be a number or a formula including attributes from the Attribute Selector such as the value of the additional cost.
- (Optional) In Advanced Settings > Allow lower discount value if budget is insufficient, select:
- Click Done.
This effect returns the setDiscountPerAdditionalCostPerItem API effect.
Using reward effects
Adding a free item
It allows you to add a free item to the customer's session. For example, if customers purchase a certain number of items, such as in Buy two Get One Free promotions.
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Reward, click Add a free item.
- In SKU, enter the SKU of the item you want your customer to receive.
- In Discount name, type a suitable name for your effect.
- In Quantity, enter the number of free items. You can use the + symbol to the right to create a formula including attributes from the Attribute Selector.
- Click Done.
This effect returns the addFreeItem API effect.
Adding loyalty points
It allows you to reward your customers with points that they can later exchange for different items or use in future purchases. Points are added for the session total.
Before you start, ensure you have:
- Enabled the loyalty feature in your campaign.
- Created a profile-based loyalty program.
You can then add loyalty points in your rule:
Open the Rule Builder for your campaign.
Click Add Rules.
In Effects, click Add Effect.
In Reward, click Add Loyalty points.
In Select loyalty program, choose the loyalty program.
noteIf you select a loyalty program where you enabled subledgers, type in Subledger the name of the subledger where you want to add the points.
To add points to a subledger defined in a different campaign or Application, use its name. In case you use a different name that hasn't been used before, a new subledger is automatically created.
In Recipient, select where the points are added:
- For profile-based loyalty programs, your current customer is the default recipient.
If the Referrals feature is active
in your campaign, you can choose:
- Current Customer (Friend)
- Advocate
- For card-based loyalty programs, the default recipient is Loyalty card.
- For profile-based loyalty programs, your current customer is the default recipient.
If the Referrals feature is active
in your campaign, you can choose:
In Reason, type a description for this effect.
In Amount of points, set the value of the reward.
(Optional) In Allow lower amount of points if budget is insufficient, select:
(Optional) Click Reward Settings to set start and expiration dates for the reward.
Click Done.
This effect returns the addLoyaltyPoints API effect.
Adding loyalty points per cart item
It allows you to reward your customers with points that they can later exchange for different items or use in future purchases. Points are added for individual cart items.
Before you start, ensure you have:
- Enabled the loyalty feature in your campaign.
- Created a profile-based loyalty program.
You can create a cart item filter to define which items you want to give loyalty points for. Otherwise, the only list available includes all the items in the cart.
This effect is often used in conjunction with cart item flattening.
You can then add loyalty points in your rule:
Open the Rule Builder for your campaign.
Click Add Rules.
In Effects, click Add Effect.
In Reward, click Add loyalty points per item.
In Cart items filter, select a list of cart items. The list can be a bundle definition.
In Select loyalty program, choose the loyalty program.
noteIf you select a loyalty program where you enabled subledgers, type in Subledger the name of the subledger where you want to add the points.
To add points to a subledger defined in a different campaign or Application, use its name. In case you use a different name that hasn't been used before, a new subledger is automatically created.
In Recipient, select where the points are added:
- For profile-based loyalty programs, your current customer is the default recipient.
If the Referrals feature is active
in your campaign, you can choose:
- Current Customer (Friend)
- Advocate
- For card-based loyalty programs, the default recipient is Loyalty card.
- For profile-based loyalty programs, your current customer is the default recipient.
If the Referrals feature is active
in your campaign, you can choose:
In Reason, type a description for this effect.
In Amount of points, set the value of the reward.
(Optional) In Allow lower amount of points if budget is insufficient, select:
(Optional) Click Reward Settings to set start and expiration dates for the reward.
Click Done.
The awarded loyalty points are revoked if the item that triggered the effect is returned.
This effect returns the addLoyaltyPoints API effect.
Redeeming loyalty points
It allows your customers to use their loyalty points in different ways, such as direct discounts.
Before you start, ensure you have:
- Enabled the loyalty feature in your campaign.
- Created a profile-based loyalty program.
You can then deduct loyalty points in your rule:
Open the Rule Builder for your campaign.
Click Add Rules.
In Effects, click Add Effect.
In Reward, click Redeem Loyalty points.
In Select loyalty program, choose the loyalty program from which you want to redeem points.
noteIf you select a loyalty program where you enabled subledgers, type in Subledger the name of the subledger where you want to add the points.
You can redeem points from any subledger, even if it was defined in a different campaign or Application. Just type the same name you assigned to the subledger when creating it.
In Reason, type a description for this effect.
In Amount of points, set the number of points to redeem.
Click Done.
This effect returns the deductLoyaltyPoints API effect.
Awarding a giveaway
It allows you to offer direct rewards to your customers. For example, you can grant them vouchers generated outside of Talon.One, such as Amazon gift cards.
Before you start, ensure you have:
- Created a giveaway pool and connected it to the Application containing your campaign.
- Imported codes into the pool.
- Enabled the giveaway feature in your campaign.
You can then award a giveaway in your rule:
Open the Rule Builder for your campaign.
Click Add Rules.
In Effects, click Add Effect.
In Reward, click Award giveaway.
In Giveaway pool, select the giveaway pool.
In Recipient, select who will receive the giveaway. Your current customer is the default option. If the Referrals feature is active in your campaign, you can choose:
- Current customer (friend)
- Advocate
noteTo give a reward to both of them, create a second Award giveaway effect.
Click Done.
This effect returns the awardGiveaway API effect.
Using creation effects
Creating a notification
It allows you to trigger a message that can be displayed to the customer if you want. For example, use this effect to inform a customer about a special discount when they are close to reaching the minimum necessary amount to obtain it or to debug a rule during the testing phase.
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Create, click Create Notification.
- In Type, select the kind of notification you want to display.
- In Title, type a name for the notification.
- In Message, type what your customer will read. You can include attributes from the Attribute Selector such as coupons in the message.
- Click Done.
This effect returns the showNotification API effect.
Creating a referral code
It allows you to grant your customers referral codes that they can give to their friends so that they too become customers.
The code is stored in the session and you can use it in another effect, such as Create notification, by selecting the Generated Referral in Session attribute in the Attribute Selector.
Before you start, ensure you have enabled the referrals feature in your campaign. You can then create a referral code in your rule:
Open the Rule Builder for your campaign.
Click Add Rules.
In Effects, click Add Effect.
In Create, click Create referral code.
Choose where you want to create a referral code:
- In the current Campaign.
- In a specific Campaign. If you choose this option, select the campaign in the drop-down menu.
In Redemption limit, set how many times the code can be used. Set it as
0
for unlimited redemptions.In Code pattern, define the characteristics of the coupon code:
- Use campaign settings code pattern.
- Use custom code pattern allows you to define a specific code length, the characters appearing in the code, a prefix and a suffix.
(Optional) In Set start time and end time, define start and expiration dates for your coupons.
noteTo specify a relative time, click Select a relative date. For days after the session,
- start of the day represents
00:00:00 hours
in the Application time zone. - end of the day represents
23:59:59 hours
in the Application time zone.
- start of the day represents
(Optional) In Referral attributes, define the value for any available referral attributes.
Click Done.
This effect returns the referralCreated API effect.
Creating a coupon code
It allows you to generate a coupon code or a gift card. The code can be generated for the campaign of your choice in the current Application, as long as they have the coupons feature enabled.
The code is stored in the session and you can use it in another effect, such as Create notification, by selecting the Generated Coupon in Session attribute in the Attribute Selector.
Before you start, ensure you have enabled the coupons feature in your campaign. You can then create a coupon code in your rule:
Open the Rule Builder for your campaign.
Click Add Rules.
In Effects, click Add Effect.
In Create, click Create coupon code.
Choose where you want to create a coupon code:
- In the current Campaign.
- In a specific Campaign. If you choose this option, select the campaign in the drop-down menu.
Set the details of your coupon code:
- Recipient: The customer that should receive the code.
- Redemption limit: How many times the code can be used. Set it as
0
for unlimited redemptions. - Discount limit: The maximum total discount given by the coupon.
- Code pattern: The specific code length, the characters appearing in the code and any prefix and suffix.
- Set start time and end time: Start and expiration dates.
noteTo specify a relative time, click Select a relative date. For days after the session,
- start of the day represents
00:00:00 hours
in the Application time zone. - end of the day represents
23:59:59 hours
in the Application time zone.
- Coupon attributes: The value for any available coupon attributes.
Click Done.
This effect returns the couponCreated API effect.
Reserving a coupon code
The Create coupon code reservation allows you to reserve the coupon codes of the current session for the customer profile of the session.
Talon.One provides soft and hard reservations. The type of reservation depends on the coupon code's properties. If the coupon code was created using the Reservation mandatory option, Talon.One creates a hard reservation: only users with this coupon code reserved can redeem it.
You do not have to use the Coupon code is valid condition to use the Create coupon code reservation effect.
Contrary to most effects, this effect is applied when the session state is either
open
orclosed
.
Before you start:
- Ensure you have enabled the coupons feature in your campaign.
- Create at least one coupon code.
To create a coupon reservation in your rule:
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Create, click Create coupon code reservation.
This effect returns the reserveCoupon API effect.
Using update effects
Updating an attribute value
It allows you to set a new value for a custom attribute.
Before you start, ensure you have defined one or more custom attributes. You can then update them in your rule:
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Update, click Update attribute value.
- In Set attribute, select a custom attribute from the Attribute Selector.
- In To new value, type a value or select an attribute from the Attribute Selector to define yours.
- Click Done.
This effect returns the updateAttribute API effect.
Updating a cart item attribute value
It allows you to set a new value for a custom attribute affecting only certain items in the customer's cart. Use the Integration API to set a cart item custom attribute.
Before you start, ensure you have:
- Defined one or more custom attributes.
- Created a cart item filter to define the items whose attribute value you want to update. Otherwise, the only list available includes all the items in the customer's cart.
You can then update them in your rule:
- Open the Rule Builder for your campaign.
- Click Add Rules.
- In Effects, click Add Effect.
- In Update, click Update cart item attribute value.
- In Pick a list of items, select a list.
- In Set attribute, select a custom attribute from the Attribute Selector.
- In To new value, type a value or select an attribute from the Attribute Selector to define yours.
- Click Done.
This effect returns the updateAttribute API effect.
Creating webhooks
Use webhooks to share information from Talon.One with external tools relying on their APIs. For example, create a webhook that triggers an email to a customer when their friend redeems a Referral Code. You can also define your own webhooks, and they will appear as an effect.
Learn more about webhooks in the Developer docs and learn how to use them in this tutorial.
This effect returns the triggerWebhook API effect.