Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring Facebook Lead Ads

Updated on August 4, 2022

Facebook Lead Ads provides a mechanism to drive individuals from an anonymous to a known state by running lead generation campaigns on Facebook and Instagram. They include a contact form for individuals that allows them to get in touch with a business. Leads generated with Facebook Lead Ads are captured directly in Pega Customer Decision Hub. For more information about Facebook Lead Ads, see Lead ads.

Pega Customer Decision Hub
To start using Facebook Lead Ads to collect contact information from prospects:
  1. Ensure that your application can both send and receive data from Facebook.
  2. Obtain a Facebook Ads access token with the following permissions:
    • manage_pages
    • leads_retrieval

  3. Request the leads_retrieval and manage_pages permissions for Facebook Ads Lead Retrieval API and submit your app to App Review. These permissions are necessary to retrieve lead information once a lead ID is received from Webhooks.
  4. In the Facebook Ads destination configuration, enter the access token and select Enable Lead Generation. Auto-generated Webhook URL and token appear.
  5. In Facebook Ads, configure the Webhook URL and token, and subscribe to lead generation. For more information, refer to Facebook Ads documentation.
  6. Optional: If you changed the field names in the Facebook lead form, edit the data transform PegaMKT-Data-PaidMedia-LeadAdResponse.FacebookFieldMapping.
  7. Optional: Modify the default activity that saves captured leads to better integrate it with your lead handling process. The name of the activity is PegaMKT-Data-PaidMedia-LeadAdResponse.ProcessProspect.
What to do next: Captured leads are saved in the database table mkt_paidmedia_leads in the Pega Customer Decision Hub database schema. Ensure that expired prospects are removed from the table to prevent it from growing over time.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us