Recommended events for e-commerce

Below, you’ll find a bunch of in-app events recommended for your app category. We based our choice on industry-specific best practices and experts’ advice. By tracking these selected events, you can improve your behavioral segmentation and perform more effective, user-centric messaging campaigns.

Developer assistance needed

You’ll need your developer team’s help to set up these events. Please share this guide with them for detailed instructions.

To implement any of these or other events:

• Create the Event in your Pushwoosh Control Panel, add attributes if needed.
• Ask your development team to integrate the postEvent method into your mobile project. Provide the event name and attributes names exactly the same as in the Control Panel. For detailed instructions, please share this link with them.

Product viewed

Fire this event when a user opens a product page. Use it for browse abandonment campaigns and to segment users by the products and categories they view.

Recommended attributes:

• product_id: String
• product_category: String
• price: decimal (price)
• source: String

Product added to cart

Fire this event once a user adds product to their cart to build Abandoned Cart campaigns, set user tags, or analyze the efficiency of your promotions.

Recommended attributes:

• product_id: String
• product_name: String
• price: decimal (price)
• source: String

Checkout started

Fire this event when a user starts checkout. A user who started checkout but didn’t place an order is the audience for a checkout reminder.

Recommended attributes:

• cart_id: String
• cart_total: decimal (price)
• currency: String
• items_count: Integer

Order placed

Fire this event when a user completes a purchase. Send it for every purchase as your main purchase event, together with Discounted purchase, Product category, or First purchase when they also apply. Order placed works as a trigger for post-purchase messages and as a goal or exit condition for abandoned cart and browse abandonment journeys.

Recommended attributes:

• order_id: String
• __amount: decimal (price)
• __currency: String, a currency code such as USD
• product_id: String
• coupon_id: String

With the __amount and __currency attributes, Pushwoosh starts tracking revenue for this event automatically the first time it arrives. See Conversion events.

Caution

Don’t add __amount and __currency to other events, for example Checkout started or Order refunded. Pushwoosh adds the amount of every event that carries them to revenue, so the same money gets counted twice, and a refund increases revenue instead of reducing it.

Order refunded

Fire this event when an order is refunded, fully or partially. Use it to exclude these users from post-purchase campaigns or to ask why they returned the order.

Recommended attributes:

• order_id: String
• refund_amount: decimal (price)
• currency: String
• reason: String

Discounted purchase

Trigger this event once a user purchases any product using a discount coupon.

Recommended attributes:

• product_id: String
• coupon_id: String
• price: decimal (price)
• discount: String

Product Page abandoned

Fire this event when a user leaves a product page without a conversion action.

Recommended attributes:

• product_id: String
• price: decimal (price)
• source: String
• product_page_id: String

Product added to wishlist

Stay informed of the products that users have saved to their wishlists and create personal offers and promo campaigns.

Recommended attributes:

• product_id: String
• product_name: String
• wishlist_id: String
• product_price: decimal (price)
• source: String
• user_id: String

Product removed from wishlist

Fire this event when a user deletes a product from their wishlist.

Recommended attributes:

• user_id: String
• wishlist_id: String
• product_id: String

Product category

Send this event when a user purchases a product of a specific category.

Recommended attributes:

• product_id: String
• product_category: String
• currency: String

First purchase

Trigger this event once a user makes their first purchase.

Recommended attributes:

• product_id: String,
• category: String
• date: Date