Windsor brings all your Facebook Lead Ads data into Power BI, Looker Studio, Google Sheets, Excel, BigQuery, Snowflake, Tableau, Azure, PostgreSQL, MySQL, Python, Amazon S3, Azure MS SQL

Facebook Lead Ads Field Reference

Sample

The Facebook Lead Ads (facebook_leads) connector pulls Facebook Leads Ads data on a lead level. The supported fields can be found in the table below.

A sample query looks like this:

 

https://connectors.windsor.ai/facebook_leads?api_key=<APIKEY>&date_preset=last_28d&fields=account_name,account_id,campaign,ad_set_name,ad_name,email

And returns data in the following format:

{
"data": [
{
"account_name": "Pied Piper",
"account_id": "1234567898012345",
"campaign": "Facebook_Leads_Campaign",
"ad_set_name": "AdSet_1",
"ad_name": "LeadAd_Acquisition_35",
"email": "peter@piedpiper.com"
}
]
}


Fields

IDTypeNameDescription
account_idTEXTAccount IDThe Page ID of the Facebook Page
account_nameTEXTAccount NameThe Page Name of the Facebook Page
ad_nameTEXTAd NameAd name for the Lead Ad
adset_idTEXTAd Set IDAd Set ID for the Lead Ad
adset_nameTEXTAd Set NameAd Set name for the Lead Ad
campaignTEXTCampaign NameCampaign name for the Lead Ad
campaign_idTEXTCampaign IDCampaign ID for the Lead Ad
created_timeTIMESTAMPCreated TimeTime this object was created
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateThe dimension that determines how date-based data in a chart
date_startDATE(Deprecated) Reporting StartsThe start date for your data. This is controlled by the date range you've selected for your reporting view. Facebook Leads is no longer supports this field so it will always return null
date_stopDATE(Deprecated) Reporting EndsThe end date for your data. This is controlled by the date range you've selected for your reporting view. Facebook Leads is no longer supports this field so it will always return null
day_of_monthTEXTDay of monthDay of the month
emailTEXTEmail
form_idTEXTForm IDForm ID used for the Lead Ads
full_nameTEXTFull Name
idTEXTIDID of the LeadGenInfo object
monthTEXTMonthNumber of the month
sourceTEXTSourceThe name of the Windsor connector returning the row
todayDATETodayToday's date
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20