For end users

meta

Pull paid social performance from the Meta Marketing API (Facebook + Instagram) into the ad_metrics table.

Type: inbound. The runner calls fetch.ts directly; the model is not invoked at fetch time.

What it fetches

• Campaign / ad set / ad-level: spend, impressions, clicks, conversions, conversion value.
• Daily granularity. Date range is configurable per run.

What you need

• A Meta Business account with at least one ad account.
• A Meta App in developer mode with the ads_read permission.
• A Meta System User access token with access to the ad account.

See the Meta integration walkthrough for the system-user setup.

Configuration

• META_APP_ID
• META_APP_SECRET
• META_SYSTEM_USER_TOKEN

The CMS Apps surface (/apps/meta) collects these and runs a Test connection.

Where it lives

pectusai/apps/meta/APP.md