Kayzen facilitates advertisers who are using Google Tag Manager (GTM) for their website to run campaigns and track any custom events in the Kayzen platform. With this document, you will be able to understand the configurations and settings you need to implement to run campaigns on Kayzen using GTM.


An advertiser who is advertising their Car Showroom website wants to track the number of people who have requested a Demo Ride on their website. Advertiser will run campaigns on Kayzen and any ads which have triggered “Demo Ride” on the website will be tracked in Kayzen.

Google Tag Manager settings

You will need to implement the following settings in your GTM for your website where you want to track the events. You need to implement all these below settings for every event you want to measure in Kayzen.

Create a new Variable:

  1. Variable Type: URL
  2. Component Type: Query
  3. Query Key: bid_id*
  4. Variable Name: <Name of the Variable>

Create a new Trigger:

  1. Trigger Type: Click - All Elements
  2. This trigger fires on: Some Clicks
  3. Click Element matches CSS selector <#the-button>
  4. Trigger Name: <Name of the Trigger>

Create a new Tag:

  1. Tag Type: Custom Image
  2. Image URL: https://api-events.kayzen.io/v1/ev?tp=direct&api_key=<api_key>&app_event=<event_name>&can_claim=1&bid_id={{<Name of the Variable>}}*
  3. Enable Cache Busting
  4. Triggering: choose the new trigger you created “<Name of the Trigger>”

Kayzen click URL:

Click URL should have a mandatory Kayzen macro &bid_id={CONVERSION_ID}* (if you want to track other details on Kayzen, you can refer to macro tracking article).

Sample click URL: https://kayzen.io/?utm_source=Kayzen&utm_medium=display&utm_campaign=Test&bid_id={CONVERSION_ID}

☝️ *bid_id in Variable creation and image URL under Tag creation in GTM and the click URL *bid_id you use in Kayzen should all be the same format.

💡 Other related articles you can refer to how to get API key

Did this answer your question?