Order Source & UTM Attribution

Edition: CS-Cart & Multi-Vendor · Latest version: 1.0.0 · Compatible with: CS-Cart & Multi-Vendor 4.17.2 – 4.21.x, PHP 7.4 – 8.3 · Changelog: view

Know where every order came from. The add-on saves the source of each new order (UTM tags, ad click IDs, the referring site and the landing page, for the first and the last visit) and shows orders, revenue and average order value by channel, source, medium, campaign and landing page.

Installation · Configuration · Usage · Developer notes · FAQ

Key features

First touch and last touch on every order: source, medium, campaign, term, content, landing page, referrer and the time of the visit.
Ad click IDs recognised automatically: Google Ads (gclid, gbraid, wbraid, dclid), Microsoft Ads (msclkid), Meta (fbclid), TikTok (ttclid), X (twclid), LinkedIn (li_fat_id), Pinterest (epik), Snapchat (sccid), Reddit (rdt_cid) and Yandex (yclid), plus your own parameters (for example ref or aff_id).
Channels without any setup: paid search, paid social, display, organic search, organic social, AI assistants (ChatGPT, Perplexity, Gemini, Copilot, Claude and more), email, SMS and push, affiliates, referral, other campaigns and direct. Orders created in the admin panel are marked “Manual (admin)”, REST API orders “API”.
Order sources report: date range, last or first touch, grouping by channel, source / medium, source, medium, campaign or landing page; drill-down from a channel to its sources; share of revenue; links to the matching orders; CSV export.
Order page panel with both touches, the number of tracked visits, days to order and the customer’s first source.
Source column and filter (channel, source, medium, campaign; last or first touch) in the order list.
Privacy aware: the cookie is set only after consent when Kavio Labs Cookie Consent Mode is active; without consent the source is kept for the current visit only, or not at all.
Full page cache safe (CS-Cart 4.21): the source is read in the shopper’s browser, nothing per visitor is cached.
Multi-Vendor: vendor orders inherit the source of the main order; vendors see the sources and the report of their own orders.
REST API: kv_source_attribution in GET /api/orders/<id>.

Compatibility

CS-Cart and Multi-Vendor 4.17.2 – 4.21.x (tested on 4.17.2 and 4.21.2).
PHP 7.2.5 to 8.3, depending on your CS-Cart version.
Works with every storefront theme: the add-on adds no visible storefront elements.