Artisan IMG > Facebook (facebook-lead-ads-trigger) (951187aa-383c-49e1-bb3d-79dfb348eb62)
Artisan IMG > Facebook (facebook) (951187aa-383c-49e1-bb3d-79dfb348eb62)
Artisan IMG > Iterable (iterable) (ffb928bd-f458-4135-ae02-20bd93417948)

Export Leads from Facebook to Iterable

Workflow
Revops
Intermediate

This is a 'Workflow' template which means that it is a single standalone workflow.

Some workflow templates can be modified to work with other workflow templates - e.g. to convert a data sync between two services from uni-directional to bi-directional

Overview
Copy

The purpose of this workflow is to capture leads from Facebook Lead Generation Ads and use these to create and update your users in Iterable.

This workflow is fired every time a Facebook Lead Ad form is filled in and submitted:

Prerequisites
Copy

To implement this workflow, you will need the following:

  • API credentials for Facebook Business and Iterable

  • You have a verified developer account for Facebook with the ability to create apps for your business

Getting Live
Copy

Click the Use Template button to deploy the template in your chosen Workspace.

Then take the following steps to configure the workflow and start submitting leads for processing:

The workflow will then start the process of pulling the leads into Iterable.

End Result
Copy

Key workflow steps
Copy

The following diagram gives a simplified breakdown of the key steps in the workflow:


Transform Facebook Form
Copy


The workflow uses the JSON Transformer to dynamically reformat/restructure the Facebook Lead Generation Ad data and map it to a machine-readable format.

Here is how the value email is mapped to the value test@fb.com.

1
{
2
"name": "email",
3
"values": [
4
"test@fb.com"
5
]
6
},
1
{
2
"result": {
3
"email": "test@fb.com"
4
}
5
}

This can then be passed to the Iterable 'Email' column when creating/updating users.


Standardize
Copy


This Object Helpers step transforms the Facebook Lead Generation Ad data into a standard object with fields in the following format:

First Name --> first_name

Last Name --> last_name

Lead Source --> lead_source

etc.

For each lead, we will then have a simple object which can be easily accessed by later Iterable steps using jsonpaths such as $.steps.object-helpers-1.result.first_name:

PLEASE NOTE: When you use the Lead Ads Testing Tool many of the expected fields will return empty. When you create your own Leads Ads Form simply include more relevant values and the workflow will function as expected.


Validate Email
Copy


The lead’s email address is validated for the appropriate user@domain.com format


Create / Update Users
Copy


A search is made for an existing user in Iterable using the lead’s email address as the unique identifier.

If a Iterable user exists, the user record is updated.

A new user record is created if a Iterable user does not exist.