Facebook Lead Ingestion

 

Facebook Lead Ingestion

Overview- Funnel now has the option to receive leads via Facebook Lead Ingestion. Follow the below steps to authenticate the desired Facebook Account.

1. Navigation- Log into Funnel and click on your account. Then select settings from the drop-down menu.

2. Select Facebook- From the options the top of the settings page, select Facebook. Then click Authorize Facebook pages.

3. Log into Facebook- Log into Facebook to authenticate the Facebook page connected to running Advertisements in Funnel. Once logged into Funnel, follow the directions in the Facebook 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)

1. 1. 1. 1. 1. Access to the Facebook page;

            2. Access to the running dynamic ad;

            3. Access to the product catalog used in the running ad;

            4. Access to leads generated from the running ad.

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

•  

1. 1. 1. 1. 1. Access to the Facebook page;

            2. Access to leads generated from the running ad.

4. Setting 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:

1. 1. 1. 1. 1. First Name
            2. Last Name
            3. Email
            4. Phone number

Pre-fill questions: These fields can be selected in Instant Form “Prefill questions” section and don’t require any additional setup.

Other Custom Fields: 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

5. 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 10/27/2022 | Facebook Lead Ingestion