Skip to main content

Event Tracking

The SDK includes 10 different event groups. You can activate only the groups you need.

Core Events

Automatically tracked:

EventDescriptionPayload Parameters (event_params)
page_viewPage viewpage_url (string), page_title (string), referrer (string)
session_startSession startsession_id (string), user_agent (string), timestamp (number)
session_endSession endsession_id (string), duration_ms (number)
user_engagementUser engagementengagement_time_ms (number), page_url (string)
clickClickelement_id (string), element_text (string), page_url (string)
scrollScroll depthpercent_scrolled (number), page_url (string)
first_visitFirst visitreferrer (string), utm_source (string), utm_medium (string)

Example Payloads

// page_view
{ "event_name": "page_view", "event_params": [
{ "key": "page_url", "value": "https://example.com/home" },
{ "key": "page_title", "value": "Home" },
{ "key": "referrer", "value": "https://google.com" }
]}

// session_start
{ "event_name": "session_start", "event_params": [
{ "key": "session_id", "value": "session_1736936000_abc123" },
{ "key": "user_agent", "value": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)" },
{ "key": "timestamp", "value": 1736936200 }
]}

// click
{ "event_name": "click", "event_params": [
{ "key": "element_id", "value": "btn-buy-now" },
{ "key": "element_text", "value": "Buy Now" },
{ "key": "page_url", "value": "https://example.com/product/123" }
]}

E-commerce Events

EventDescriptionPayload Parameters (event_params)
view_itemProduct viewitem_id (string), item_name (string), price (number)
add_to_cartAdd to cartitem_id (string), quantity (number), value (number)
remove_from_cartRemove from cartitem_id (string), quantity (number), value (number)
begin_checkoutBegin checkoutvalue (number), currency (string), num_items (number)
purchasePurchasetransaction_id (string), value (number), tax (number), shipping (number)
refundRefundtransaction_id (string), value (number)
add_to_wishlistAdd to wishlistitem_id (string), item_name (string), price (number)

Example Usage

// View product
b2mTrack('view_item', { item_id: 'SKU123', item_name: 'Laptop', price: 15000 });

// Add to cart
b2mTrack('add_to_cart', { item_id: 'SKU123', quantity: 1, value: 15000 });

// Purchase
b2mTrack('purchase', { transaction_id: 'T12345', value: 15000, tax: 2700, shipping: 50 });

Media Events

EventDescription
video_startVideo start
video_progressVideo progress (25%, 50%, 75%)
video_completeVideo complete
file_downloadFile download
b2mTrack('video_start', { video_id: 'v123', video_title: 'Product Demo', video_duration: 120 });
b2mTrack('video_progress', { video_id: 'v123', percent: 50 });

User Events

EventDescription
loginUser login
sign_upUser registration
logoutUser logout
b2mTrack('login', { method: 'email' });
b2mTrack('sign_up', { method: 'google' });