Guides / Connect Meta
Three values from Events Manager, pasted once. Then a live test that proves events are landing — before any real lead depends on it.
⏱ About 5 minutesIn Meta Events Manager → Data sources, pick the dataset (pixel) this client's ads use. No dataset yet? Connect data → Web, name it after the client, and skip the website-code steps — we deliver events server-side.
Copy the Dataset ID (a long number, shown under the dataset name and in Settings).
Open the dataset's Settings tab and scroll to Conversions API. Under "Set up direct integration", click Generate access token. Copy it — this token can send events to this dataset and nothing else, which is exactly the least privilege you want.
Treat it like a password: paste it straight into the app's Connect Meta form and nowhere else — not documents, not chat threads, not tickets.
On the dataset's Test events tab, copy the code that looks like TEST12345. With it in place, the app fires a ConnectionTest event the moment you connect — visible in that tab within seconds.
Open the location in Pipeline Signals → Connect Meta → paste Dataset ID, token, and test code → save. The app validates against Meta before storing anything, so a bad paste fails loudly here instead of silently later.
Verify: keep the Test events tab open while connecting. It's a live feed — it only shows events that arrive while the tab is open, which is the single most common "nothing is showing up" confusion. Your ConnectionTest should appear within ~10 seconds.
Remove the test code before going live. While a test event code is saved, events go to the Test events tab instead of powering ads. Once mapping tests look right, edit the connection and clear the code.
How match quality works: every event we send carries the strongest keys available for that contact, in Meta's priority order — Lead ID (from Lead Ads), then browser click data (fbc), then hashed email and phone. The event log in your dashboard shows exactly which keys each event used.
Pipeline Signals · dedup, retries, expiry windows and consent flags handled automatically