Facebook Lead Ingestion

Facebook Lead Ingestion

Funnel now has the option to receive leads via Facebook Lead Ingestion. Follow the below steps to authenticate the desired Facebook Account. Click here to access a word version of the job aid.  

How to Receive Facebook Ad Leads in Funnel

1. Authenticate the Facebook Page connected to running Advertisements in Funnel. Once logged into Funnel, follow the directions in this section within your Funnel account.  

• The Facebook Page can be authorized in Funnel on the settings page. The Facebook user who authorizes in Funnel needs to have ADMIN access on the Facebook Page connected to running advertisements. Without this the subscription will not work. 
• Facebook access required for leads ingestion: In order to receive all the necessary information from Facebook, authenticated Facebook user should have a read access to some Facebook content used in running ads depending on the chosen community tracking approach:

• • Product catalog approach (dynamic ad connected to a product catalog item with community_id in this item)

• • • • Access to the Facebook page;
      • Access to the running dynamic ad;
      • Access to the product catalog used in the running ad;
      • Access to leads generated from the running ad.

• • Tracking parameter approach (community_id field provided in ad form tracking parameters)

• • • • • Access to the Facebook page;
        • Access to leads generated from the running ad.

2.  Set correct format of Ad Instant Form fields

• Default configuration: Funnel can automatically process following fields available in Facebook’s Ad Instant Form “Prefill questions” list:

• • First Name
  • Last Name
  • Email
  • Phone number

• These fields can be selected in Instant Form “Prefill questions” section and don’t require any additional setup.
• Also, Funnel supports such custom fields as:
  • Move-in Date
  • Prospect Message

• Fields customization: If you want to customize your field names, but still want to be parsed by Funnel, you can adjust your Instant Form settings by editing Field names tab:

• In the example above, the field “My Custom Question To Prospect” would be treated as Prospect Message by Funnel.
• In order to correctly parse the ad lead, its fields should follow the naming convention from the table below:

Field name format in Field names settings tab	Field Description
first_name	First Name
last_name	Last Name
email	Email
phone_number	Phone number
move_in_date	Move-in Date
prospect_message	Prospect message

3. Set tracking parameters

• via User Interface

• • • In order to assign prospect from received lead to the correct community you can set tracking parameter community_id in the Instant Form settings:
• via Facebook Graph API
  • Instant Forms can also be created in a programmatic way by using Facebook’s graph API.
  • Leadgen Form can be dynamically created via submitting a POST request to the /{page_id}/leadgen_forms endpoint.        
  • POST https://graph.facebook.com/v9.0/{page_id}/leadgen_forms request example payload with tracking_parameter:

{

  "tracking_parameters": {

        "community_id": 40

  },

  "name": "example_name",

  "questions": [

        {

          "key": "prospect_message",

          "label": "Prospect Message",

          "type": "CUSTOM"

        }

  ],

  "privacy_policy": {

        "url": "example.com",

        "link_text": "privacy policy link"

  },

  "follow_up_action_url": "http://example.com"

}

Revised 12.12.2021 | Facebook Lead Ingestion