Skip to main content
Before starting, please read this article to learn more about the Gameball events engine: How does the Event(s) Rule Engine work? The following are the available Shopify events on Gameball.

​
place_order

​
Description

This event will be sent to Gameball when your customer places an order on your platform entirely. (Entirely means that the order status is Paid.)
The place_order event will not be sent to Gameball unless the order status is “Paid” to avoid potential fraud cases for payment methods like COD.

​
Keys

KeyDescription
total_discountTotal discount applied on this order
total_priceTotal order price
order_idOrder ID on Shopify
product_categoryProduct type of the order (fashion, electronics, etc.) Can be one category or multiple categories based on the items in the order
tagProduct tag of the order. Can be one tag or multiple tags based on the items in the order
collection_idCollection IDs of the order products. Can be one collection or multiple collections based on the products in the order
weightOrder weight
vendorProduct brand/vendor inside this order (e.g. Zara, Nike). Can be one or multiple brands sent simultaneously
sourceWhether the order was placed on the online Shopify store or through Shopify POS. Returns "web" or "pos"
Product Category Example
Collection ID Example

​
view_product_page

​
Description

This event should be sent when your customer views a product page on your Shopify store.

​
Keys

KeyDescription
product_idProduct ID on Shopify (found in the URL of the product)
product_categoryProduct category (fashion, electronics, etc.) based on available categories on your Shopify store
product_vendorProduct brand/vendor, based on available vendors on your Shopify store
collection_idCollection IDs of the product. Can be one collection or multiple collections
Product ID in URL
All the above events can be used in both the reward campaigns engine and while sending communication campaigns.

​
Friends_Referred

This event is automatically tracked when a customer successfully refers a friend through the Gameball referral program.

​
Order_Refunded

The order_refunded event is automatically triggered by Gameball whenever a refund is processed through the platform.
This event is only applicable when using the V4.0 Refund APIs.
This feature enables you to track refunded orders directly within the customer profile, helping them maintain an accurate transaction history and improve your customer support processes.
  • Full Refund Visibility: Every refund triggers an order_refunded event, logging essential refund data.
  • Customer Transparency: Refunded orders are now visible within each customer’s activity timeline.
  • Better Segmentation and Reporting: You can now segment customers based on refund behavior or integrate this event into your loyalty logic and analytics tools.
FieldDescription
order_idThe original order ID
refund_idThe unique refund ID
refunded_amountThe monetary amount refunded
refunded_pointsThe number of points deducted due to the refund

How Does the Event Rule Engine Work?

Understand how event-based triggers drive reward campaign logic.

Differentiate Reward Campaigns Through POS and Online Shopify

Use the Source key to target campaigns by sales channel.