Meta Ads Entities and Fields

The Meta Ads connector works with the following entities, each containing a set of fields — both standard attributes and computed metrics.

Entity Overview

Ad Account (account)

The Meta Ads ad account. The root entity for all other data.

Main fields: id, name, account_id, currency, timezone_name, account_status

Relations: contains campaigns, linked to Facebook pages and Instagram accounts.

Campaign (campaign)

An ad campaign with budget settings and an objective.

Main fields:

• id — unique campaign identifier
• name — campaign name
• objective — objective (CONVERSIONS, REACH, LINK_CLICKS, etc.)
• daily_budget — daily budget (in cents, converted by dividing by 100)
• lifetime_budget — total budget (in cents)
• status — status (ACTIVE, PAUSED, DELETED, ARCHIVED)

Filtering: by campaign.name and campaign.id

Ad Set (adset)

An Ad Set within a campaign with its own budget and targeting settings.

Main fields:

• id — unique identifier
• name — ad set name
• campaign_id — ID of the parent campaign
• daily_budget — daily budget (in cents)
• lifetime_budget — total budget (in cents)
• status — ad set status

Filtering: by adset.name and adset.id

Ad (ad)

An individual ad with creatives.

Main fields:

• id — unique identifier
• name — ad name
• adset_id — ID of the parent ad set
• creative — creative ID
• status — ad status

Creative fields (enrichment):

• thumbnail_url — thumbnail URL
• image_url — full-size image URL
• video_id — video identifier
• body — ad copy
• link_url — destination link
• object_url — object URL
• title — ad title
• media_type — media type: video or image

Filtering: by ad.name and ad.id

Statistics (insights)

Performance metrics retrieved via the Graph API /insights endpoint.

Main fields:

• date_start, date_stop — statistics period
• All metrics are combined into a single request as a comma-separated list

Default period: last_30d (available: today, yesterday, last_7d, last_30d)

Facebook Page (page)

A Facebook Page linked to the user.

Main fields: id, name, category, access_token

Relation: can be linked to an Instagram Business Account.

Instagram Account (instagram_account)

An Instagram account linked to a Facebook Page.

Main fields:

• account_id — Instagram account ID
• name — display name
• username — Instagram username
• page_id — ID of the linked Facebook Page
• page_name — name of the linked page
• page_access_token — page access token

Data Fields

Key	Name	Type	Entity	Filterable	Sortable
campaign_name	Campaign name	string	campaign	Yes	Yes
campaign_id	Campaign ID	string	campaign	Yes	No
adset_name	Ad set name	string	adset	Yes	Yes
adset_id	Ad set ID	string	adset	Yes	No
ad_name	Ad name	string	ad	Yes	Yes
ad_id	Ad ID	string	ad	Yes	No
account_id	Account ID	string	account	Yes	No
account_name	Account name	string	account	Yes	Yes
date	Date	date	insights	Yes	Yes
objective	Objective	string	campaign	Yes	No
campaign_budget	Campaign budget	currency	campaign	Yes	Yes
adset_budget	Ad set budget	currency	adset	Yes	Yes
thumbnail_url	Thumbnail	url	ad	No	No
body	Ad copy	string	ad	No	No
link	Link	url	ad	No	No
download_url	Creative URL	url	ad	No	No
video_id	Video ID	string	ad	No	No
media_type	Media type	string	ad	Yes	No
spend	Spend	currency	insights	Yes	Yes
impressions	Impressions	number	insights	Yes	Yes
clicks	Clicks	number	insights	Yes	Yes
ctr	CTR	percent	insights	Yes	Yes
cpc	CPC	currency	insights	Yes	Yes
cpm	CPM	currency	insights	Yes	Yes
reach	Reach	number	insights	Yes	Yes
frequency	Frequency	number	insights	Yes	Yes

Working with Fields: Nuances

Budget Fields

The daily_budget and lifetime_budget fields come from the Meta API in cents. LightLead automatically converts them to real currency by dividing by 100:

campaign_budget = daily_budget / 100

Creative Fields

Creative fields (thumbnail_url, body, link, download_url, video_id) are enriched via a separate API request. If enrichment fails, the main data is preserved, but creative fields may be missing — see Limitations.

Date Fields

The date field in statistics uses the YYYY-MM-DD format. The period is defined via date_start and date_stop. The last_30d range is used by default.

Related Pages

• Metrics
• Request Parameters
• Filters
• Date and Time