How Conversion Tracking Works
UX Brite’s tracker observes every session on your site. When a session triggers any one of your active goals, that session is counted as a conversion. Key behaviors to understand:- Per-session matching — A session is marked converted the first time any active goal fires. Multiple goal firings in one session do not multiply the conversion count.
- Active goals only — Inactive goals are saved but ignored by the tracker until re-enabled.
- Instant effect — Enabling or disabling a goal takes effect for new sessions immediately; historical sessions are not retroactively updated.
- Goal type is permanent — Once a goal is created, its type (e.g. Purchase, Form Submit) cannot be changed. Delete and recreate the goal if you need a different type.
Goal Types
Each goal uses one of two detection strategies: URL-based or Event-based.URL-Based Goals
The tracker fires when a visitor lands on a specific page URL. Query parameters and trailing slashes are ignored during matching.| Goal Type | Description | Example URL |
|---|---|---|
| Making a Purchase | Confirmation or receipt page after checkout | https://example.com/order-confirmed |
| Page Visit | Any specific page that signals intent or value | https://example.com/pricing |
/thank-you?order=123matches a goal configured for/thank-you.
Event-Based Goals
The tracker fires when your site’s JavaScript callsuxbrite.track('custom_event', { action: 'YOUR_EVENT_NAME' }). This requires a small code integration on your site.
| Goal Type | Default Event Name | Description |
|---|---|---|
| Submitting a Contact Form | contact_form | Contact or lead form submissions |
| Signing Up for an Account | signup | New account registrations |
| Downloading a Resource | download | File or asset downloads |
| Booking an Appointment | appointment_booked | Meeting or appointment scheduling |
| Requesting a Callback | callback_requested | Callback or contact requests |
| Custom Event | (you choose) | Any other meaningful user action |
Triggering an Event Goal from Code
Add the following call to your site at the point of conversion (e.g. on form success, after checkout, on download click):YOUR_EVENT_NAME with the exact event name you configured for the goal. The name is case-sensitive.
Managing Conversion Goals
Conversion Goals are managed from the Conversion Goals section inside a Digital Experience’s detail page.Adding a Goal
- Navigate to Digital Experiences and open the experience you want to configure.
- Scroll to the Conversion Goals card and click Add Goal.
- Select a Goal Type from the grid.
- Give the goal a descriptive Goal Name (auto-filled from the type, editable).
- Enter the Conversion Page URL (URL-based goals) or Event Name (event-based goals).
- Click Save Goal.
Editing a Goal
- Find the goal card and open the ⋮ menu (three dots).
- Select Edit Goal.
- Update the name or configuration value.
- Click Update Goal.
Goal type cannot be changed when editing. If you need a different type, delete and recreate the goal.
Enabling / Disabling a Goal
Use the toggle switch on any goal card to enable or disable it without deleting it. Disabled goals are preserved with their configuration for later use.Deleting a Goal
- Open the ⋮ menu on the goal card.
- Select Delete Goal.
- Confirm the deletion in the dialog.
Recommended Goal Setup
For most experiences, we recommend setting up at least one goal from each relevant category to ensure complete conversion coverage:| Scenario | Recommended Goals |
|---|---|
| E-commerce site | Purchase (order confirmation URL) |
| Lead generation | Form Submit (contact form event) |
| SaaS / app | Signup (registration event) |
| Content / resources | Download (download event) |
| Service businesses | Appointment or Callback event |
Troubleshooting
Sessions are not being counted as conversions- Confirm the UXBrite tracker is installed and active on your site (check the tracker status in the Digital Experience detail page).
- For URL goals: verify the exact URL the visitor lands on matches the configured URL (ignoring query strings and trailing slashes).
- For event goals: confirm your site is calling
uxbrite.track('custom_event', { action: 'YOUR_EVENT_NAME' })and the event name matches exactly, including case. - Ensure the goal is active (toggle is on).
- If the toggle reverts, there may be a temporary API issue. Refresh the page and try again. An error toast will appear if the update fails.
- Goal type is locked after creation. Delete the existing goal and create a new one with the correct type.