tl;dr
Custom conversions let you track on-site events beyond standard purchase conversions — such as Add to Cart, Newsletter Sign-Up, or any other action relevant to your business goals. You can pass a monetary value with each event to measure ROAS and CPA.
Setup involves two steps:
Fire the event in your store code or via GTM
Name the event in Klar (Store Configurator → Store Settings → Custom Conversions)
Custom Conversion Tracking in Klar
Overview
Track on-site conversions and send them to Klar for in-depth analysis within your attribution reports. You can also pass values linked to these custom events to measure ROAS and other key performance metrics.
1️⃣ Sending Custom Conversion Events
Event Name
customConversionEvent
Example Implementations
Integrate the following code in your store source code or via GTM:
Shopify Customer Events (recommended for Shopify stores)
Shopify.analytics.publish("Klar:customConversionEvent", {
customConversionId: 1,
customConversionValue: 20.0
});
Shopify Webpixel Sandbox
api.analytics.publish("Klar:customConversionEvent", {
customConversionId: 1,
customConversionValue: 20.0
});
All other implementations (Shopware, WooCommerce, GTM)
window._k_q = window._k_q || [];
window._k_q.push(["Klar:customConversionEvent", {
customConversionId: 1,
customConversionValue: 20.0
}]);
Available fields
customConversionId(Integer, 1–10) — identifies the event type. You can define up to 10 different custom conversion types, each with a unique ID (e.g.1 = Add to Cart,2 = Newsletter Sign-Up)customConversionValue(Float, optional) — the monetary value of the event (e.g.20.0). Used to calculate ROAS and CPA in your reports
2️⃣ Name your conversion events in Klar
In the left sidebar, go to Store Configurator → Store Settings
Scroll to the Custom Conversions section
Enter the Event ID (1–10) and a Conversion Name (e.g.
Add to Cart)Click Add, then Submit
The name you enter here will appear throughout your Attribution reports, making it easy to differentiate between event types.
3️⃣ Analysing your data
In the Attribution Deep Dive (Tracking → Attribution → Deep Dive), your custom conversions appear with the name you defined. Available metrics include:
Total number of conversions
Conversion value
Cost per action (CPA)
Return on ad spend (ROAS)
Each conversion is attributed to the session in which it occurred. Using KLAR identifiers, we can match conversions down to an ad level for precise attribution.
