Facebook Lead Ads integration

Feature Snapshot

Summary:
The Facebook Lead Ads Integration connects your Facebook Page’s lead ads directly with LeadConduit in real time, automatically capturing leads, validating data, mapping fields, and appending TrustedForm certificates as proof of consumer consent.

Key Benefits:

• Automatically captures and routes Facebook leads as they are submitted.
• Enriches each lead with a TrustedForm certificate that verifies consent and records session details.
• Seamlessly integrates with LeadConduit flows for quick field mapping, validation, and delivery to CRMs or other systems.

Typical Use Cases:

• Connecting your Facebook Page to instantly ingest lead ad submissions into your LeadConduit flow.
• Mapping standard and custom Facebook form fields to LeadConduit fields for consistent data processing.
• Capturing and storing TrustedForm certificates to demonstrate compliance with consent regulations.
• Troubleshooting integration issues and reauthorizing pages when leads fail to appear.

How the Facebook Lead Ads Integration works?

Step‑by‑Step Instructions

1. Access Your Flow Editor:
   Open your LeadConduit flow editor; if you are starting a new flow, click Save first.

2. Add the Facebook Source:
   Click the Add to Flow > Sources button and select the Facebook Lead Ads Inbound Routed integration from the available list.

3. Authenticate & Connect Your Facebook Pages:
   Follow the on-screen prompts to authenticate with Facebook using an account that has full administrative rights (ensuring permissions such as “Manage your ads” and “Access Leads for your pages” are enabled).

4. Select the Desired Facebook Pages:
   From the list provided, choose the Facebook Pages you wish to connect. Note that pages already connected to another flow are marked with a yellow dot.

5. Configure Field Mappings:
   For standard fields, LeadConduit automatically processes the data. For custom fields, submit a test lead using Facebook’s Lead Ads testing tool, locate the custom field data (labeled facebook_field_data_apros) in the Technical Details, and map the Facebook Field IDs to the corresponding LeadConduit fields.

   • For details on how to manage fields in LeadConduit, check these guidelines.

6. Save Your Flow:
   Confirm your settings by clicking Next and then Save your flow, which locks in your configuration choices.

7. Test the Integration:
   Use the Facebook Lead Ads testing tool to send a test lead. Verify that the lead appears correctly in your flow with accurate field mappings and, when applicable, an attached TrustedForm certificate displaying ad details, form appearance, and consent information.

Expected Result:
Leads submitted through Facebook Lead Ads will appear in your LeadConduit flow with correct data mapping and an attached TrustedForm certificate (if applicable), indicating a successful connection and proper capture of consumer consent.

Validation & Monitoring (optional)

• Test the Setup:
  Submit test leads using Facebook’s Lead Ads testing tool to ensure that expected fields (including custom mappings and TrustedForm certificate details) are correctly received and flowing through LeadConduit, and finally, ensure your recipient system is receiving and storing the values as expected.

• Where to Monitor?:
  Check the Events tab in LeadConduit to monitor lead submission activity, review feedback, and confirm that proper data validation and mapping are in place.

Best Practices

• Ensure Correct Facebook Permissions:
  Verify that your Facebook account has full administrative rights along with all required permissions (e.g., “Manage your ads,” “Access Leads for your pages”) to prevent connectivity issues and certificate errors.

• Regularly Submit Test Leads:
  Periodically use Facebook’s testing tool to confirm that both standard and custom field mappings are functioning correctly, and that TrustedForm certificates are generated as expected.

• Reauthorize on Permission Changes:
  If changes occur such as a Facebook password update or role modification, disconnect and reconnect the affected pages in your LeadConduit flow to maintain uninterrupted lead capture.

• Monitor Lead Data Quality:
  Regularly review incoming lead data in the Events tab to ensure that field mappings are accurate and that data is complete, enabling timely adjustments if discrepancies are found.

• Stay Updated on Facebook Integration Requirements:
  Since Facebook’s permissions and integration guidelines may change, routinely confirm that your setup complies with the latest standards and that any new required permissions are granted.

