Track and measure user actions in widgets

Why should I track?

Tracking website and campaign data helps you optimise your marketing activities in a targeted manner. When you know what works and what doesn't, you can use your budget more efficiently and reach your target audience more effectively.

Examples:

• Facebook Ads: Check how many users land on your website via your ads and download BOTTIMMO content.
• Google Ads: Find out which search terms generate the most leads.
• Google Analytics: Analyse how users navigate your website and which content is particularly popular.

How can I track?

To track the success of your marketing activities, we recommend using Google Tag Manager. This allows for flexible and straightforward setup without requiring extensive changes to your website's source code.

Your options for implementation

1. Install it yourself on my website
   This option is suitable if you have advanced technical expertise and marketing knowledge.
2. Hire a web agency
   Your web agency can take care of the setup for you. Simply forward these instructions to them.
3. Professional support from our partner RealXLab.
   

With our partner RealXLab, you benefit from professional help. Robert Kampczyk is available to advise you (‘sparring’) or for complete implementation.

Set up tracking – quickly and easily

Use our tracking template and step-by-step instructions to set up tracking with the Google Tag Manager container.

BOTTIMMO itself does not offer any assistance with setup, but only support in the event that the events listed here are not sent correctly. In this case, please contact our support team: [email protected].

What can I track?

This section is intended for those with a technical interest who would like to delve deeper into the configuration and functionality of tracking. If you only need to implement tracking, you can use our tracking template directly. It already contains all relevant measurements and is ready to use.

Structure of the sent events

For important user actions, two types of events are stored in the dataLayer:

1. Simple event – Contains a composite event name in the format:

{ 
	"event": "BtmWidget_WidgetName_Aktion_Detail", 
	// ... zusätzliche Parameter 
}

2. Detailed event – Contains the event prefix, widget name, action, and additional properties in the format:

{ 
	"event": "BtmWidget", 
	"widget": "WidgetName", 
	"action": "Aktion", 
	"detail": "Detail", // Nicht bei allen Ergeignissen verfügbar
	// ... zusätzliche Parameter
}

Each event begins with the prefix BtmWidget. Btm stands for BOTTIMMO and is used to uniquely identify our events. This allows you to easily distinguish these events from others and process them specifically in Google Tag Manager. Widget indicates that the event originates from a widget. Depending on the action, additional parameters may be sent.

One event is sent for each widget action combination. All possible actions and widgets are listed below.

Overview of all actions

The following examples are based on property valuation, but apply to all available widgets.

Started

This event is triggered when a user starts interacting with a widget, e.g. by clicking a button or entering data.

Simple event:

{ 
	"event": "BtmWidget_Valuation_Started" 
}

Detailed event:

{ 
	"event": "BtmWidget", 
	"widget": "Valuation", 
	"action": "Started" 
}

StepCompleted

This event occurs when a user has completed a step in a multi-step widget.

In the example below, the event is triggered when the user moves from step 1 to step 2.

Additional parameters:

• detail: The number of the completed step.

Simple event:

{ 
	"event": "BtmWidget_Valuation_StepCompleted_2" 
}

Detailed event:

{ 
	"event": "BtmWidget", 
	"widget": "Valuation", 
	"action": "StepCompleted", 
	"detail": "2" 
}

StepBack

This event is triggered when a user returns to a previous step in the widget.

In the example below, the event is triggered when the user returns from step 2 to step 1.

Additional parameters:

• detail: The number of the step to which the user returns.

Simple event:

{ 
	"event": "BtmWidget_Valuation_StepBack_1" 
}

Detailed event:

{ 
	"event": "BtmWidget", 
	"widget": "Valuation", 
	"action": "StepBack", 
	"detail": "1" 
}

MilestoneReached

This event occurs when a user reaches an important milestone in the widget, e.g. entering their email address.

In the example below, the event is triggered when the user has entered their email address. All possible milestones for the respective widget are listed below.

Additional parameters:

• detail: The name of the milestone reached (e.g. EmailProvided, PhoneNumberProvided, AddressProvided, QuizzardCompleted).

Simple event:

{ 
	"event": "BtmWidget_Valuation_MilestoneReached_EmailProvided" 
}

Detailed event:

{ 
	"event": "BtmWidget", 
	"widget": "Valuation", 
	"action": "MilestoneReached", 
	"detail": "EmailProvided" 
}

ConversionAchieved

This event is triggered when a user has successfully completed the widget and a conversion has been created. This conversion then appears on the lead (contact) in the app.

Additional parameters:

• conversionId: The unique identifier of the conversion.
• leadId: The unique identifier of the lead.

Simple event:

{ 
	"event": "BtmWidget_WidgetName_ConversionAchieved", 
	"conversionId": "123", 
	"leadId": "123" 
}

Detailed event:

{ 
	"event": "BtmWidget", 
	"widget": "Valuation", 
	"action": "ConversionAchieved", 
	"conversionId": "123",
	"leadId": "123"
}

Special case download (guide/checklist)

To determine which guide or checklist was downloaded, the so-called slug (technical term) is transmitted as a detail in the events for the actions ‘Started’ and ‘ConversionAchieved’.

