Custom Tracking is the manual implementation of Frontend Tracking.
Do you use Google Tag Manager?
A widely used tool for implementing custom tracking is Google Tag Manager. If your organization uses GTM, this is preferred for creating events.
Please go to How do I create an event using Google Tag Manager?
Setup custom Frontend Tracking
Almost all tracking will be done through front-end. Place the personalized code snippet in the head section of every page you want to use tracking on. Note: Please log in to see your personalized snippet.
Setup events
You can find the script of each event together with the mandatory and optional properties to be sent in our api docs. Below you will find additional explanation per event.
➡️Check Frontend Tracking API docs
The AddToCart event should be triggered when a profile adds a product to the cart on the website.
Please note: the product id in the event needs to correspond with the SKU of the product in Spotler Activate!
In the following circumstances more fields are required:
- Are there multiple languages used on the website? → then also send language in the product array
- Is there more than one currency used on the website? → also send currency in the event
In this event extra data fields from the datalayer can be send along. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
The CompleteRegistration event should be triggered when a profile completes a registration or login.
In this event you can send extra data fields from the datalayer. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
A profile triggers a custom event to capture certain behavior.
The custom event has no mandatory fields. The event will be (minimal) displayed with the event name in Spotler Activate.
If the event displays more fields, additional fields will be included in the event.
A custom event can also be implemented with Backend Tracking.
The EmailOptIn event should be triggered when a profile signs up for the newsletter in the footer of the website.
In this event extra data fields from the datalayer can be sent along. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
The InitiateCheckout event should be triggered when a profile starts the checkout flow.
In this event extra data fields from the datalayer can be sent along. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
The PageView event should be triggered when a profile views a page on the website. This event is required on all web pages (that you want to track), regardless if other events are triggered.
- Are there multiple languages used on the website? → then also send language in the product array
- Is there more than one currency used on the website? → also send currency in the event
In this event extra data fields from the datalayer can be send along. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
In the following circumstances more fields are required:
- Are there multiple languages used on the website? → then also send language in the product array
- Is there more than one currency used on the website? → also send currency in the event
In this event extra fields from the datalayer can be send along. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
The Search event should be triggered when a profile performs a search on the website.
In this event extra data fields from the datalayer can be send along. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
The ViewCategory event should be triggered when a profile views a category page on the website.
Note: the category id in the event needs to correspond with the category id in Spotler Activate!
In this event extra data fields from the datalayer can be sent along. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
In the following circumstances more fields are required:
- Are multiple languages used on the website? → then also send language in the product array
- Are multiple currencies used on the website? → also send in the currency in the event
In this event extra data fields from the datalayer can be send along. Tip: send all fields that are available at the trigger in the datalayer and consult with the Spotler Activate users which extra fields they want to receive in the event.
Usefull links
- An overview of the data fields you can send in the event, can be found in the article: What are profile, product and event fields?
- How can I check the available data fields in my datalayer?
- After the implementation you can check the incoming events in Data > Events (Last 7 days) and Live events