Click

Events categorized under the click level will be used to track the way user is interacting with the storefront. For example, if a user adds a product to cart or logs in.

Add to cart

This event is generated to track add to cart events, indicating when a user has added anything to the cart. It provides essential information about the user and the product added to the cart.

Events
click/add_to_cart/engagement/v1
# This event is triggered when a user adds any item to the cart. It contains details associated with the user and the product being added to the cart.

click/add_to_cart/engagement/v1

This event is triggered when a user adds any item to the cart. It contains details associated with the user and the product being added to the cart.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
Payload associated with the event
Properties
user_id
string|null
ID of the user if they are logged in
anonymous_id
string
Required
User identifier in case user is not logged in
cart_id
string
Required
Unique identifier for the shopping cart.
event_type
string
Required
Type of the event, such as engagement.
product_id
integer
Required
Unique identifier for the product added to the cart.
article_id
string
Required
Unique identifier for the article associated with the product.
brand
string
Required
Brand name of the product.
l3_category
string
Required
Category level 3 of the product.
l1_category
string
Required
Category level 1 of the product.
currency
string
Required
Currency used for the product price.
price
integer
Required
Price of the product in the specified currency.
quantity
integer
Required
Quantity of the product added to the cart.
source_url
string
Required
URL source of the product.
position
string
Required
Position of the product in the cart.
value
string
Required
Value associated with the product.
context
object
Required
Context information for the emitted events, including details about the device and library used.
Properties
library
object
Required
Details of the library that emitted the event.
Properties
name
string
Required
Name of the library that emitted the event.
version
string
Required
Version of the library that emitted the event.
os
object
Required
Operating system details associated with the device the user is using.
Properties
name
string
Required
Name of the operating system associated with the device the user is using.
version
string
Required
Version of the operating system associated with the device the user is using.
timezone
string
Required
Timezone of the device the user is using. Represents the timezone in the 'Area/Location' string format.
screen
object
Required
Details about the screen the user is on, representing width and height properties.
Properties
width
integer
Required
Width of the screen the user is using in pixels.
height
integer
Required
Height of the screen the user is using in pixels.
userAgent
string
Required
String representing the user agent the browser is using.
locale
string
Required
Locale information of the device the user is using.
device
object
Required
Details of the device the user is using.
Properties
isMobile
boolean
Required
Flag indicating whether the device is a mobile device or not.
Payload Schema JSON
Loading...
Payload Example
Loading...

Order checkout

This event is generated to track order checkout events, indicating when a user is checking out an order. It provides essential information about the order and its contents.

Events
click/order_checkout/conversion/v1
# This event is emitted when a user proceeds to checkout an order.

click/order_checkout/conversion/v1

This event is emitted when a user proceeds to checkout an order.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
Payload for the generated event
Properties
context
object
Required
Context information related to the event.
Properties
library
object
Required
Information about the library used.
Properties
name
string
Required
Name of the library.
version
string
Required
Version of the library.
os
object
Required
Operating system information.
Properties
name
string
Required
Name of the operating system.
version
string
Required
Version of the operating system.
timezone
string
Required
Timezone information.
screen
object
Required
Screen resolution information.
Properties
width
integer
Required
Width of the screen.
height
integer
Required
Height of the screen.
userAgent
string
Required
User agent string indicating the browser or application.
locale
string
Required
Locale information of the device.
device
object
Required
Details of the device.
Properties
isMobile
boolean
Required
Flag indicating whether the device is a mobile device or not.
cart_id
string
Required
Unique identifier for the shopping cart.
cart_total
integer
Required
Total amount in the shopping cart.
shipping
integer
Required
Shipping cost.
tax
number
Required
Tax amount.
order_total
number
Required
Total amount of the order.
currency
string
Required
Currency used for the transaction.
products
array of object
Required
List of products in the cart.
Array of Properties
product_id
integer
Required
Unique identifier for the product.
l3_category
string
Required
Category level 3 of the product.
l1_category
string
Required
Category level 1 of the product.
quantity
integer
Required
Quantity of the product.
price
integer
Required
Price of the product.
value
integer
Required
Value of the product.
currency
string
Required
Currency used for the product price.
article_id
string
Required
Article ID of the product.
user_id
string|null
Required
Unique identifier for the user.
anonymous_id
string
Required
Anonymous identifier for the user.
version
string
Required
Version of the event.
Payload Schema JSON
Loading...
Payload Example
Loading...