Troubleshooting

Frequently Asked Questions (FAQ)

What is the Facebook Lead Ads integration?

It is an integration that connects your Facebook Page’s lead ads to LeadConduit, enabling real-time lead capture, automated field mapping, and the attachment of TrustedForm certificates to document consumer consent.

Why is this integration important?

This integration streamlines lead capture from Facebook, enhances data quality with automated mapping and validation, and ensures compliance through TrustedForm certificates, ultimately saving time and reducing manual processing.

How do I connect my Facebook Page to LeadConduit?

In your LeadConduit flow editor, click Add to Flow > Sources, select the “Facebook Lead Ads Inbound Routed” integration, authenticate with Facebook using an account with full administrative permissions, select the desired pages, configure field mappings (including custom fields if needed), and save your flow.

What should I do if my Facebook leads aren’t showing up in the flow?

First, verify that your Facebook account permissions are current. If there have been changes (such as a password update or role modification), disconnect and reconnect the affected pages in your LeadConduit flow. Also, confirm that all field mappings are correct.

How are custom Facebook form fields handled?

When custom fields are used in your Facebook lead forms, submit a test lead and review the facebook_field_data_apros JSON in LeadConduit’s Technical Details. Then, map each custom Facebook Field ID to the corresponding LeadConduit field using the inbound field mapping feature.

What permissions are required to Integrate Facebook Lead Ads with LeadConduit?

To connect a Facebook page to LeadConduit, you have to access three different settings interfaces on Facebook, based on how your Facebook leads are managed:

1. Business Manager settings for you (if you have a Facebook Business Manager set up): you must be a full admin with access to the pages and CRMs for the pages, among other permissions.
2. Business Manager settings for the page (if you have a Facebook Business Manager set up).
3. Business Integrations under Settings on your personal Facebook page. Setting permissions here is necessary because you are using your personal credentials to connect LeadConduit to the page that contains your lead ads.

Your Facebook account needs to have, and authorize, “Manage your ads”, “Show a list of the Pages you manage”, “Access Leads for your pages”, “Manage accounts, settings, and webhooks for a Page”, “Create and manage ads for your Page”, “Read content posted on the Page” (formerly all included in “Manage your Pages”).

These permissions ensure that LeadConduit can subscribe to your Lead Ads events, process incoming leads and generate a TrustedForm for Facebook Certificate. Disabling any of these permissions may cause LeadConduit to lose access to your leads, or may cause “Malformed Certificate” errors when attempting to view or retain/claim TrustedForm for Facebook certificates.

When connecting your Facebook account to LeadConduit for the first time, you will be prompted to grant LeadConduit all of these required permissions. The prompts will appear as below:

We recommend you opt in all current and future Pages and Businesses, as this will help mitigate future permissions issues.

How to find my Facebook Form?

Facebook stores your Facebook Form in two different places: the Forms Library and the Business Suite. From those sections, you can also create new forms, download leads, check results, and much more.

• Forms Library:

  1. Log into your Facebook account and go to your Page
  2. On the left, click on Publishing Tools
  3. Select Forms Library from the left side of the screen
  4. You will see a list of the forms and the leads they have collected

• Business Suite:

  1. Log into your Facebook account and go to your Page
  2. Go to Publishing Tools
  3. From there, you will need to go to the “All tools” section
  4. Click on Instant Forms
  5. This will show you all the forms on the page and the leads collected from each form

Which are Facebook’s Standard Form Fields?

LeadConduit handles most Standard Facebook form fields automatically, meaning you can connect your Facebook pages to LeadConduit and start receiving leads immediately.

The two exceptions are: work_email and relationship_status. If you collect either of these fields, use the Custom Field instructions below.

If you collect any of the following fields, you only need to add them to your LeadConduit flow:

• Phone 2 (Work Phone)
• Company Name
• Country
• DOB
• Gender
• Marital Status
• Military
• Platform (Facebook, Instagram, etc.)

