Attribution
How Smileline records where every lead came from, and where to see it.
By the end of this page you'll know what Smileline records about a lead's origin, how the channel is worked out, and where that information surfaces in the app.
Touches: the capture record
Every time a lead arrives through a website form, a tracked call or a capture endpoint, Smileline records a touch: a snapshot of where that contact came from at that moment. A tracked call carries the caller's web session — the UTMs and click IDs their browser held when the number was assigned — so a phone enquiry attributes like a form one. A touch stores:
- When it was captured and how it arrived (form, webhook, Zapier, lead ad, WhatsApp, SMS, call, chat, manual, import)
- The derived channel (see below) and the source name
- The UTM set: source, medium, campaign, term, content
- The landing URL and referrer domain
- Which capture form (hook) received it, and the affiliate label if the hook carries one
A patient can accumulate several touches — an enquiry from a Google ad in March and another from Instagram in June are both kept. The first touch is treated as the origin; the newest one shows as Last touch when it differs.
Technical match data recorded alongside a touch (IP address, device details,
approximate geolocation, cookie snapshots, consent flags) stays server-side.
It is never shown in the app or returned by list APIs. When a server posts
on the visitor's behalf and forwards their address as client_ip, that is
the IP recorded rather than the posting server's own; see
Direct posting.
Channels on journeys
Each journey also carries a single channel — the origin bucket used to group boards, reports and the dashboard lead flow. Captured leads get it derived from their touch. A lead with no touch — added by hand, created from a chat, or imported without attribution — takes the channel of its patient's Lead source (each entry in Settings → Lead sources belongs to a channel — see Vocabularies).
- Change the patient's lead source (where it isn't fixed by the attribution) and the channel of those leads follows it. Changing a source's channel in Settings → Lead sources only affects leads created afterwards.
- A lead filed under a paid source this way counts as an ad lead from the moment it is created: it starts the follow-ups under New enquiry → Also for ad enquiries, and the AI receptionist calls it when an ad campaign asked it to call new enquiries — except a lead created from a chat, which the AI leaves to whoever created it. Imported history starts neither, and changing the source later doesn't start them again.
- A website form, ad lead form or tracked call that becomes the lead's first touch replaces the inherited channel, and so does a friend's referral recorded by name.
The channel buckets are: paid search, paid social, paid AI, organic search, social, referral (website / friend / practice), existing patient, email, chat, direct, phone, walk-in, print, AI, other and unknown.
How the channel is derived
For captured leads the channel is worked out automatically, in order of confidence:
- Ad click ids — a
gclidmeans paid search, anfbclidmeans paid social, anoppref(OpenAI's ChatGPT Ads click id) means paid AI, and so on for the other platforms' click ids. utm_medium— explicit mediums likecpc,paid-social,paid_aioremailwin over guesses. Acpcorppcmedium from a social platform (utm_source=facebook,instagram,meta,tiktok,linkedin, …) is paid social, not paid search, and aprint,newspaper,magazineorpressmedium is print.- Referrer — a social network referrer becomes social, a search engine becomes organic search, an AI assistant becomes AI. A visit from chatgpt.com with no click id stays AI, not paid AI.
- Otherwise the lead counts as direct — a visit with no campaign parameters and no external referrer.
You don't configure any of this. With the tracking script installed, the visitor's marketing parameters travel with every captured submission automatically. If you post to a capture endpoint from your own code instead, make sure your form forwards the page's query parameters (see Post leads from your own code).
How the lead source is chosen
A new patient created from a website form or a tracked call also gets a Lead source from Settings → Lead sources, chosen from the same signals — you no longer pick one per tracking pool. In order:
- Name match — the
utm_source(or the ad platform behind a click id such asgclidorfbclid) is matched by name against your Lead sources list, within the channel the medium or click id implies:utm_source=googlewithutm_medium=cpcpicks Google Ads, a paidtiktokpicks TikTok Ads, a paidfacebook,instagramormetapicks Facebook / Instagram Ads, and anopprefclick picks ChatGPT Ads (seeded for new practices; an existing practice gets it on its first ChatGPT lead). A bareutm_sourcewith no medium matches across every channel. - Create — a paid-search, paid-social or paid-AI source that matches nothing is added to the list under its own name (a
bingclick becomes Bing); a bareutm_sourcethat matches nothing (sayutm_source=leaflet) becomes a new source on the Other channel. Creation stops at 50 active lead sources; referring websites never create sources. - Channel anchor — organic search, social, email, AI assistants, referring websites, print and phone calls use your first lead source on that channel (Organic search, Social media, Email, AI assistants, Print advertising, Phone call, …). Paid channels never anchor, so an unmatched Bing click is not booked as Google Ads.
- Fallback — anything else (a direct visit with no tags, a submission with no attribution) uses the form's Lead source if the submission has no attribution. A plain direct visit with no form fallback gets Website; a submission with no attribution and no fallback gets none.
A lead from a native lead form is matched as a click on that platform's ad would be — Meta leads get Facebook / Instagram Ads, Google Ads leads Google Ads and TikTok leads TikTok Ads — unless the form's Settings pick another lead source.
A call to a rotating pool number follows the same rules as a form when the caller had a web session, and gets Phone call when they didn't. A call to a static tracking number skips the list above entirely: it is attributed to the one lead source pinned to that number. Sources Smileline creates appear in Settings → Lead sources like any other; they are not logged in the activity log as a user action.
A lead source Smileline chose this way is fixed: it shows on the patient record, in Leads and in Edit patient, but nobody can change it, so the attribution and the source always agree. It stays editable for a patient added by hand, imported, or already on file before their first form, ad lead or tracked call. When the attribution named no source, your team can pick one, and it is fixed once picked.
Where you see attribution
On the lead
Open a lead from the Leads page: the Source group on the lead panel shows Channel, Source, Campaign, Capture form and Captured, plus a Last touch row when a newer touch exists, and the ad they came from when the touch names one. A lead with no touch shows the channel it takes from its lead source.

The ad a lead came from
When a lead's touch names one of the ads in your connected Meta or Google Ads account, an Ad card sits under the source facts on the lead panel, and under the touch in How they found you on the patient record:
- A Meta ad shows its picture, its text and its headline, then the ad's name, its ad set and, for a lead form, Facebook or Instagram.
- A Google search ad shows its web address, headline and description, then the keyword they searched and the ad group. Google mixes a search ad's headlines for each search, so this is the ad's wording, not the exact combination that person saw.
Click the card to open the page they landed on in a new tab. It opens without its tracking parameters, so your visit isn't counted as another click on the ad. A lead from a lead form never left the platform, so its card is not a link.
The card needs two things:
- The ad account connected and syncing, which is included on pay-as-you-go and part of the SEO & Ads add-on on the older price list. Smileline reads each ad's wording and picture after a sync: a new ad is read by the next sync, and an ad edited in place within a week. The card shows the ad as it is now, not as it was the day they clicked.
- Knowing which ad they clicked. Leads from lead forms always say. For ads that send people to your website:
- Meta: in the ad's URL parameters, add
utm_content={{ad.name}}&utm_id={{campaign.id}}, orad_id={{ad.id}}. - Google Ads: nothing to set up. Smileline asks Google which ad each click came from, using the click id Google adds to the link (
gclid). The card usually appears within a couple of hours of the lead arriving; a click made days before they got in touch can take up to two days. Google keeps clicks for 90 days, so a lead whose click is older than that shows no card. To show the card straight away, set the Final URL suffix in your account settings, under Tracking, toadgroupid={adgroupid}&creative={creative}&keyword={keyword}&matchtype={matchtype}.
- Meta: in the ad's URL parameters, add
Smileline shows an ad only when it knows exactly one: two Meta ads with the same name in one campaign show none, and a Meta lead that arrived before its link carried the ad shows none either. Google has no single ad to name for a Performance Max click, or for an iPhone app click that carries no gclid, so those show no card. If Google couldn't be asked yet, the lead says Couldn't get this ad from Google yet; it is tried again every day, and at once when you sync the account. A picture Smileline could not fetch says so when you hover over it, and is retried the same way.
On the patient record
Open the full patient record: the Source group on the profile card lists the whole first touch — channel, source, capture form, captured time, affiliate, landing URL, referrer, every UTM parameter, the ad campaign / ad group / ad / placement / network / keyword / match type / device, every click ID under its own parameter name (gclid, fbclid, msclkid, ttclid, li_fat_id, …, plus pixel IDs such as fbp and fbc), and the GA client and session IDs. When a newer touch exists, the origin and the newest touch sit in separate First touch and Last touch boxes, each headed with its channel and how long ago it arrived. Nothing here is editable; the lead source in the Marketing group above it is, unless Smileline chose it from this attribution.
On a form's deliveries
Settings → Website, open a form and pick a delivery under Deliveries, then switch to Field mapping: the Attribution block above the payload names every marketing parameter that arrived with that submission, its value, and the channel and lead source it produced. When nothing arrived it says so, and points at the fix — attribution is never a mapping problem, it is a question of what the sender forwards.
In reports
Attribution feeds several reports (see Reports):
- Lead sources — channel mix, top sources and how each converts
- Attribution (UTM) — touches by UTM source and campaign, with the journeys, go-aheads and revenue credited to each first touch
- Lead volume and the Conversion funnel — split and stacked by channel
- The dashboard's Conversion by channel card and lead flow graph both start from the channel
Conversion by channel
The dashboard's Conversion by channel card answers the question channels exist to answer: of the leads that arrived in the selected window, how many came from each channel and how many of those booked. Its table puts each channel's leads next to its bookings and adds the share of the whole period, the booking rate, journeys going ahead, treatment revenue, ad spend and the return that spend produced, and every channel opens into the campaigns and sources behind it.
A lead counts in the window it was created in, and its bookings and go-aheads count whenever they happened since — so 50 leads with 10 bookings is 20% however long those bookings took to land.
Each channel row carries a small trend line of its leads over the window. The bar beside Share is the channel's part of all the leads, and the bar beside Booked its part of all the bookings, so a channel whose bookings bar is longer than its leads bar books above its weight. Inside an expanded channel, both bars are parts of that channel's own leads and bookings.
Sent to ads
Once any lead in the window has a Lead event on an ad platform, the table gains a Sent to ads column after Booked %. It says how many of the channel's leads an ad platform received from its own ad — the leads that platform can tie to an ad click and count — for example 57 of 67 for Paid search. A channel whose leads went only to Google with contact details reads 9 contact only, and one with neither reads None received. The bar beside it shows the same split in three shades, explained under the table.
Hover over the cell, or move to it with the keyboard, to see the breakdown: how many each platform received from its own ads (with forms and calls apart), how many Google received with contact details only, and why the rest weren't received — still sending, held or failed, junk, no consent for ads, no usable contact details, calls with no ad click (the platform counts calls from its ads itself), or no Lead event because tracking was off when the lead arrived. A lead carrying two platforms' clicks counts once in the total and under each platform.
The column counts the leads created in the window, like the rest of the table. To compare with a platform, use its own Conversion tracking tab: What each platform received counts events by the day they happened and only for the ad account you selected, so its numbers can differ from this column.
Booked and the ad platforms
Once any booking in the window has a Booked event on an ad platform, a channel's Booked number opens the same kind of breakdown for its bookings. Hover over it, or move to it with the keyboard. It appears even when no lead had a Lead event, and adds no column.
Each booked lead counts once, so the lines add up to Booked:
- From a Google ad (or Meta, TikTok, ChatGPT): the platform received the booking from its own ad and can count it.
- Contact details only: Google received the booking with the patient's contact details but no ad click — for example a booking from a call to your main number.
- Not received, with the reasons: still sending, held or failed, junk, no consent for ads, no usable contact details, or no Booked event because tracking was off or not connected when it was booked.
Only channel rows carry the breakdown; campaign and source rows don't.
Each platform counts only bookings from its own ads, filed on the day of the ad click. So Google's Conversions column for your Booked goal is usually lower than Booked here: contact-only bookings count only when Google matches them to someone who clicked an ad, and a booking from an ad clicked before the window is filed in an earlier period. To compare like for like, read the Booked goal's All conv. (by conv. time) for the same dates (see What each platform received).
Expanding a channel
The arrow beside a channel opens the rows underneath it, each with the same columns as the channel itself. What a row is depends on what the leads carried:
- Paid search, paid social, paid AI and email break down by campaign — the
utm_campaignon the click, or the campaign name from your connected ad account when the click carried its campaign id. - Organic search, social and AI assistants break down by source — the
utm_sourceor the site the visitor arrived from. - Phone, print, walk-ins, referrals and existing patients have no web touch to read, so they break down by the lead source recorded against the patient.
Rows are attributed on the journey's first touch, the same touch its channel came from, so a row and its channel always describe the same visit. A lead with no touch shows under its patient's lead source, and a journey with nothing recorded under Unattributed. Where a channel has more rows than the card lists, the remainder is gathered into Other campaigns — the rows always add up to the channel above them.
Seeing the leads behind a row
Click a channel's name, or a campaign or source under it, to open Patients filtered to exactly those leads: the people whose lead on that channel (and campaign or source) was created in the dashboard's window. The filter shows as a Journey chip, which you can edit or save as a view like any other. Other campaigns and rows with no leads aren't links.
The list counts people, not leads. Someone with two leads in the window appears once, so when the people listed have more leads than there are people, the count under the list adds the lead total — 1–2 of 2 · 3 leads — which matches the row you clicked.
Archived patients are listed too: a lead someone gave up on still counts on the dashboard, so the link adds a Status chip naming every status, archived included. Remove the chip to hide them again.
A campaign row only shows ad spend when its clicks carried the campaign id, or when its utm_campaign matched the name of a campaign in a connected ad account. Spend that could not be matched to a campaign's leads still appears — as its own row, with leads at zero — rather than being dropped.
Return on ad spend
Return is revenue divided by ad spend, shown as a multiple: 4.2× means every £1 spent came back as £4.20. Ad return in the KPI strip does the same sum across every channel that took spend, so spend that produced nothing still counts against it.
When your payments are in Smileline — Smileline is your practice system, or your connected practice system sends its payments — revenue is the money actually taken in the period from patients who came in through that channel, less refunds. Nobody has to record anything. See Revenue on the dashboard.
Otherwise, revenue is each lead's agreed value when it went ahead, else its estimate. When a lead goes ahead without an agreed value, it takes the value of the patient's treatment plan from since they enquired — an open plan your practice system (Dentally) holds, or what they accepted of a Smileline treatment plan — see If they're going ahead. A new enquiry's estimate starts at its treatment's Typical value (Settings → Treatments).
Spend comes from your connected ad accounts — Google Ads lands on paid search, Meta and TikTok on paid social, ChatGPT Ads on paid AI — which is the same rule that puts an ad click's lead in that channel.
Channels Smileline has no cost for — organic search, referrals, phone, walk-ins, print — show a dash rather than a return. Nothing in the app records what those cost you, and a return computed without a cost would be wrong rather than optimistic. A channel that took spend and produced nothing shows 0×, which is a real answer.
Ad spend is read in the ad account's own currency and shown in the practice's, so a practice whose ad accounts bill in a different currency should read the return as indicative.
The lead flow graph
The dashboard's Lead flow card reads left to right, one column per dimension. Columns offers ready-made sets — channel to contacted by to outcome, lead source to outcome, campaign to lead source to outcome, owner to current stage to outcome, treatment to contacted by to outcome — and you can still build your own from two to four columns underneath.
Hover any card and the rest of the graph answers for that card alone: every other column switches to the leads it shares with the one you are pointing at, and the percentage becomes its share of that card rather than of the whole period. Hovering Organic search turns the outcome column into organic search's own outcomes. Click a card to pin it, click the background to release it.

Every report accepts a Channel filter, so any number in the app can be narrowed to, say, paid social only.
Keep attribution clean
- Set each form's Lead source if the submission has no attribution — it's used only when a submission arrives with no marketing parameters, since tagged submissions pick their source from the campaign data.
- Keep the Lead sources vocabulary tidy and each source on the right channel, since manual leads depend on it entirely.
- Use consistent
utm_campaignnames in your ads — the Attribution report groups by the exact string.