Order complete

This event is generated to track order completion events, indicating when a user order has been successfully completed. It provides detailed information about the completed order, including item details, shipment information, and user data.

Events
click/order_complete/conversion/v1
# This event is triggered when an order is completed by the user.

click/order_complete/conversion/v1

This event is triggered when an order is completed by the user.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
Payload for the emitted event
Properties
context
object
Required
Contextual information of the event.
Properties
library
object
Required
Information about the library.
Properties
name
string
Required
Name of the library.
version
string
Required
Version of the library.
os
object
Required
Operating system information.
Properties
name
string
Required
Name of the operating system.
version
string
Required
Version of the operating system.
timezone
string
Required
Timezone information.
screen
object
Required
Screen resolution information.
Properties
width
integer
Required
Width of the screen.
height
integer
Required
Height of the screen.
userAgent
string
Required
User agent string indicating the browser or application.
locale
string
Required
Locale information of the device.
device
object
Required
Details of the device.
Properties
isMobile
boolean
Required
Flag indicating whether the device is a mobile device or not.
event_action
string
Required
Name of the action.
order_id
string
Required
Unique identifier for the order.
status
string
Required
Status of the order.
breakup_values_raw
object
Required
Breakup values of the order.
Properties
mrp_total
integer
Required
Total MRP of the items in the order.
sub_total
integer
Required
Subtotal amount of the order.
coupon
integer
Required
Coupon discount applied.
discount
integer
Required
Discount amount applied.
promotion
integer
Required
Promotion discount applied.
applied_emi_discount
integer
EMI discount applied.
applied_instant_discount
integer
Instant discount applied.
reward_points
integer
Required
Reward points used in the order.
cashback_applied
integer
Required
Cashback amount applied.
delivery_charges
integer
Required
Delivery charges for the order.
tcs_charge
integer
Tax Collected at Source (TCS) charge.
cod_charges
integer
Required
Cash on Delivery (COD) charges.
gift_price
integer
Required
Price of any gift items included in the order.
amount_to_be_collected
integer
Total amount to be collected from the customer.
total
integer
Required
Total amount of the order.
shipments
array of object
Required
Details of the shipments associated with the order.
Array of Properties
shipment_id
string
Required
Unique identifier for the shipment.
status
string
Required
Status of the shipment.
payment_mode
string
Required
Payment mode for the shipment.
items
array of object
Required
List of items in the order.
Array of Properties
name
string
Required
Name of the item.
brand
object
Required
Properties
name
string
Required
Brand name of the item.
logo
string
Required
URL of the brand's logo.
image
array of string
Required
Array of image URLs representing the item.
slug_key
string
Required
Slug key of the item.
size
string
Required
Size of the item.
code
string
Required
Product code or identifier.
id
integer
Required
Unique identifier for the item.
category
array of Undefined Type
Required
Categories to which the item belongs.
l3_category_name
string
Required
Name of the third-level category.
l1_categories
array of string
Required
First-level category names.
l2_categories
array of string
Required
Second-level category names.
seller_identifier
string
Required
Identifier of the seller.
attributes
object
Required
Attributes of the item.
Properties
name
string
Required
Name of the item attribute.
brand_name
string
Required
Brand name of the item.
media
array of Undefined Type
Required
Media associated with the item.
price
integer
Required
Price of the item.
quantity
integer
Required
Quantity of the item in the order.
screen
string
Required
Name of the screen where the event occurred.
screen_view
string
Required
View of the screen where the event occurred.
user
object
Required
Details of the user associated with the event.
Properties
_id
string
Required
Unique identifier for the user.
username
string
Required
Username of the user.
emails
array of Undefined Type
Required
Email addresses associated with the user.
gender
string
Required
Gender of the user.
active
boolean
Required
Flag indicating whether the user is active or not.
first_name
string
Required
First name of the user.
last_name
string
Required
Last name of the user.
phone_numbers
array of object
Required
Phone numbers associated with the user.
Array of Properties
phone
string
Required
Phone number.
active
boolean
Required
Flag indicating whether the phone number is active or not.
primary
boolean
Required
Flag indicating whether the phone number is primary or not.
verified
boolean
Required
Flag indicating whether the phone number is verified or not.
country_code
integer
Required
Country code of the phone number.
account_type
string
Required
Type of the user account.
profile_pic_url
string
Required
URL of the user's profile picture.
user_id
string
Required
Identifier of the user.
application_id
string
Required
Identifier of the application.
created_at
string
Required
Timestamp when the user was created.
updated_at
string
Required
Timestamp when the user was last updated.
user_id
string|null
Required
Unique identifier for the user.
anonymous_id
string
Required
Anonymous identifier for the user.
version
string
Required
Version of the event schema.
Payload Schema JSON
Loading...
Payload Example
Loading...

