Event Tracking
The SDK includes 10 different event groups. You can activate only the groups you need.
Core Events
Automatically tracked:
| Event | Description | Payload Parameters (event_params) |
|---|---|---|
page_view | Page view | page_url (string), page_title (string), referrer (string) |
session_start | Session start | session_id (string), user_agent (string), timestamp (number) |
session_end | Session end | session_id (string), duration_ms (number) |
user_engagement | User engagement | engagement_time_ms (number), page_url (string) |
click | Click | element_id (string), element_text (string), page_url (string) |
scroll | Scroll depth | percent_scrolled (number), page_url (string) |
first_visit | First visit | referrer (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
| Event | Description | Payload Parameters (event_params) |
|---|---|---|
view_item | Product view | item_id (string), item_name (string), price (number) |
add_to_cart | Add to cart | item_id (string), quantity (number), value (number) |
remove_from_cart | Remove from cart | item_id (string), quantity (number), value (number) |
begin_checkout | Begin checkout | value (number), currency (string), num_items (number) |
purchase | Purchase | transaction_id (string), value (number), tax (number), shipping (number) |
refund | Refund | transaction_id (string), value (number) |
add_to_wishlist | Add to wishlist | item_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
| Event | Description |
|---|---|
video_start | Video start |
video_progress | Video progress (25%, 50%, 75%) |
video_complete | Video complete |
file_download | File download |
b2mTrack('video_start', { video_id: 'v123', video_title: 'Product Demo', video_duration: 120 });
b2mTrack('video_progress', { video_id: 'v123', percent: 50 });
User Events
| Event | Description |
|---|---|
login | User login |
sign_up | User registration |
logout | User logout |
b2mTrack('login', { method: 'email' });
b2mTrack('sign_up', { method: 'google' });