The objects we sync from your Meta ad account, the exact fields we read for each, and how they map into Medialake.

Medialake syncs your account's delivery hierarchy (campaigns → ad sets → ads), the creatives and media behind your ads, and their performance metrics — all read-only, via Meta's Marketing API (Graph API v21.0). We only read the fields listed on this page, nothing else.

Objects at a glance

Meta object	What it is	Why we sync it
Ad Account	The container for all your advertising	Captures the hierarchy of metrics and creatives within the ad accounts you give access to
Campaign	Top level of the hierarchy	Captures the hierarchy, so metrics and creatives roll up the same way as in Ads Manager
Ad Set	Targeting, schedule, and budget grouping	Captures the hierarchy, so metrics and creatives roll up the same way as in Ads Manager
Ad	The individual ad	The object metrics relate to — performance is captured per ad
Ad Creative	The visual content specification of an ad	Links each ad to its actual Medialake media file
Ad Videos / Ad Images	Your account's creative media library	Medialake ingests these as files — collecting relevant metadata and ingesting the media via its media URL
Insights	Performance data for each ad	Become Medialake metrics — powering Performance dashboards and reports (see Metrics Reference)

Ad Account

The starting point. We can only see the ad accounts the connecting Facebook user is assigned to — that access boundary, not the selection, is what ultimately limits our reach.

Fields we read:id, name

Campaigns, Ad Sets & Ads

We read the full delivery tree for each synced ad account, preserving the same hierarchy you see in Ads Manager.

Fields we read:id and name at each level (campaign, ad set, ad), plus each ad's link to its creative.

Ad Creatives

The creative tells us what media each ad actually shows — including ads that run on Instagram or reuse organic posts.

Fields we read:id, name, object_type, object_story_id, effective_object_story_id, video_id, image_hash, effective_instagram_media_id, source_instagram_media_id, instagram_permalink_url, thumbnail_url, object_story_spec, asset_feed_spec

These are identifiers and structural metadata only — they let us match an ad to the video or image behind it (one creative can back several ads, e.g. carousels).

Media — Videos & Images

Your ad account's creative library is what becomes files in Medialake: each video and image appears as a browsable asset with a thumbnail, connected to the ads that use it.

Video fields:id, source, title, created_time, updated_time, status, permalink_url, picture, thumbnails, creatives

Image fields:id, status, created_time, updated_time, hash, url, name, permalink_url, creatives

Insights (performance metrics)

Metrics are read per ad at a lifetime level — each sync captures the ad's cumulative performance to date. We're also beginning to capture metrics in daily buckets, building a day-by-day history that will unlock more useful trend insights over time. The full list of metrics and how each maps to Meta's insights fields is in the Metrics Reference.

How it maps into Medialake

Ad Account
 └─ Campaign
     └─ Ad Set
         └─ Ad ──── metrics (per ad, over time)
             └─ Creative
                 └─ Media file (video / image + thumbnail)

Everything on this page is read-only — see Authentication for the permissions behind it.

Meta Ads — Data Mapping