Product view

This event is triggered when the user views a product within the storefront. It captures details such as product ID, category, price, and user information, providing valuable insights for analytical and marketing purposes.

Events
click/product_view/click/v1
# This event is triggered when a user views a product within the storefront.

click/product_view/click/v1

This event is triggered when a user views a product within the storefront.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
payload for the emitted event
Properties
context
object
Required
Contextual information about the event.
Properties
library
object
Required
Information about the library used.
Properties
name
string
Required
Name of the library.
version
string
Required
Version of the library.
os
object
Required
Information about the operating system.
Properties
name
string
Required
Name of the operating system.
version
string
Required
Version of the operating system.
timezone
string
Required
Timezone of the event.
screen
object
Required
Information about the screen.
Properties
width
integer
Required
Width of the screen.
height
integer
Required
Height of the screen.
userAgent
string
Required
User agent of the device.
locale
string
Required
Locale of the event.
device
object
Required
Information about the device.
Properties
isMobile
boolean
Required
Indicates if the device is mobile or not.
product_id
integer
Required
ID of the product viewed.
currency
string
Required
Currency used for the product.
brand
string
Required
Brand of the product.
l3_category
string
Required
Level 3 category of the product.
mrp
integer
Required
Maximum retail price of the product.
esp
integer
Required
Effective selling price of the product.
l1_category
string
Required
Level 1 category of the product.
source_url
string
Required
Source URL of the product.
quantity
integer
Required
Quantity of the product viewed.
position
string
Required
Position of the product in the view.
user_id
null|string
Required
ID of the user (if available).
anonymous_id
string
Required
Anonymous ID of the user.
version
string
Required
Version of the event schema.
Payload Schema JSON
Loading...
Payload Example
Loading...

Product wishlist add

This event is triggered when a user adds a product to their wishlist within the storefront. It captures details such as wishlist name, ID, product details, and user information, providing valuable insights for tracking user engagement and preferences.

Events
click/product_wishlist_add/engagement/v1
# This event is triggered when a user adds a product to their wishlist within the storefront.

click/product_wishlist_add/engagement/v1

