Firebase events and parameters
Firebase Analytics is a free app measurement solution that provides insight on app usage and user engagement.
Events
add_to_cart
parameters: value, currency, eventCategory, items
Inside items, there will be item_id, item_name, price, item_variant, quantity
Example:
currency: "INR"
eventCategory: "Product Screen"
items: [{
item_id: "1234567890",
item_name: "product name",
price: 100,
item_variant: "Blue / M",
quantity: 1
}]
It is a GA4 event.
remove_from_cart
parameters: value, currency, eventCategory, items
Inside items, there will be item_id, item_name, price, item_variant, quantity
Example:
currency: "INR"
eventCategory: "Cart Screen"
items: [{
item_id: "1234567890",
item_name: "product name",
price: 100,
item_variant: "Blue / M",
quantity: 1
}]
It is a GA4 event.
view_item
parameters: value, currency, eventCategory, items
Inside items, there will be item_id, item_name, price, item_variant
Example:
currency: "INR"
value: 100
eventCategory: "Product Screen"
items: [{
item_id: "1234567890",
item_name: "product name",
price: 100,
item_variant: "Blue / M"
}]
It is a GA4 event.
view_item_list
parameters: items
Inside items, there will be item_id, item_name, item_variant, price, item_brand, quantity
Example:
items: [{
item_id: "1234567890",
item_name: "product name",
item_variant: "Blue / M",
price: 100,
item_brand: "Brand Name",
quantity: 1
}]
It is a GA4 event.
view_cart
parameters: value, currency, items
Inside items, there will be item_id, item_name, price, item_variant, quantity
Example:
currency: "INR"
value: 100
items: [{
item_id: "1234567890",
item_name: "product name",
price: 100,
item_variant: "Blue / M",
quantity: 1
}]
It is a GA4 event.
begin_checkout
parameters: value, currency, items
Inside items, there will be item_id, item_name, price, item_variant, quantity
Example:
currency: "INR"
value: 100
items: [{
item_id: "1234567890",
item_name: "product name",
price: 100,
item_variant: "Blue / M",
quantity: 1
}]
It is a GA4 event.
purchase
parameters: value, currency, transaction_id, userAgent, items
Inside items, there will be item_id, item_name, price, item_variant, quantity
Example:
currency: "INR"
value: 100
transaction_id: "1001"
userAgent: "Appmaker"
items: [{
item_id: "1234567890",
item_name: "product name",
price: 100,
item_variant: "Blue / M",
quantity: 1
}]
It is a GA4 event.
add_to_wishlist
parameters: value, currency, eventCategory, items
Inside items, there will be item_id, item_name, price, quantity
Example:
currency: "INR"
value: 100
eventCategory: "Product Screen"
items: [{
item_id: "1234567890",
item_name: "product name",
price: 100,
quantity: 1
}]
It is a GA4 event.
search
parameters: search_term
Example:
"search_term": "blue shirt"
cart_created
parameters: checkoutId, value, currency
Triggered when the user's cart is created for the first time (i.e. on first item added to cart).
Example:
checkoutId: "abc123xyz"
value: 100
currency: "INR"
cart_updated
parameters: checkoutId, value, currency
Triggered when an item is added or modified in an existing cart.
Example:
checkoutId: "abc123xyz"
value: 200
currency: "INR"
user_logged_in
parameters: No parameters passed
user_logged_out
parameters: No parameters passed
appmaker_block_click
parameters: content_type, content_id, content_list_id, resource_url
Example:
content_type: "appmaker/banner",
content_id: "b1fd3f08-5fb8-4524-929a-a942756ff9a7",
content_list_id: "3329cc08-71e4-4c7e-a912-13198b98913b",
resource_url: "https://cdn.shopify.com/s/files/1/banner.jpg"
appmaker_bottom_tab_click
parameters: tabName, tabLabel
Example:
tabName: "1dd4b673-c9e1-425c-ba24-bc87857a59e0",
tabLabel: "Home"
product_search_result
parameters: item_list_name, list_query, items
Inside items, there will be item_id, item_name, item_list_id, item_list_name
Example:
item_list_name: "product_search_result",
list_query: "blue shirt",
items: [{ item_id: "1234567890", item_name: "product name" }]
buy_now
parameters: lineItem
Inside lineItem, there will be variantId, quantity, attributes
Example:
lineItem: {
variantId: "gid://shopify/ProductVariant/1234567890",
quantity: 1,
attributes: []
}
RemoveFromWishlist
parameters: eventCategory, eventAction, product_name
Example:
eventCategory: "Product Screen",
eventAction: "Remove From Wishlist clicks",
product_name: "product name"
ShareProduct
parameters: eventCategory, eventAction, product_name
Example:
eventCategory: "Product Screen",
eventAction: "Share Product clicks",
product_name: "product name"
SortClick
parameters: eventCategory, eventAction, value
Example:
eventCategory: "Category Screen",
eventAction: "Sort Clicks",
value: "price-asc"
FilterClick
parameters: eventCategory, eventAction, filter_click_item
filter_click_item is a JSON string truncated to 100 characters.
Example:
eventCategory: "Category Screen",
eventAction: "Filter Clicks",
filter_click_item: "-{\"available\":true}-"
SubCategoryClick
parameters: eventCategory, eventAction, sub_category_name
Example:
eventCategory: "Home Screen",
eventAction: "Drawer Category Clicks",
sub_category_name: "Men"
App-specific events
These events are only available in apps where the relevant feature is enabled.
ApplyCouponCode
parameters: eventCategory, eventAction, couponCode
Example:
"eventCategory": "cart",
"eventAction": "Apply Coupon Code",
"couponCode": "SAVE10"
Auto-collected events
These events are collected automatically by the Firebase SDK.
| Event | Description |
|---|---|
session_start | Triggered when a user starts a new session |
app_remove | Triggered when the app is uninstalled |
screen_view | Triggered on every screen/page change |
user_engagement | Triggered when the app is in the foreground |
Shopify Checkout Sheet Kit events
These events are only fired when the app uses the default Shopify checkout (powered by @shopify/checkout-sheet-kit). They originate from Shopify's pixel events and are prefixed with cs_ by Appmaker to identify their source.
cs_page_viewed
parameters: id, name, timestamp, type
cs_checkout_started
parameters: id, name, timestamp, type
cs_checkout_completed
parameters: id, name, timestamp, type