Conversion tracking require a Business plan subscription or higher.
CodeQR Conversions is a powerful tool that lets you turn any short link you create on CodeQR into a full attribution engine. This allows you to understand how well your links are translating to actual users and revenue dollars.
Conversion analytics
In this guide, we’ll walk you through the steps to get started with CodeQR Conversions:
  1. Enable conversion tracking for your links
  2. Install the @codeqr/analytics client-side SDK
  3. Install the CodeQR server-side SDK + track conversion events
  4. View your conversions
First, you’ll need to enable conversion tracking for your CodeQR links to be able to start tracking conversions. There are a few ways to do this:

​
Step 2: Install the @codeqr/analytics client-side SDK

Next, you’ll need to install the @codeqr/analytics client-side SDK. This script detects the cq_id query parameter and storing it as a first-party cookie, which will be used to attribute subsequent conversion events to the original link.
A diagram showing how click events are tracked in the conversion funnel
You can install the @codeqr/analytics script in several different ways:

React

Add CodeQR Analytics to your React app

Manual installation

Add CodeQR Analytics to your website

Framer

Add CodeQR Analytics to your Framer site

Shopify

Add CodeQR Analytics to your Shopify store

WordPress

Add CodeQR Analytics to your WP site

Webflow

Add CodeQR Analytics to your Webflow site
You can verify the installation with the following tests:
  1. Open the browser console and type in _codeqrAnalytics – if the script is installed correctly, you should see the _codeqrAnalytics object in the console.
  2. Add the ?cq_id=test query parameter to your website URL and make sure that the cq_id cookie is being set in your browser.
If both of these checks pass, the script is installed correctly. Otherwise, please make sure:
  • The analytics script was added to the <head> section of the page
  • If you’re using a content delivery network (CDN), make sure to purge any cached content

​
Step 3: Install the CodeQR server-side SDK + track conversion events

If you are using Shopify, you can skip this step since our Shopify app will automatically track conversions for you. Read the Shopify integration guide for more information.
CodeQR uses server-side event tracking to track conversions, which is more reliable than client-side tracking. Depending on which framework you’re using, you can use our native SDKs:

TypeScript

TypeScript library for the CodeQR API
If you’re using a framework that isn’t listed, you can use the CodeQR REST API to track events on the server-side: Once you install the SDKs, you can start tracking conversion events.

​
Tracking lead events

The first event you’ll want to track is a lead event. This happens when a user performs an action that indicates interest in your product or service. This could be anything from:
  • Signing up for an account
  • Adding a product to cart
  • Joining a mailing list
A diagram showing how lead events are tracked in the conversion funnel
Our most common lead event is Sign Up, which happens when a user signs up for an account. Depending on which authentication framework you’re using, here are a few examples of how to send Sign Up lead events:

Clerk

NextAuth.js

Supabase

Auth0

Appwrite

The lead event will serve as the source of truth for the customer’s identity and which link they came from. This means that all subsequent actions performed by the customer (e.g. upgrading their plan, purchasing a product) will automatically be attributed to the original link. To learn more about tracking lead events with CodeQR, refer to the following resources:

Tracking lead events

Read the full guide on tracking lead events with CodeQR

POST /track/lead endpoint

View the full list of attributes you can pass when sending a lead event

​
Tracking sale events

The second event you’ll want to send is a sale event. This happens when a user purchases your product or service. This could be anything from:
  • Subscribing to a paid plan
  • Usage expansion (upgrading from one plan to another)
  • Purchasing a product
A diagram showing how sale events are tracked in the conversion funnel
Depending on which payment processor you’re using, we offer native integrations for the following:

Stripe

Shopify

Alternatively, you can also send sale events manually using our SDKs or the POST /track/sale API endpoint. To learn more about tracking sale events with CodeQR, refer to the following resources:

Tracking sale events

Read the full guide on tracking sale events with CodeQR

POST /track/sale endpoint

View the full list of attributes you can pass when sending a sale event

​
Step 4: View your conversions

Once you’ve enabled conversion tracking for your links, all your tracked conversions will show up on your Analytics dashboard. We provide 3 different views to help you understand your conversions:
Time-series line chart
  • Funnel chart: A funnel chart view visualizing the conversion & dropoff rates across the different steps in the conversion funnel (clicks → leads → sales).
Funnel chart view showing the conversion & dropoff rates from clicks → leads → sales
  • Real-time events stream: A real-time events stream of every single conversion event that occurs across all your links in your workspace.
The Events Stream dashboard on CodeQR

​
Example Apps

CodeQR Conversions Demo App

See the full example on GitHub.