Ad blockers, browser privacy settings and short sessions can stop the Meta Pixel from sending some quiz events. With the Conversions API connected, Lantern's server also sends your quiz completions and leads straight to Meta, so your ads get credit for more of them.
What gets sent
When a shopper finishes a quiz, Lantern's server sends two events to your pixel:
LanternQuizComplete, with the quiz name and the recommended products.
Lead, following the Lead event setting you chose for the quiz.
Each event uses the same event ID as the one the pixel sends from the browser, so Meta counts it once even when both arrive.
To help Meta match the shopper, Lantern includes their email, phone and first name when they gave them, all hashed before they leave our server. It also includes the shopper's IP address, browser and Meta's own browser cookies. Quiz answers are never sent.
When events are sent
Only with consent. Events are sent only when the shopper allowed marketing cookies, the same rule as the pixel. If they opted out of the sale of their data, Meta's Limited Data Use setting is applied.
Only for your store default pixel. The Conversions API connects to the Store default Pixel ID. Quizzes that use the store default, or have the same Pixel ID set, send server events. A quiz with a different Pixel ID of its own doesn't.
Not for previews. Quizzes you preview from the Lantern admin don't send anything.
Before you start
Set up the Meta Pixel in Lantern first and enter your Store default Pixel ID. You can read how in Meta Pixel Integration.
Step 1: Generate an access token in Meta
1.1. Open Meta Events Manager, go to Datasets and select the pixel you use as your store default. Check that its ID matches the Store default in Lantern.
1.2. Go to the Settings tab and scroll down to Conversions API.
1.3. Under Set up direct integration, choose Set up without Dataset Quality API. Lantern doesn't need the Dataset Quality API, and Meta doesn't let you turn it off once it's on.
1.4. Click Generate access token and copy it.
Step 2: Connect it in Lantern
2.1. In Lantern, go to Advanced Analytics and click Setup Meta Pixel.
2.2. Under Conversions API (server events), paste the token into Access token.
2.3. Click Connect. Lantern checks the token with Meta and shows Connected to followed by the Pixel ID when the connection is successful.
2.4. Click Save & Finish Setup.
If Meta doesn't accept the token, you'll see Meta's reason under the field. The most common one is a token generated for a different pixel than your store default.
Step 3: Test it
3.1. In Meta Events Manager, open your pixel and go to the Test events tab.
3.2. Under the Website test, enter your published quiz URL and start the test. Meta will show a test event code for the session.
3.3. Copy the test event code, paste it into Test event code in Lantern, and click Save.
3.2. Paste it into Test event code in Lantern and click Save.
3.4. Take the published quiz on your store, allow marketing cookies, and finish it.
3.5. Return to Test events in Meta. The Lead and LanternQuizComplete events should appear with Received From: Server.
3.6. Clear the test event code in Lantern and click Save when you're done.
Checking that it's working
The Conversions API section shows when events were last sent. If Meta rejects them, for example because the token was revoked, you'll see the error and when it happened. Paste a new token to fix it.
To stop sending server events, click Disconnect.
If you have any questions, contact our support team and we'll be happy to help!