Leadoo AI is fully integrated to Google Tag Manager, meaning that custom events can be triggered for every interaction any visitor has with Leadoo AI conversation tools. Here’s how to implement Google Tag Manager to work with Leadoo AI:

1. Add your Google Tag Manager container ID to your Leadoo admin panel

Go to Conversion Kit -> General bot settings -> Advanced

*In most cases you can leave GTM data layer property field empty.

After this has been set your bots will start sending events.

2. Open Google Tag Manager and create a new trigger

Select “Custom event”

Then set the event name accordingly.

GTM TRIGGER NAMES

Events sent automatically by Leadoo AI include:

TRIGGER – Sent when a bot is triggered

DISCUSSION – Sent when a bot discussion is started

LEAD – Sent when a lead is converted

LC_TRIGGER – Sent when a live chat conversation is started

AI_DISCUSSION – Sent after the user sends their first message and successfully receives an AI-generated response

PRODUCT_RECS_DISCUSSION – Sent after the user sends their first message and successfully receives a response in a product recommendation discussion

PRODUCT_RECOMMENDATION_DISPLAY – Sent when product recommendations are displayed to the user

Additional value:

• product_id – IDs of the displayed products

PRODUCT_RECOMMENDATION_CLICK – Sent when a user clicks a product recommendation

Additional value:

• product_id – ID of the clicked product

BOT_RATING_SUBMITTED – Sent when the user submits a bot rating by clicking one of the rating stars

Additional value:

• rating_value – The submitted bot rating

Multiselect options, used for creating audiences for retargeting ads:

GTM-1234 – Sent when a button is clicked within a bot discussion

By default, event names are generated in a format such as “GTM-2663823”, but they can be edited in the Leadoo AI backend.

To prevent duplicate analytics data:

BOT_RATING_SUBMITTED is sent only once per rating submission. Returning to the rating step does not generate duplicate events.

PRODUCT_RECOMMENDATION_CLICK is sent only once for the same product within a single discussion, even if the user clicks it multiple times.

3. After creating the triggers, you can move to creating the tags

Universal Analytics:

Choose “Track Type -> Event”

Set the desired values for category, action and label.

Most commonly we suggest to add the following values for basic users when measuring just leads / conversions:
Category: Leadoo
Action: Lead / Discussion / Trigger
Label: Page url variable

Connect this created tag to the trigger that is associated with action set in this section.

Now you will be able to track your Leadoo conversion in Google Analytics.

Google Analytics 4:

First start by configuring Your GA4 Tag In Google Tag Manager

Before creating our custom event tag, we need to first configure our GA4 tag in GTM to connect the two applications. In your GTM container, create a new tag using the following steps:

1. Click New Tag
2. Label your new GA4 Configuration Tag
3. Choose the Google Analytics: GA4 Configuration
4. Input Your Measurement ID from GA4*
5. Click the box “Send a page view event when this configuration loads”
6. Click save

* You can find Measurement ID from GA4 under Admin -> Data Stream -> click account -> copy Measurement ID

After configuring GA4, you can move to creating the tags

Example:

Choose “Tag Type” ->GA4 Event

”Event Name” -> Leadoo_Lead *

Connect this created tag to the trigger that is associated with action set in this section.

*If you want more specific information to be sent to GA4 (Bot type, Bot Category, Label etc.) you should add these to ”Event Parameter”

Fe. You want to see Labels on GA4:
Add row -> Parameter Name: Lead_type -> Value: {{Label}}

(Remember to create ie. {{Label}} variable on GTM using Data layer variable)

Some Leadoo AI events include additional values that can be passed to Google Analytics 4 as event parameters. Create the corresponding Data Layer variables in Google Tag Manager and add them under Event Parameters in your GA4 Event tag.

Use product_id for product recommendation display and click events, and rating_value for bot rating events. The values available depend on the event being tracked.

Now you will be able to track your Leadoo AI conversions in Google Analytics.

Advanced Users

More advanced Google Tag Manager users can also leverage the information sent over on the data layer. The following details can be used to create custom variables

category <- Bot type (embed, chat, cta, modal)
bot_category <- For each bot you can set a bot category on the Leadoo AI backend, this allows you to create for example separate analytics for sales and recruitment bots
label <- For each multi select answer you can create custom labels. These can be for example interest type of the customer
text <- Info of what text was written on the bot.
bot_name <- Name of the bot
bot_nickname <- Name given on bot settings
product_id – The ID of the clicked product or the IDs of the products displayed in a product recommendation event.
rating_value – The rating submitted by the user.