Meta Conversions API with TSO
Leads, meetings and deals server-side to Meta, deduplicated with the pixel, plus cost import and leads from Instant Forms. Set up without code.
What is transferred
| Field | Meaning |
|---|
| Event | The conversion under the name you set in the rules, e.g. Lead, Purchase or a CRM stage. |
| Event ID | The same ID as the pixel's, so Meta counts each event once. |
| Value and currency | For payments and won deals. |
| Click ID and Meta cookies | fbc (from the fbclid) and fbp, so Meta can attribute the click. |
| Contact details | Email, phone and name, normalized and hashed with SHA-256. |
| IP address and user agent | Improve matching; can be switched off per destination. |
| Lead ID | For leads from Meta lead forms, with every later conversion of that person. |
Setup
01Connect a Meta loginUnder "Ad accounts" you connect one Meta login for the whole workspace and assign the ad accounts to the project. Campaigns, costs and Meta's own leads and conversions are imported hourly.
02Add URL parameters (recommended)In Ads Manager, at ad level under "Tracking" → "URL parameters", paste the parameters from TSO. Without them TSO attributes Meta clicks through the fbclid and Meta's standard UTM parameters.
03Connect a Meta dataset as destinationThe dataset ID is in Meta Events Manager under "Data sources". TSO sends with the workspace's Meta login or with a Conversions API token from Events Manager.
04Set the rulesDecide which conversions go to Meta under which name. Opt-ins go as "Lead", once per person in 30 days by default; deal created, won and lost go as CRM stages.
05TestIn test mode the events arrive with a test code under "Test events" in Events Manager, not in the dataset. When everything looks right, switch the destination live.
06Extend if you likeLoad the Meta pixel through the TSO script, send page views through the Conversions API too, and link a Facebook page so leads from Instant Forms arrive.
- Conversions API: leads, meetings, deals and payments go server-side to your Meta dataset, page views too if you want.
- Pixel: TSO can load the Meta pixel itself. Pixel and server share the event ID.
- CRM stages: deal created, won and lost go to Meta in CRM format.
- Cost import: campaigns, ad sets, ads, costs and Meta's own numbers arrive in TSO hourly, next to your real leads and revenue.
- Instant Forms: leads from Meta lead forms arrive by webhook and daily sync, and their lead ID goes back with later conversions.
More on the Conversion API and lead forms pages.
Common problems and solutions
| Problem | Solution |
|---|
| The events don't show up in the dataset. | The destination is in test mode. Test events only appear under "Test events" in Events Manager. End test mode. |
| Deal stages don't arrive at Meta. | Give them a name for Meta in the rules. Events Meta doesn't know and that have no Meta name aren't sent. |
| Pixel events are counted twice. | Don't load the pixel through TSO as well if the page already has its own Meta pixel. |
| Costs and leads are no longer imported. | Meta logins expire after about 60 days. Reconnect the login under "Ad accounts". |
| Older conversions don't arrive anymore. | Meta only accepts events from the last 7 days. Deliveries waiting longer can't be made up. |
| Facebook pages for lead forms can't be linked. | Reconnect the Meta login and allow the permissions for pages and leads. |
Frequently asked questions
Do I still need the Meta pixel?+
It isn't required, but useful. Pixel and Conversions API send the same event ID, and Meta counts each event once. If you like, the TSO script loads the pixel itself.
Which events go to Meta?+
The ones you allow in the rules, for example leads, purchases and the CRM stages deal created, won and lost. Page views can go through the Conversions API too.
Does it help optimizing for qualified leads?+
The CRM stages go to Meta in CRM format, as optimizing for qualified leads requires. If a destination has at least one CRM stage, the lead from a Meta lead form goes along as the first stage.
Find out which ads pay off.
Hosted in Germany · Built in Austria