Conversion tracking

Did the click do the thing?

Clicks tell you traffic arrived. A conversion is a later event that you fire from your own site or server, such as a sign-up, a purchase, or a download. ShortZen attributes it to the last non-bot click for that visitor inside your attribution window.

Pixel and API

Two doors. The pixel counts conversions from a page: add the snippet below to every page of your site, then call szConversion on the thank-you page. POST /api/v1/conversions, with a key that holds conversions:write, also takes the value and currency: revenue goes through the API only, because a pixel on a public page can be called by anyone.

<script>
(function (w, d) {
  var k = 'sz_vid', q = new URLSearchParams(location.search), v = q.get(k);
  if (v) {
    d.cookie = k + '=' + encodeURIComponent(v) + '; Max-Age=2592000; Path=/; SameSite=Lax; Secure';
    q.delete(k);
    var rest = q.toString();
    history.replaceState(null, '', location.pathname + (rest ? '?' + rest : '') + location.hash);
  }
  w.szConversion = function (goal, eventId) {
    var m = d.cookie.match(/(?:^|; )sz_vid=([^;]*)/), i = new Image();
    i.referrerPolicy = 'no-referrer';
    i.src = 'https://YOUR_APP_HOST/t?lid=lnk_YOUR_LINK&goal=' + encodeURIComponent(goal)
      + (m ? '&v=' + m[1] : '')
      + (eventId ? '&eid=' + encodeURIComponent(eventId) : '');
  };
})(window, document);
</script>

<!-- On the thank-you page -->
<script>szConversion('signup', 'ORDER_OR_SIGNUP_ID');</script>

When conversion tracking is on the plan, the redirect adds an opaque sz_vid token to the destination address. The snippet keeps it in a first-party cookie on your own site for 30 days and takes it off the address bar, so a visitor who signs up pages or days later is still recognised. Pass your order or sign-up id as the second argument: a reload of the same page then records once. Without one, each page load counts.

Attribution window

Last non-bot click for that visitor hash, on any of this workspace's links, at or before the conversion, inside 1, 7, or 28 days. The window is set next to the Audience analytics toggle. Unattributed events are kept; they just have no click id.

Check and correct events

View events on the Conversions panel lists every conversion behind the figures, for the dates and filters on screen: when it happened, its goal and value, the link it was credited to, whether a click was found, and whether the pixel or the API sent it. Export CSV downloads the same rows, up to 10,000 at a time. Owners and admins can delete a test or mistaken event; every figure updates at once, webhook endpoints receive conversion.deleted, and the audit log keeps the event so it can be sent again.

Plans

Conversion tracking is available from Business. The pixel and the API both refuse to record on a plan that does not include it. The pixel image still loads so a missing plan does not break the page.