Coupon Applied
Also known as: coupon_apply, Apply Coupon, Promo Code Applied, Discount Code Entry, Voucher Applied
Custom coupon_apply event, fired when the store accepts a coupon or promo code a shopper submits in cart or checkout. Rejected codes do not fire; redemption is read from purchase.
Event Serialization
alwaysBusiness Use Case
["1️⃣ CRM Marketing: a campaign code is applied often but seldom reaches purchase → reviews checkout friction for that send.","2️⃣ Merchandising: average discount_value per applied code exceeds plan → tightens the code's cap or eligible items.","3️⃣ Finance: a leaked or unissued code spikes in applied hits → has the code revoked and checks the margin hit."]
Business Criticality
Medium
Journey / Navigation Area
Checkout
Owning Function
Marketing
Calculation Notes
["1️⃣ Fires only when the store accepts a submitted code and applies the discount; never on typing, field focus, a rejected code or the purchase.","2️⃣ Serialization always: each accepted code is a hit. Drop a repeat of the same coupon and cart_id within 2 seconds (Enter plus click).","3️⃣ Required: coupon, discount_value, currency, value, cart_id, page_type. Optional: checkout_step (checkout only).","4️⃣ Rejected codes are tracked on checkout_error (Checkout Error), not here. Code-free automatic promotions and clearing a code do not fire.","5️⃣ Uppercase and trim coupon to join purchase.coupon; mask single-use code suffixes the same way on purchase. No email or user data.","6️⃣ Sent only under analytics consent. Common mistake: firing on the success banner render, so a page reload re-sends the hit; push on the response."]
Platform Events
| Platform | Event |
|---|---|
| Google Analytics 4 | coupon_apply |
| Adobe | coupon_apply |
Data Mappings
W3 Data Layer
{
"digitalData": {
"event": [
{
"eventInfo": {
"eventName": "coupon_apply"
},
"attributes": {
"coupon": "CODE-1",
"discount_value": 10,
"value": 90,
"currency": "USD",
"cart_id": "cart-1",
"page_type": "checkout",
"checkout_step": 2
}
}
]
}
}GA4 Data Layer
{
"event": "coupon_apply",
"coupon": "CODE-1",
"discount_value": 10,
"value": 90,
"currency": "USD",
"cart_id": "cart-1",
"page_type": "checkout",
"checkout_step": 2
}Adobe Client Data Layer
{
"event": "coupon_apply",
"eventInfo": {
"coupon": "CODE-1",
"discount_value": 10,
"value": 90,
"currency": "USD",
"cart_id": "cart-1",
"page_type": "checkout",
"checkout_step": 2
}
}XDM Mapping
{
"eventType": "coupon_apply",
"_tenantId": {
"coupon": "CODE-1",
"discount_value": 10,
"value": 90,
"currency": "USD",
"cart_id": "cart-1",
"page_type": "checkout",
"checkout_step": 2
}
}Parameters
{
"value": "number - Net cart value after the discount, as on add_to_cart and view_cart; pre-discount value = value + discount_value",
"coupon": "string - Code as submitted, uppercased and trimmed; same format as purchase.coupon",
"cart_id": "string - Cart identifier, same as add_to_cart.cart_id",
"currency": "string - ISO 4217 code of value and discount_value",
"page_type": "string - cart | checkout",
"checkout_step": "number - Checkout step where the code was entered; checkout only",
"discount_value": "number - Discount granted by the accepted code in currency units"
}Source Data
Digital Analytics (GA4)
Dependencies
Prerequisite: List the dependencies required for this Event
Dimensions:
Report Attributes
Coupon Code Page Type Checkout Step Device Category Traffic Source
Segment Eligibility
true
Governance
Dimensions
Related Dimensions
Derived Dimensions
Derived Entities
Derived KPIs
Governance & Metadata
GitHub
catalog/events/coupon-applied.yml