Coupons

Detailed description of the ecommerce lifecycle events related to the customer's interaction with coupons

Introduction

These lifecycle events are associated with the key interactions that a customer has with the app or website while using the discount coupons.

Coupon Entered

This event is triggered whenever a coupon is entered by the customer, either on a cart or during the order/transaction. The following properties are supported by this event:

Property Name	Type	Description of the Property
order_id	String	Contains the order ID or the transaction ID, if applicable
cart_id	String	Contains the cart ID, if applicable
coupon_id	String	Contains the coupon ID

An example of the Coupon Entered event is as shown:

rudderanalytics.track("Coupon Entered", {
  order_id: "12345",
  cart_id: "1222111",
  coupon_id: "disc20",
})

Coupon Applied

This event is triggered whenever a coupon is applied to a cart or a transaction successfully. The following properties are supported by this event:

Property Name	Type	Description of the Property
order_id	String	Contains the order ID or the transaction ID, if applicable
cart_id	String	Contains the cart ID, if applicable
coupon_id	String	Contains the coupon ID
coupon_name	String	Contains the name of the coupon
discount	Number	Contains the amount of discount availed by applying the coupon

An example of the Coupon Entered event is as shown:

rudderanalytics.track('Coupon Applied', {
      order_id: '1223455',
      cart_id: '123566'
      coupon_id: '23321',
      coupon_name: 'Disc21',
      discount: 21.00
    });

Coupon Denied

This event is triggered whenever an invalid coupon code is applied to a cart or a transaction. The following properties are supported by this event:

Property Name	Type	Description of the Property
order_id	String	Contains the order ID or the transaction ID, if applicable
cart_id	String	Contains the cart ID, if applicable
coupon_id	String	Contains the coupon ID
coupon_name	String	Contains the name of the coupon
reason	String	Contains the reason why the coupon was declined

An example of the Coupon Denied event is as shown:

rudderanalytics.track('Coupon Denied', {
      order_id: '123',
      cart_id: '1211'
      coupon: 'Disc21',
      reason: 'Coupon expired'
    });

Coupon Removed

This event is triggered whenever a customer removes an already applied coupon from a cart or transaction. The following properties are supported by this event:

Property Name	Type	Description of the Property
order_id	String	Contains the order ID or the transaction ID, if applicable
cart_id	String	Contains the cart ID, if applicable
coupon_id	String	Contains the coupon ID
coupon_name	String	Contains the name of the coupon
discount	Number	Contains the amount of discount availed by applying the coupon

An example of the Coupon Removed event is as shown:

analytics.track('Coupon Removed', {
  order_id: '1211',
  cart_id: '124'
  coupon_id: 'Dis123',
  coupon_name: 'Disc20',
  discount: 20.00
});

Contact Us

To know more about the RudderStack eCommerce spec, feel free to contact us or start a conversation in our Slack community. You can also request a demo to see RudderStack in action.