Skip to main content

Integrating Alia with Meta

Connect your Meta pixel to Alia so popup signups are sent to Meta as Lead conversions from Alia's servers, following your marketing consent setting.

Written by Rob D

The Meta integration reports each popup signup to your Meta pixel as a Lead event. Alia sends the event from its own servers through Meta's Conversions API, so ad blockers and browser privacy settings can't stop it. Meta can then match signups to people who saw your ads, which helps with ad measurement and optimization.

This integration only reports conversions. It doesn't add anyone to a list or a Meta custom audience.

šŸ’” Tip: For more information, see the Meta Business Help Center

Before you begin

  • You need your Meta Pixel ID and a Conversions API access token for that pixel. You create both in Meta Events Manager.

  • Collect an email address or phone number in your popup. Alia sends a Lead only when a visitor submits one of them.

  • Check your marketing consent setting under Settings > Tracking. By default, Alia only sends signups from visitors who allow marketing. See How marketing consent works below.

Get your pixel ID and access token

  1. In Meta Events Manager, select your pixel.

  2. Open the pixel's Settings and copy the Pixel ID.

  3. In the Conversions API section of the same settings, generate an access token and copy it.

šŸ’” Note: Generate the token from the same pixel you connect to Alia. A token from a different pixel is rejected.

Connect Meta to Alia

  1. In Alia, go to Integrations and find Meta.

  2. Select Connect. Connect a Meta pixel opens.

  3. Enter your Pixel ID and Access token.

  4. Optional: enter a Test event code to check that events arrive. See Test your setup below.

  5. Select Connect. Alia checks your pixel ID and token with Meta before saving.

The Meta card now shows Connected to your pixel. Select the card to open the Meta page.

Manage your connected pixels

On the Meta page, each connected pixel has its own card that shows its pixel ID and whether a test event code is set.

  • Select Edit to change the access token or test event code. Leave Access token blank to keep the current token.

  • Select Disable to disconnect the pixel.

  • To add another pixel, select Connect on the Meta page. Each signup is sent to every connected pixel.

You can't change the pixel ID of a connected pixel. To use a different pixel, connect it as another pixel.

What Alia sends to Meta

When a visitor signs up through a popup with an email address or phone number, Alia sends one Lead event to each connected pixel. The event includes:

  • The visitor's email address, phone number, first and last name, and country. Alia hashes these before they leave Alia, so Meta can match them without seeing the original values.

  • A hashed ID for the visitor.

  • The visitor's IP address and browser, which Meta uses for matching.

  • Meta's browser cookies, if the visitor has them, and the click ID from the page address when the visitor arrived from a Meta ad.

  • The page the visitor signed up on, without the query string.

  • The popup name as the content name, and the campaign name as the content category.

Alia sends a Lead only once per visitor for each pixel. If a visitor enters their email on one step and their phone number on the next, Meta gets one Lead.

How marketing consent works

Alia only sends signups to Meta from visitors who allow marketing. This follows the Require consent for marketing setting under Settings > Tracking, which is on by default.

Under How consent is indicated, choose where Alia reads the visitor's choice:

  • Shopify's cookie banner: Alia sends the signup only when the visitor allows both marketing and the sale of their data.

  • Custom code: Your code runs when the visitor signs up. Return true when the visitor allows marketing. Anything else, or no answer within a second, counts as no consent.

To send every signup, turn off Require marketing consent before sending signups to ad platforms. Visitors who don't allow marketing still sign up normally and still go to your email and SMS tools. They just aren't sent to Meta. The banner at the top of the Meta page shows how consent is handled right now. Select Change in settings to open Settings > Tracking.

šŸ’” Note: Keep Require marketing consent before sending signups to ad platforms on unless you're sure you don't need consent for ad tracking where you sell.

Using the Meta Pixel on your site too

Alia can also fire a Lead event through the Meta pixel on your site. This is the Meta Pixel checkbox under Third-party pixels in Settings > Tracking, and it's off by default.

If you use both, Meta counts each signup once. Both events share the same event ID, so Meta removes the duplicate.

Test your setup

  1. In Meta Events Manager, open the Test events tab and copy the test event code.

  2. In Alia, go to Integrations > Meta and select Edit on your pixel.

  3. Paste the code into Test event code and select Save.

  4. Sign up through your popup, or through the popup preview, and watch for the Lead in Test events.

  5. Once events arrive, go back to Edit, clear Test event code, and select Save.

šŸ’” Tip: Signups from the popup preview only reach Meta while a test event code is set. Remove the code when you're done, since Alia sends every event with it for as long as it's set.

Frequently asked questions

Why don't I see a Lead for every signup?

The most common reason is consent. Visitors who haven't allowed marketing aren't sent. Alia also sends only one Lead per visitor for each pixel, and only when the visitor submits an email address or phone number. A form that only collects quiz answers doesn't send a Lead.

My store isn't on Shopify and nothing is being sent. Why?

If How consent is indicated is set to Shopify's cookie banner, Alia can't read the visitor's choice on a store that isn't on Shopify, so nothing is sent. Switch to Custom code, or turn off Require marketing consent before sending signups to ad platforms.

Meta rejected my access token. What should I check?

Make sure you generated the token for the same pixel you entered, from that pixel's Conversions API settings in Events Manager.

Does this add people to a Meta custom audience?

No. Alia sends conversion events only. You can build audiences from those events in Meta.

Will Meta count signups twice if I also use the Meta Pixel checkbox?

No. Both events carry the same event ID, so Meta counts the signup once.

Still have questions?

Start a chat from inside the Alia app, or use the chat in our Help Center.

Did this answer your question?