This event is triggered when a user adds a product to their wishlist within the storefront.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
Properties
context
object
Required
Contextual information about the event.
Properties
library
object
Required
Information about the library used.
Properties
name
string
Required
Name of the library.
version
string
Required
Version of the library.
os
object
Required
Information about the operating system.
Properties
name
string
Required
Name of the operating system.
version
string
Required
Version of the operating system.
timezone
string
Required
Timezone of the event.
screen
object
Required
Information about the screen.
Properties
width
integer
Required
Width of the screen.
height
integer
Required
Height of the screen.
userAgent
string
Required
User agent of the device.
locale
string
Required
Locale of the event.
device
object
Required
Information about the device.
Properties
isMobile
boolean
Required
Indicates if the device is mobile or not.
wishlist_name
string
Required
Name of the wishlist.
wishlist_id
string
Required
ID of the wishlist.
product_id
integer
Required
ID of the product in the wishlist.
brand
string
Required
Brand of the product.
l3_category
string
Required
Level 3 category of the product.
mrp
null
Required
Maximum retail price of the product (if applicable).
quantity
string
Required
Quantity of the product in the wishlist.
esp
null
Required
Effective selling price of the product (if applicable).
currency
null
Required
Currency used for the product (if applicable).
value
string
Required
Value associated with the product in the wishlist.
source_url
string
Required
Source URL of the product.
user_id
string|null
Required
ID of the user.
anonymous_id
string
Required
Anonymous ID of the user.
version
string
Required
Version of the event schema.
Payload Schema JSON
Loading...
Payload Example
Loading...

Product wishlist remove

This event is triggered when a user removes a product from their wishlist within the storefront. It captures details such as wishlist name, ID, product details, and user information, providing valuable insights for tracking user engagement and preferences.

Events
click/product_wishlist_remove/engagement/v1
# This event is triggered when a user removes a product from their wishlist within the storefront.

click/product_wishlist_remove/engagement/v1

This event is triggered when a user removes a product from their wishlist within the storefront.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
Payload for the event emitted
Properties
context
object
Required
Contextual information about the event.
Properties
library
object
Required
Information about the library used.
Properties
name
string
Required
Name of the library.
version
string
Required
Version of the library.
os
object
Required
Information about the operating system.
Properties
name
string
Required
Name of the operating system.
version
string
Required
Version of the operating system.
timezone
string
Required
Timezone of the event.
screen
object
Required
Information about the screen.
Properties
width
integer
Required
Width of the screen.
height
integer
Required
Height of the screen.
userAgent
string
Required
User agent of the device.
locale
string
Required
Locale of the event.
device
object
Required
Information about the device.
Properties
isMobile
boolean
Required
Indicates if the device is mobile or not.
wishlist_name
string
Required
Name of the wishlist.
wishlist_id
string
Required
ID of the wishlist.
product_id
integer
Required
ID of the product removed from the wishlist.
brand
string
Required
Brand of the product.
l3_category
string
Required
Level 3 category of the product.
mrp
null|number
Required
Maximum retail price of the product (if applicable).
quantity
string
Required
Quantity of the product in the wishlist.
esp
null|number
Required
Effective selling price of the product (if applicable).
currency
null|string
Required
Currency used for the product (if applicable).
value
string
Required
Value associated with the product in the wishlist.
source_url
string
Required
Source URL of the product.
user_id
string|null
Required
ID of the user.
anonymous_id
string
Required
Anonymous ID of the user.
version
string
Required
Version of the event schema.
Payload Schema JSON
Loading...
Payload Example
Loading...

Remove from cart

This event is triggered when a user removes a product from their shopping cart within the storefront. It captures details such as cart ID, product details, price, and user information, providing insights into user behavior and cart management.

Events
click/remove_from_cart/engagement/v1
# This event is triggered when a user removes a product from their shopping cart within the storefront.

click/remove_from_cart/engagement/v1

This event is triggered when a user removes a product from their shopping cart within the storefront.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
Payload for the emitted event.
Properties
context
object
Required
Contextual information about the event.
Properties
library
object
Required
Information about the library used.
Properties
name
string
Required
Name of the library.
version
string
Required
Version of the library.
os
object
Required
Information about the operating system.
Properties
name
string
Required
Name of the operating system.
version
string
Required
Version of the operating system.
timezone
string
Required
Timezone of the event.
screen
object
Required
Information about the screen.
Properties
width
integer
Required
Width of the screen.
height
integer
Required
Height of the screen.
userAgent
string
Required
User agent of the device.
locale
string
Required
Locale of the event.
device
object
Required
Information about the device.
Properties
isMobile
boolean
Required
Indicates if the device is mobile or not.
cart_id
string
Required
ID of the cart from which the product is being removed.
event_type
string
Type of the event.
product_id
integer
Required
ID of the product being removed from the cart.
brand
string
Required
Brand of the product.
l3_category
string
Required
Level 3 category of the product.
l1_category
string
Required
Level 1 category of the product.
currency
string
Required
Currency used for the product.
price
integer
Required
Price of the product.
quantity
integer
Required
Quantity of the product being removed.
source_url
string
Required
Source URL of the product.
position
string
Required
Position of the product in the cart.
value
string
Required
Value associated with the product being removed.
user_id
string|null
Required
ID of the user.
anonymous_id
string
Anonymous ID of the user.
version
string
Version of the event schema.
Payload Schema JSON
Loading...
Payload Example
Loading...

