The Promotion Engine: Effective, Flexible, Safe

travel

Location-based discount

If a customer in Berlin books a flight in winter (Oct-Feb) to a country in the Equatorial category, and the flight costs at least 200€, then apply a 20% discount to their shopping cart.

Test in sandbox mode

curl -X PUT -H 'Content-Type: application/json' \
   -H 'Authorization: ApiKey-v1953f4d85715c479a30b9ac0592495b57 6ee90dfc7671a53a7ed440225cb48676' \
    -d '{
    "total": 210,
    "state": "open",
    "attributes": {
        "Destination_type": "Equatorial",         "CurrentLocation": {
             "format": "point",
             "object": "13.427540899999999,52.4979898"
        }
    }
}'
'https://developerdocs.talon.one/v1/customer_sessions/wpxc1n9jlo'

Effects
‍
[
[
3,
10,
0,
[
"setDiscount",
"20% off",
42
]
]
]

mobility

Loyalty program

If a customer is registered in a loyalty program and drives a car 5 times for more than 5 minutes, then add 500 points to their Loyalty Wallet.

Test in sandbox mode

curl -X PUT -H 'Content-Type: application/json' \
-H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
-d '{
"attributes": {
"Ride_duration": 10,
"Ride_count": 6
},
"profileId": "loyaltyUser",
"state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/1qvlylonptt'

Effects

[
[
5,
19,
0,
[
"addLoyaltyPoints",
"500 points",
1,
"",
500,
"loyaltyUser",
"unlimited"
]
]
]

gambling

Referral bonus

If a customer refers a friend with a referral code, then the friend gets 50 game credits, and the advocate gains VIP access to the platform.

Test in sandbox mode

curl -X PUT -H 'Content-Type: application/json' \
-H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
-d '{
"referral": "EEUF-JQ45",
"profileId": "friend",
"state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/p1u96uz3my'

Effects[
[
4,
12,
0,
[
"acceptReferral",
"EEUF-JQ45"
]
],
[
4,
12,
0,
[
"set",
"Profile",
"Attributes",
"Credits",
1200
]
],
[
4,
12,
0,
[
"set",
"AdvocateProfile",
"Attributes",
"Tier",
"VIP"
]
]
]

ecommerce

Coupon discount

This campaign returns a discount relative to a value when the coupon (the customer enters) is valid. Meaning, the usage limit of the code hasn't been reached, the code hasn't expired and the code isn't tied to another customer.

Test in sandbox mode

curl -X PUT -H 'Content-Type: application/json' \
-H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
-d '{
"coupon": "Coupon_10",
"state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/TEST-SESSION-ID-Coupon'

Effects

[
[
1,
2,
0,
[
"acceptCoupon",
"Coupon_10"
]
],
[
1,
2,
0,
[
"setDiscount",
"Dynamic coupon value discount",
10
]
]
]

ecommerce

Free gift

If a customer has more than 3 items from the category cosmetics in the cart and a total cart value of more than €50, then add a gift.

Check our developer docs

curl -X PUT -H 'Content-Type: application/json' \
-H 'Authorization: ApiKey-v1 953f4d85715c479a30b9ac0592495b576ee90dfc7671a53a7ed440225cb48676' \
-d '{
"cartItems": [
{
"name": "Lipstick",
"sku": "Z4522A12E",
"quantity": 3,
"price": 29.99,
"category": "cosmetics"
}
],
"total": 89.97,
"state": "open"
}' 'https://developerdocs.talon.one/v1/customer_sessions/el9c3jcfkdq'

Effects[
[
2,
6,
0,
[
"addFreeItem",
"TEST-USER-ID",
"SKU-456",
"A free item for you!"
]
]
]