What does the Platform Field indicates for the Facebook Lead Ads integration?

This field indicates the platform that sourced the lead. It will return fb for Facebook or ig for Instagram. As the Facebook ecosystem grows expected more possible values of platform will too.

How to map custom Facebook Form Fields?

When one of your Facebook forms includes a Custom Field, there is one extra step you must take to connect the dots between Facebook Field ID and a corresponding LeadConduit Field.

The easiest way to get the Custom Field ID is to submit a test lead after connecting your Facebook page to LeadConduit.

Once you’ve submitted the test lead, find it in LeadConduit, open the Technical Details section, and search for facebook_field_data_apros. For the following example, the Custom Field label is “how many ads do you run in a month?”

"facebook_field_data_apros": "[{\"name\":\"how_many_ads_do_you_run_in_a_month\",\"values\":[\"three\"]},{\"name\":\"email\",\"values\":[\"support@activeprospecct.com\"]},{\"name\":\"full_name\",\"values\":[\"HULK SMASH\"]}]"

Next, you’ll open the flow editor to the Sources step, find the Facebook Lead Ads source, and click the corresponding button under the Field Mappings header.

The left-hand value will be the LeadConduit Field receiving the lead data and the right-hand value will be the custom Facebook Field ID. Using the above facebook_field_data_apros as an example, this Source mapping will capture the value three to the “Ad Type” field for this lead:

Type # and paste the custom Facebook Field ID into the right-hand value field and click the Insert {Field ID} as source field button.

Finally, save your flow and resubmit the lead in LeadConduit. You will now see the custom field with the rest of the lead data.

How To Add Pages In The Facebook Lead Ads Routed Inbound Integration?

First, you will need to open LeadConduit and go to your flow you’re wanting to add the page to. Then, you will need to edit your flow.

Once you’re in your flow editor, you will need to go to the “Sources” step. Since you already have Facebook Lead Ads Routed Inbound connected, you’ll see it listed in your Sources. However, we will need to click the “Add to Flow > Sources” button at the top of the page and add it again.

Adding it again will bring up the page you saw when connecting it for the first time that showed the list of pages your account has access to with checkboxes. You should see the page here and be able to check the box to add it to the flow.

If you don’t see the page, there are a couple of reasons this might happen:

1. Firstly, you will need to make sure your Facebook account has the proper permissions for the page. If your account has the correct permissions, then something else you will need to check exists in the settings of the Facebook account tied to the business manager.

2. Then, you will need to go into the settings of the Facebook profile and scroll down until you see “Business Integrations”. From there, you will see LeadConduit Lead Ads with a button next to it “View and Edit”. Once you click that, there should be sections with your pages and checkboxes next to them. You will need to make sure the page you’re looking for is checked off in each of the sections.

Once both of those are done, you should be able to see the page and connect it to LeadConduit.

Should I route Facebook Leads at the Form or the Ad level?

The Facebook Router RUI only supports Page Level routing. Once a lead is received by a flow, Form and/or Ad level routing can be accomplished using flow rules.

What actions can make my Facebook Page to get disconnected?

LeadConduit will be automatically deauthorized from receiving leads when the individual who connected the Facebook page:

• Changes their password
• Has their access to the page revoked

To reauthenticate, you’ll have to disconnect and then reconnect any affected pages, according to the instructions provided above.

How should I configure the integration if my Business Manager has a customized Leads Access configuration?

If your Business Manager has a customized Leads Access configuration, you will need to grant LeadConduit access in the CRM settings.

1. Go to Business Manager Settings
2. Scroll to the bottom of the page and in the left-hand field list, click Integrations, then click Lead Access
3. Locate your page in the list of pages and click it
4. Click People and confirm that you have Access
5. Click on the CRMs option and select LeadConduit Lead Ads Integration
6. Click Assign Access

More detailed instructions can be found at the Facebook Advertiser Help Center.

Glossary

• facebook-source.png100 KB
• facebook-custom-field.png60 KB