All articles
Conversion TrackingMeta CAPITikTok CAPILead GenerationProduct Updates

Granular Button Mapping and Advanced Matching: Precision CAPI Tracking

July 8, 20265 min read
Granular Button Mapping and Advanced Matching: Precision CAPI Tracking

Most conversion tracking is blunt. You wire up a pixel, fire one event when the form is submitted, and hope the ad platform figures out the rest. But a real lead funnel has more than one meaningful moment, and treating every submission the same way throws away the signal that actually lowers your cost per lead.

Two features in Collectform fix that: granular button mapping and advanced matching field mapping. Together they let you send the right conversion event, for the right action, with the match quality that Meta and TikTok reward. Both build on the server-side CAPI we shipped in V2.

The problem with one-event-per-form tracking

Imagine a qualification funnel. Some respondents book a call. Some request a quote. Some just download a guide. If all three fire the same Lead event on submission, your ad platform can't tell a booked call apart from a guide download, so it optimizes toward the cheapest, lowest-intent action, not the one that grows your business.

And even when you do fire the right event, it's only as useful as the data attached to it. If Meta or TikTok can't match your conversion back to a real person who saw your ad, the event barely counts. That's where these two features come in.

Granular button mapping: the right event for the right action

Mapping a Meta and TikTok CAPI conversion event to a specific button in a Collectform funnel

Granular button mapping lets you fire a specific conversion event when a specific button in your funnel is clicked, instead of one generic event for the whole form.

Because every Collectform funnel is a conversational, one-question-at-a-time experience, each step has its own button. Now you can map any of those buttons to its own Meta or TikTok event:

  • The button on your qualified-lead step fires Lead
  • Your "Book a call" step fires Schedule
  • Your pricing or checkout step fires InitiateCheckout or Purchase
  • A newsletter step fires a custom event like NewsletterSignup

You choose from the full set of Meta standard events (Lead, Contact, CompleteRegistration, SubmitApplication, Schedule, Subscribe, StartTrial, Purchase, and more), their TikTok equivalents, or any custom event you name. Each event can carry its own value and currency, so a booked demo can be worth more to your optimizer than a top-of-funnel download.

The result: Meta and TikTok stop guessing. They learn which clicks lead to revenue and bid toward the people most likely to take that exact action.

Advanced matching field mapping: better match quality, lower CPL

Mapping form fields to Meta and TikTok advanced matching parameters in Collectform

Firing the right event is half the job. The other half is making sure the ad platform can match that event back to a real user. That's what advanced matching field mapping does.

You map the fields your respondents already fill in to the matching parameters Meta and TikTok use for attribution:

  • Email and phone — the strongest signals
  • First name, last name, city, state, zip, country
  • Date of birth, gender, and external ID

Every value is hashed with SHA-256 before it leaves the server, so you improve attribution without ever sending raw personal data to the ad platform. Meta supports the full range of parameters; TikTok matches on email, phone, and external ID. On top of the fields you map, Collectform automatically forwards the signals that boost match quality, the _fbp / _fbc and _ttp / ttclid cookies plus the IP address and user agent, so your events arrive with the richest possible match set.

Higher match quality means more of your conversions are attributed, which means the optimizer has cleaner data and your cost per lead drops.

Better together

The two features compound. Granular button mapping tells the platform what happened; advanced matching tells it who it happened to. A Schedule event on your "Book a call" step, enriched with a hashed email and phone, is a precise, high-value, well-matched signal, exactly the kind Meta and TikTok optimize hardest around.

And it all stays honest:

  • Deduplicated by default. Every server-side event shares an event ID with its browser pixel counterpart, so the pair is counted once, never double.
  • Consent-aware. Both the pixel and the CAPI events are gated behind GDPR-ready one-click cookie consent. Nothing marketing-related fires until the visitor opts in.
  • Server-side reliable. Because CAPI sends events directly from Collectform, iOS privacy changes, ad blockers, and cookie restrictions can't quietly delete your conversions.

How to set it up

  1. Connect Meta CAPI or TikTok CAPI in your funnel's Integrations tab with your pixel or dataset ID and access token.
  2. Add a conversion event and choose when it fires: on form view, on form start, on submission, or on button click.
  3. For an on button click event, pick the exact step in your funnel whose button should fire it, then choose the event to send.
  4. Map your fields to advanced matching parameters under customer information — email, phone, name, and the rest.
  5. Publish. Events fire server-side, deduplicate against your pixel, and show up in Meta or TikTok Events Manager.

Precision is the point

Generic tracking gives your ad platform a foggy picture and asks it to optimize anyway. Granular button mapping and advanced matching field mapping hand it a sharp one: the exact action that matters, tied to a real, matchable person, sent reliably from the server, and deduplicated against your pixel.

That's how conversion tracking actually lowers your cost per lead.

Both features are included on every paid plan. Explore templates or start building with Collectform.

Frequently asked questions

What is granular button mapping?

Granular button mapping lets you fire a specific Meta or TikTok conversion event when a specific button in your funnel is clicked, instead of sending one generic event for the whole form. For example, the button on your qualified-lead step can fire a Lead event while your 'Book a call' step fires Schedule, so each meaningful action is tracked as its own conversion.

What is advanced matching field mapping?

Advanced matching field mapping connects the fields your respondents fill in, like email, phone, first name, last name, city, and more, to the matching parameters Meta and TikTok use to attribute conversions. The values are hashed with SHA-256 before they are sent server-side, which improves match quality and lowers your cost per lead without exposing raw personal data.

Do these features work with both Meta and TikTok?

Yes. Both granular button mapping and advanced matching field mapping work with Meta Conversions API and TikTok Events API. Meta supports the full range of matching parameters (email, phone, name, city, state, zip, country, date of birth, gender, and external ID), while TikTok matches on email, phone, and external ID. You can map each connection independently.

Will granular button events be double-counted against my pixel?

No. Every server-side CAPI event shares an event ID with its browser pixel counterpart, so Meta and TikTok deduplicate the pair and count it once. You get the reliability of server-side tracking and the coverage of the browser pixel without inflating your numbers.

Are these conversion events consent-aware?

Yes. Both the browser pixel and the server-side CAPI events are gated behind Collectform's GDPR-ready one-click cookie consent. Nothing marketing-related fires until the visitor accepts, so you stay compliant by default.

Ready to capture more leads?

Build high-converting forms with server-side CAPI built in — so your pixel never goes blind. Live in minutes.

Start your 7-day free trial

7-day free trial - No credit card - Cancel anytime