Tracked Links & Analytics

The analytics module answers “which channel actually converted?” — a facebook group, a newsletter, a specific post — by minting a per-source tracked link, redirecting the visitor through it, and rolling up visits vs. paid conversions per source.

The funnel has three hops:

tracked link (?s=<source>) → your landing page (?s= forwarded) → paywall (e.g. HelloAsso)

1. Mint a tracked link

From /analytics in the dashboard, or via the SDK:

import { PlatformApiClient } from '@abeauvois/platform-sdk';

const client = new PlatformApiClient({ baseUrl, sessionToken });
const link = await client.analytics.createLink({
  label: 'Summer Fest',
  targetUrl: 'https://your-event-site.example.com', // your landing page, NOT the paywall directly
});

targetUrl should be your landing page — the page a social-media click should land on — not the payment link itself. The landing page is the one that has the “book now” / “ticketing” call to action linking onward to the paywall.

2. Share a per-source URL

Each channel gets its own share URL built from the link’s slug:

https://<api host>/api/analytics/l/<slug>?s=fb-groupA

s (or the utm_source alias) is whatever label you want for that channel — a facebook group name, newsletter, etc. Every hit records a source-attributed visit, then 302-redirects to targetUrl with the same ?s= appended — the landing page receives the exact source the visitor arrived with.

Why a query param and not the Referer header? Referer is unreliable across a landing page we don’t run infra for: many in-app browsers (Facebook’s especially) strip or rewrite it, it’s governed by whatever Referrer-Policy the landing page’s own host sets, and it’s inconsistent across a redirect chain. A query param is explicit and works on any static host.

3. Forward the source from your landing page

Your landing page needs to read ?s= (or utm_source) from its own URL and pass it along to its outbound paywall link, so the attribution survives that second hop too. A minimal vanilla-JS snippet, dropped once into your page layout, covers every outbound link to a fixed paywall URL:

<script>
  const params = new URLSearchParams(location.search);
  const source = params.get('s') || params.get('utm_source');
  if (source) {
    document.querySelectorAll('a[href^="https://www.helloasso.com"]').forEach((a) => {
      const url = new URL(a.href);
      url.searchParams.set('s', source);
      a.href = url.toString();
    });
  }
</script>

Adjust the selector to match your own paywall’s URL prefix.

4. Read the report

/analytics shows a per-source table — visits, paid, conversion rate, revenue — for a date range and optional link filter (both URL-addressable, so a shared link reproduces the exact view):

const report = await client.analytics.report({ from, to, slug });
// report.sources: Array<{ source, reachedPaywall, paid, paidRate, revenueCents }>

Known limitation: HelloAsso paid events aren’t source-attributed yet

Register your org’s HelloAsso webhook (/api/analytics/webhooks/helloasso/:orgId, shown on /analytics) so completed payments record a paid event. Today that only works with a plain HelloAsso payment link — HelloAsso’s webhook payload doesn’t echo back arbitrary query params, so paid events land in an unattributed bucket regardless of step 3 above. Source-attributed paid requires switching to HelloAsso’s Checkout-Intent API (which sets metadata.source explicitly, and is echoed back) — a larger, separate integration. Until then, this funnel gives you accurate visits per source and landing-page click-through; paid-per-source stays aggregate-only.