The following slugs are available:

Guide:

• marktbericht (sofern Sie den Marktbericht aktiviert haben)
• immobilienkauf
• energetische-sanierung
• immobilienfinanzierung
• immobilie-in-der-scheidung
• wohnen-im-alter
• privater-immobilienverkauf
• richtiger-immobilienpreis
• sanierung-einer-immobilie
• immobilien-fakten-und-begriffe (nur DE + AT)
• immobilie-geerbt (nur DE + AT)
• leibrente (nur DE + AT)
• bewirtschaftung-einer-immobilie-ratgeber (nur CH)
• immobilie-geerbt-ratgeber (nur CH)

Checklists:

• aufbereitung-der-immobilie
• unterlagen-fuer-den-verkauf
• was-gehoert-in-ein-expose
• energieausweis (nur DE + AT)
• immobilienpreis-finden (nur CH)
• immobilie-geerbt-checkliste (nur CH)
• bewirtschaftung-einer-immobilie-checkliste (nur CH)

Started

Simple event:

{ 
	"event": "BtmWidget_Download_Started_immobilie-in-der-scheidung" 
}

Detailed event:

{ 
	"event": "BtmWidget", 
	"widget": "Valuation", 
	"action": "Started",
	"detail": "immobilie-in-der-scheidung"
}

ConversionAchieved

Simple event:

{ 
	"event": "BtmWidget_Download_ConversionAchieved_immobilie-in-der-scheidung", 
	"conversionId": "123", 
	"leadId": "123" 
}

Detailed event:

{ 
	"event": "BtmWidget", 
	"widget": "Valuation", 
	"action": "ConversionAchieved", 
	"detail": "immobilie-in-der-scheidung",
	"conversionId": "123",
	"leadId": "123"
}

Available widgets and actions

Below is a list of all available widgets and the events triggered by these widgets. Please note that the technical term for the widget is used in the events.

Property valuation

Widget name in event: Valuation

Available actions:

• Started
• StepCompleted
• StepBack
• MilestoneReached – Available milestones:
  
  • AddressProvided: Address provided
  • EmailProvided: Email address provided
  • PhoneNumberProvided: Phone number provided
  • PhoneNumberVerified: Phone number verified
  • LastStepReached: Last step reached
• ConversionAchieved

Telephone consultation

Widget name in event: ReturnCall

Available actions:

• Started
• StepCompleted (only for wizard variant)
• StepBack (only for wizard variant)
• MilestoneReached – Available milestones:
  • EmailProvided: Email address provided
  • PhoneNumberProvided: Phone number provided
  • LastStepReached: Last step reached (only for wizard variant)
• ConversionAchieved
   

When integrating the ‘Telephone consultation’ widget into your website, you can choose between two variants. By default, all form fields are displayed at the same time. With the ‘wizard’ variant, the input is done in several steps. You can find more information about integration in the app: /landingpages/telefonische-beratung.

Guide / Checklists

Widget name in event: Download

Available actions:

• Started
• MilestoneReached – Available milestones:
  • EmailProvided: Email address provided
• ConversionAchieved

Dream home finder

Widget name in event: PropertyRequest

Available actions:

• Started
• StepCompleted
• StepBack
• MilestoneReached – Available milestones:
  • AddressProvided: Address provided
  • EmailProvided: Email address provided
     
  • PhoneNumberProvided: Phone number provided
  • LastStepReached: Last step reached
• ConversionAchieved

Property valuation

Widget name in event: PlotValuation

Available actions:

• Started
• StepCompleted
• StepBack
• MilestoneReached – Available milestones:
  • AddressProvided: Address provided
  • EmailProvided: Email address provided
     
  • PhoneNumberProvided: Phone number provided
  • LastStepReached: Last step reached
• ConversionAchieved

Life annuity check

Widget name in event: LifeAnnuity

Available actions:

• Started
• StepCompleted
• StepBack
• MilestoneReached – Available milestones:
  • AddressProvided: Address provided
  • EmailProvided: Email address provided
     
  • PhoneNumberProvided: Phone number provided
  • LastStepReached: Last step reached
• ConversionAchieved

Partial sale check

This widget is only available to RE/MAX customers in Germany.

Widget name in event: PartialSale

Available actions:

• Started
• StepCompleted
• StepBack
• MilestoneReached – Available milestones:
  • AddressProvided: Address provided
  • EmailProvided: Email address provided
  • PhoneNumberProvided: Phone number provided
  • LastStepReached: Last step reached
• ConversionAchieved

Situation analysis

Widget name in event: Quizzard

Available actions:

• Started
• StepCompleted (only for wizard variant)
• StepBack (only for wizard variant)
  
  • LastStepReached: The last step has been reached (only for wizard variant)
  • QuizzardCompleted: The quiz has been completed

The situation analysis does not send a ‘ConversionAchieved’ event, as no contact details have been provided at the end of the quiz. Only when the user subsequently requests a telephone consultation is there a ‘ConversionAchieved’ event. The situation analysis is merely a milestone.