User
Register and apply a tracking pixel
Save a provider pixel definition and choose where it should be applied. Registering a pixel does not by itself prove that the provider received an event.
Step-by-step guide
Before you start
- Have the correct pixel ID/provider setup for the property you control. Know which pages/links should use it.
Open this feature
- Open /portal/brand/tracking-pixels on your site.
How to use it
Choose a task
Add a pixel and choose its use
- Open /portal/brand/tracking-pixels and enter Pixel name.
- Select Provider, choose the intended Status, and enter Pixel ID for that provider. Use Custom pixel script only for a supported custom-script setup you understand.
- Select Use as default for new Short Links, Link Bio pages, and QR Codes only if that broad default is intended. Select Add pixel.
- Open a supported item’s editor, review its Tracking pixels selection and save the item. Use Pause/Activate or Set default/Unset on the pixel entry deliberately.
- Test the actual public page/redirect behavior and the provider’s event tooling. A saved pixel ID is not a successful provider event.
Fields and examples
| Field or choice | How to use it |
|---|---|
| Pixel name | Internal name identifying its purpose/property. |
| Provider / Pixel ID | Use the correct provider and ID from the property you control. |
| Status | Controls whether the definition is active; a paused pixel should not be treated as an active tracking setup. |
| Use as default | Affects default selection for new supported items. Review existing item selections separately. |
Check your finished result
- Reopen the pixel definition and selected item, then inspect an authorized test event with the provider.
Problems and fixes
| What you see | What to do next |
|---|---|
| No event is visible | Check active state, the saved item’s pixel selection, the actual public flow and provider-specific event verification. |
| Pixel appears on unintended new items | Review its default flag and each item’s selected pixels. |
Technical reference
Role-scoped source references
Pinned commit: ca125291cce57358ac4842e50928bc31fc6eab07
Source-only route information
| Method | Source-default route |
|---|---|
| GET | /portal/brand/tracking-pixels |
Unmapped fields — not user instructions
These fields belong to this role’s source handler, but their screen labels were not confirmed.
| Source key | Handler |
|---|---|
| name | modules/AppTrackingPixels/Livewire/TrackingPixelsIndex.php |
| provider | modules/AppTrackingPixels/Livewire/TrackingPixelsIndex.php |
| pixel_id | modules/AppTrackingPixels/Livewire/TrackingPixelsIndex.php |
| status | modules/AppTrackingPixels/Livewire/TrackingPixelsIndex.php |
| script | modules/AppTrackingPixels/Livewire/TrackingPixelsIndex.php |