User login

This event is triggered when a user logs into the storefront. It captures details such as login method, user device, and timestamp, providing insights into user authentication and behavior.

Events
click/user_login/identity/v1
# This event is triggered when a user logs into the storefront.

click/user_login/identity/v1

This event is triggered when a user logs into the storefront.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
Payload for the generated event
Properties
context
object
Required
Contextual information about the event.
Properties
library
object
Required
Information about the library used.
Properties
name
string
Required
Name of the library.
version
string
Required
Version of the library.
os
object
Required
Information about the operating system.
Properties
name
string
Required
Name of the operating system.
version
string
Required
Version of the operating system.
timezone
string
Required
Timezone of the event.
screen
object
Required
Information about the screen.
Properties
width
integer
Required
Width of the screen.
height
integer
Required
Height of the screen.
userAgent
string
Required
User agent of the device.
locale
string
Required
Locale of the event.
device
object
Required
Information about the device.
Properties
isMobile
boolean
Required
Indicates if the device is mobile or not.
user_id
string|null
Required
ID of the user if they are logged in
anonymous_id
string
Required
User identifier in case user is not logged in
version
string
Required
Version of the event schema.
email
string
Email Id associated with the user
login_value
string
Required
Value associated with the login, might contain email id or number depending on the method
method
string
Required
Type of login opted by the user
phone
string
Phone number associated with the user
Payload Schema JSON
Loading...
Payload Example
Loading...

User logout

This event is triggered when a user logs out of the storefront. It provides insights into user session management and behavior.

Events
click/user_logout/identity/v1
# This event is triggered when a user logs out of the storefront.

click/user_logout/identity/v1

This event is triggered when a user logs out of the storefront.

Payload
application_id
array|string
Required
Application ID(Sales Channel) for which this event is triggered
contains
array of string
Required
This array will have all the keys present at root level of 'payload' object
event
object
Required
Properties
category
string
Required
Category of the event. If it is at sales channel level or company level
created_timestamp
integer
Required
Event generation timestamp in epoch milliseconds
id
string
Required
Unique ID for an event. This id can be used to verifiy if event is already processed by receiver
name
string
Required
Name of the event
trace_id
array of string
Required
Internal trace_id for Fynd Platform services
type
string
Required
Type/Action of the event. e.g. create/update/delete
version
string
Required
Version of the event.
payload
object
Required
Payload for the emitted event
Properties
context
object
Required
Contextual information about the event.
Properties
library
object
Required
Information about the library used.
Properties
name
string
Required
Name of the library.
version
string
Required
Version of the library.
os
object
Required
Information about the operating system.
Properties
name
string
Required
Name of the operating system.
version
string
Required
Version of the operating system.
timezone
string
Required
Timezone of the event.
screen
object
Required
Information about the screen.
Properties
width
integer
Required
Width of the screen.
height
integer
Required
Height of the screen.
userAgent
string
Required
User agent of the device.
locale
string
Required
Locale of the event.
device
object
Required
Information about the device.
Properties
isMobile
boolean
Required
Indicates if the device is mobile or not.
user_id
string|null
Required
ID of the user.
anonymous_id
string
Required
Anonymous ID of the user.
version
string
Required
Version of the event schema.
Payload Schema JSON
Loading...
Payload Example
Loading...