Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paraminternationalltd.com/llms.txt

Use this file to discover all available pages before exploring further.

Auto Capture Events are events that Twinalyze tracks automatically from your website or app. This helps you start analytics faster without manually writing tracking code for every basic user action.
Auto capture is useful for common actions like page views, screen views, clicks, sessions, app foreground/background, and basic navigation events.

How auto capture works

1

Install SDK

Add the Twinalyze SDK to your website or app.
2

SDK detects user actions

Twinalyze automatically detects supported actions based on the platform.
3

Events are sent to Twinalyze

Auto captured events are sent with event name, source, timestamp, and properties.
4

Manage events in dashboard

You can view, search, enable, disable, or hide events from the dashboard.

Auto captured events by platform

Web auto capture

Web auto capture helps track common website activity.
EventWhat it tracks
page_viewWhen a user visits a page
clickWhen a user clicks a button, link, or element
scrollWhen a user scrolls a page
form_startWhen a user starts filling a form
form_submitWhen a user submits a form
session_startWhen a website session starts
session_endWhen a website session ends

Common Web properties

PropertyExample
page_url/pricing
page_titlePricing
element_textStart Free
element_tagbutton
referrergoogle.com
utm_sourcegoogle

Continue with Web SDK

Learn how to install Web SDK and start collecting website events.

Where to manage auto capture events

Auto captured events are managed from:
Dashboard → Data → Events
In the Events screen, you can manage event status, source, visibility, and search.
Twinalyze Data Events screen showing auto capture events

Event controls in dashboard

ControlMeaning
Event NameSystem event name tracked by Twinalyze
Custom Event NameDisplay name used in dashboard
SourcePlatform where event comes from, such as Android, Web, or iOS
Auto StatusControls auto capture for that event
Manual StatusControls manual tracking for that event
StatusEnables or disables the event
VisibleShows or hides the event in dashboard views
SearchHelps find events quickly
If you disable an important event, related reports may stop showing complete data. Change event status only when you are sure.

Auto capture vs custom event

TypeUse whenExample
Auto CaptureTwinalyze can track the action automaticallypage_view, screenInfo, appForeground
Custom EventYou want to track business-specific actionspurchase_completed, trial_started, payment_failed
Auto capture tracks common behavior. Custom events track actions that are unique to your business.

Example auto captured event

Example of an auto captured screen event:
{
  "eventName": "screenInfo",
  "source": "android",
  "properties": {
    "screenName": "HomeActivity",
    "screenClass": "HomeActivity",
    "appVersion": "1.0.8",
    "deviceModel": "Samsung SM-A525F"
  }
}
Example of an auto captured web event:
{
  "eventName": "page_view",
  "source": "web",
  "properties": {
    "page_url": "/pricing",
    "page_title": "Pricing",
    "referrer": "google.com"
  }
}

When to use custom events

Use custom events when the action is important for your business and cannot be fully understood through auto capture. Common custom event examples:
Custom eventMeaning
signup_completedUser completed signup
add_to_cartUser added product to cart
checkout_startedUser started checkout
purchase_completedUser completed purchase
payment_failedPayment failed
subscription_startedUser started subscription
Start with auto capture first. Then add custom events for your most important business flows.

Best practices

Events like page views, screen views, app foreground, app background, and sessions are important for basic analytics.
Use readable names like purchase_completed, payment_failed, or signup_completed.
Let auto capture handle common actions. Use custom events only for important business actions.
Keep important events visible so your team can use them in reports and dashboards.

Quick summary

QuestionAnswer
What is auto capture?Events tracked automatically by Twinalyze SDK
Where to manage events?Data → Events
Which platforms support it?Web, Android, and iOS
When to use manual events?For business-specific actions
Can events be hidden?Yes, using the Visible control
Can auto capture be disabled?Yes, using Auto Status