Meta Ads Field Mapping
Unmapped fields aren’t currently supported. Check the Release Notes for updates.
| API Source Field Name | Displayed Field Name | Type |
|---|---|---|
| Ad Display URL | Ad Creative Url | Text |
| Ad HeadLine | Headline | Text |
| Ad Link Description | Ad Creative Text | Text |
| ad_permalink_url | Unmapped | Text |
| ad_status | Ad Creative Status | Text |
| Account Name | Campaign Advertiser | Text |
| Account ID | Campaign Advertiser ID | Text |
| Campaign Objective | Campaign Method | Text |
| stop_time | Campaign End Date | DateTime |
| Campaign ID | Campaign Id | Text |
| Campaign Name | Campaign Name | Text |
| start_time | Campaign Start Date | DateTime |
| campaign_status | Campaign Status | Text |
| Carousel Ad Body | Ad Creative Text | Text |
| Carousel Ad HeadLine | Headline | Text |
| Carousel Ad Image Hash | Unmapped | Text |
| link_url | Ad Creative Click Url | Text |
| Call To Action Type | Ad Format | Text |
| image_url | Ad Creative Image | Text |
| thumbnail_url | Unmapped | Text |
| Ad ID | Ad Id | Text |
| Ad name | Name | Text |
| Carousel Ad Message | Ad Creative Title Name | Text |
| currency | Currency | Currency |
| date_id | Date Time | DateTime |
| media_buy_finish_time | Media Buy End Date | Date |
| Ad set ID | Media Buy Id | Text |
| Ad set name | Media Buy Name | Text |
| media_buy_begin_time | Media Buy Start Date | Date |
| adset_status | Media Buy Status | Text |
| Strategy Key | Strategy Id | Text |
| Strategy | Strategy Name | Text |
| url_tags | Unmapped | Text |
| Budget (daily) | Booked Cost | Number |
| app_installs + mobile_app_installs | Social App Installs | Number |
| clicks | Clicks | Number |
| comment | Social Post Comments | Number |
| event_responses | Social Event Responses | Number |
| impressions | Impressions | Number |
| link_click | Website Clicks | Number |
| page_likes | Social Page Likes | Number |
| photo_view | Unmapped | Number |
| post | Social Post Shares | Number |
| post_like | Social Post Likes | Number |
| spend | Spend | Number |
| total_actions | Social Post Engagement | Number |
| video_avg_time_watched_actions | Video Average Duration | Number |
| video_p25_watched_actions | Video Completions 25 | Number |
| video_p50_watched_actions | Video Completions 50 | Number |
| video_p75_watched_actions | Video Completions 75 | Number |
| video_p100_watched_actions | Video Fully Played | Number |
| video_plays | Video Plays | Number |
| video_views | Video Views | Number |
Unmapped fields aren’t currently supported. Check the Release Notes for updates.
| API Source Field Name | Displayed Field Name | Type |
|---|---|---|
| Ad Display URL | Ad Creative Url | Text |
| Ad HeadLine | Headline | Text |
| Ad Link Description | Ad Creative Text | Text |
| ad_permalink_url | Unmapped | Text |
| ad_status | Ad Creative Status | Text |
| Account Name | Advertiser Name | Text |
| Account ID | Advertiser Id | Text |
| Campaign Objective | Campaign Method | Text |
| stop_time | Campaign End Date | DateTime |
| Campaign ID | Campaign Id | Text |
| Campaign Name | Name | Text |
| start_time | Campaign Start Date | DateTime |
| campaign_status | Campaign Status | Text |
| Carousel Ad Body | Ad Creative Text | Text |
| Carousel Ad HeadLine | Headline | Text |
| Carousel Ad Image Hash | Unmapped | Text |
| Conversion Tag Category | Conversion Tag Category | Text |
| Conversion Tag Key | Conversion Tag Id | Text |
| Conversion Tag Name | Conversion Tag Name | Text |
| link_url | Ad Creative Click Url | Text |
| Call To Action Type | Ad Format | Text |
| image_url | Ad Creative Image | Text |
| thumbnail_url | Unmapped | Text |
| Ad ID | Ad Id | Text |
| Ad name | Name | Text |
| Carousel Ad Message | Ad Creative Title Name | Text |
| currency | Currency | Currency |
| date_id | Date Time | DateTime |
| media_buy_finish_time | Media Buy End Date | Date |
| Ad set ID | Media Buy Id | Text |
| Ad set name | Media Buy Name | Text |
| media_buy_begin_time | Media Buy Start Date | Date |
| adset_status | Media Buy Status | Text |
| Strategy Key | Ad Strategy Id | Text |
| Strategy | Strategy Name | Text |
| url_tags | Unmapped | Text |
| Post Clicks 1d | Post Click Conversions | Number |
| Post Clicks 28d | Post Clicks 28 days | Number |
| Post Clicks 7d | Post Clicks 7 days | Number |
| Post impressions 28d | Post Impressions 28 days | Number |
| Post impressions 7d | Post Impressions 7 days | Number |
| Total Conversions | Conversions | Number |
| Total Revenue | Revenue | Number |
| Post impressions 1d | Post Impression Conversions | Number |
| Action values 1D click | Post Click Revenue | Number |
| Action values 7D click | Unmapped | Number |
| Action values 28D click | Unmapped | Number |
| Action values 1D View | Post Impression Revenue | Number |
| Action values 7D View | Unmapped | Number |
| Action values 28D View | Unmapped | Number |