Track ad campaign trends with graph reports

Pull time-series ad campaign data to track performance trends over time. Use the data to visualize day-by-day metrics and identify patterns in ad campaign activity.

Use cases

Tracking ad campaign trends manually across weeks or months wastes hours. Graph reports give you time-series data ready to visualize instantly.

Track campaign momentum

Visualize daily campaign performance to spot trends and optimize in real-time

Identify peak performance

Compare ad performance across date ranges to understand when campaigns perform best

Monitor spend efficiency

Track cost-per-click and conversion trends over time to optimize budget allocation

Before you start

Prerequisites:

API Key - Your authentication token - Get your API key from the API Quickstart.
Brand ID - Your brand’s unique ID
Connected Ad Accounts - Meta Ads and/or TikTok Ads accounts connected in Dash Social

Supported platforms:

Meta Ads
TikTok Ads

Connect ad accounts first: Report on ad accounts connected in Dash Social only. Connect your ad accounts in Dash Social → Settings → Ad Account Management before using this API.

Test in the dashboard first

Preview ad campaign graph reports in the Dash Social Dashboard to understand the data structure before pulling via API.

Implementation

Step 1: Get ad account IDs

Get the ad account IDs for your connected advertising accounts. Each platform has a different endpoint.

For Meta Ads

Send a GET request:

GET https://facebook.dashsocial.com/brands/{brand_id}/ad_accounts

Replace {brand_id} with your brand ID (e.g., 144).

For TikTok Ads

Send a GET request:

GET https://tiktok.dashsocial.com/marketing/brands/{brand_id}/ad_accounts

Replace {brand_id} with your brand ID (e.g., 144). Sample response (both platforms):

[
    {
        "id": "1368643043296927",
        "name": "Demo Ad Account",
        "status": "ACTIVE"
    }
]

Collect each ad account id value. You’ll use these in Step 2.

Compare across platforms

To compare multiple platforms, call both endpoints separately to get ad account IDs for Meta and TikTok.

Step 2: Get ad campaigns

Retrieve the ad campaigns under each ad account. Each platform has a different endpoint.

For Meta Ads

Send a PUT request:

PUT https://facebook.dashsocial.com/brands/marketing_v2/campaigns
body = {
  "ad_account_ids": ["1368643043296927"],
  "brand_ids": [144]
}

For TikTok Ads

Send a PUT request:

PUT https://tiktok.dashsocial.com/marketing/ad_campaigns
body = {
  "brand_ids": [144],
  "source_ad_account_ids": ["7113956961980284930"]
}

Sample response (both platforms):

[
    {
        "brand_ids": [2000],
        "id": 9226231,
        "name": "Ad Campaign 1 GBP",
        "source_ad_account_id": "demo_ag10808192",
        "source_campaign_id": "demo1_3112",
        "source_created_time": "2024-01-09T10:00:00+00:00",
        "source_updated_time": null,
        "status": "PAUSED"
    }
]

Collect each source_ad_account_id and source_campaign_id value. Format as comma-separated values for the report API:

Ad account IDs: 1368643043296927,7113956961980284930
Campaign IDs: 120236587787680490,120236587787680491

Step 3: Map your report parameters

Map the available parameters before making the API call:

Parameter	Description
`brand_ids`	Your brand ID.
`channels`	Ad platform to report on: Meta Ads: `META_ADS` TikTok Ads: `TIKTOK_ADS` Only one channel can be specified per request.
`metrics`	Metric to track over time. See Metrics section below for all options.Request multiple metrics by separating with commas (e.g., `LINK_CLICKS,IMPRESSIONS,SPEND`)
`source_ad_account_ids`	Comma-separated ad account IDs from Step 1: `1368643043296927,7113956961980284930`
`source_campaign_ids`	Comma-separated campaign IDs from Step 2: `120236587787680490,120236587787680491`
`start_date` / `end_date`	Reporting period in `YYYY-MM-DD` format. The graph report returns daily data points for each date in this range.
`context_start_date` / `context_end_date`	Comparison date range for period-over-period analysis. Use same dates as `start_date` / `end_date` if no comparison needed
`report_type`	Set to `ADS_GRAPH` for time-series data
`time_scale`	Time granularity for data aggregation: `DAILY` - Daily data points (default) `MONTHLY` - Monthly data points Optional. Defaults to `DAILY` if not specified.

Step 4: Request the graph report

Send a GET request using the parameters from Step 3. This example gets daily link clicks for Meta Ads campaigns during August 2025:

GET https://dashboard.dashsocial.com/reports/data?channels=META_ADS&
		start_date=2025-08-10&
		end_date=2025-08-20&
		metrics=LINK_CLICKS&
		brand_ids=144&
		report_type=ADS_GRAPH&
		context_start_date=2024-07-01&
		context_end_date=2024-07-31&
		source_ad_account_ids=1368643043296927&
		source_campaign_ids=120236587787680490

Compare multiple platforms

Make separate requests for each channel: META_ADS, TIKTOK_ADS. Combine results in your dashboard or analytics tool.

Sample response:

{
    "data": {
        "120236587787680490": {
            "META_ADS": {
                "LINK_CLICKS": {
                    "2025-08-10": 120.0,
                    "2025-08-11": 145.0,
                    "2025-08-12": 132.0,
                    "2025-08-13": 158.0,
                    "2025-08-14": 167.0,
                    "2025-08-15": 189.0,
                    "2025-08-16": 201.0,
                    "2025-08-17": 178.0,
                    "2025-08-18": 194.0,
                    "2025-08-19": 156.0,
                    "2025-08-20": 143.0
                }
            },
            "campaign_name": "Summer Sale Campaign",
            "data_type": "CAMPAIGN",
            "metrics": {
                "LINK_CLICKS": {
                    "META_ADS": {
                        "2025-08-10": 120.0,
                        "2025-08-11": 145.0,
                        "2025-08-12": 132.0,
                        "2025-08-13": 158.0,
                        "2025-08-14": 167.0,
                        "2025-08-15": 189.0,
                        "2025-08-16": 201.0,
                        "2025-08-17": 178.0,
                        "2025-08-18": 194.0,
                        "2025-08-19": 156.0,
                        "2025-08-20": 143.0
                    }
                }
            },
            "source_ad_account_id": "1368643043296927",
            "source_campaign_id": "120236587787680490",
            "user_has_access": true
        }
    },
    "product_category": "ADS"
}

Step 5: Interpret the response

The response includes time-series data for each ad campaign.

Response structure

Each campaign includes:

data_type: CAMPAIGN
campaign_name: Name of the ad campaign
source_ad_account_id: Ad account ID
source_campaign_id: Campaign ID
Date-keyed metrics: Each metric is organized by date (e.g., "2025-08-10": 120.0). This makes it easy to plot on line charts or trend graphs.

Example insights

From the sample response:

Summer Sale Campaign had peak performance on August 16 with 201 link clicks
Performance showed an upward trend from August 10-16
Click volume decreased in the final days of the period (August 17-20)

Common errors:

Invalid channel name - Use META_ADS or TIKTOK_ADS. Only one channel per request.
Invalid ad account or campaign ID - Verify IDs match the responses from Steps 1-2.
Missing context dates - Include context_start_date and context_end_date for trend analysis.
Sparse data - Some dates may have null values if the campaign was paused or had no activity.

Metrics

Meta Ads
TikTok Ads

Metric Name	Description	Metric API Name
Adds to Cart - Ads	The number of add-to-cart events attributed to your selected ads, counted once across website and app Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`ADDS_TO_CART`
App Installs - Ads	The number of app installs attributed to your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`APP_INSTALLS`
Checkouts Initiated - Ads	The number of checkouts started that are attributed to your selected ads, counted once across website and app Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`CHECKOUTS_INITIATED`
Clicks (All) - Ads	The total number of times the ads in your selected campaign were clicked during the Reporting Period Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`CLICKS`
CTR - Ads	The percentage of times people clicked your ads after seeing them during the Reporting Period. CTR = Total Clicks / Impressions Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`CLICK_THROUGH_RATE`
Content Views - Ads	The number of content views attributed to your selected ads, counted once across website and app Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`CONTENT_VIEWS`
Conversion Rate - Ads	The percentage of people who saw the ad and performed the desired action Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`CONVERSION_RATE`
Cost per 1,000 People Reached - Ads	The average cost to reach 1,000 people with your selected ads. Counts people, not actions, so it can’t be summed: Meta de-duplicates it for the report’s scope when the report loads. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_1000_PEOPLE_REACHED`
Cost per 3-Second Video Play - Ads	The average cost per 3-second video play on your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_3_SECOND_VIDEO_PLAY`
Cost per Add to Cart - Ads	The average cost per add to cart attributed to your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_ADD_TO_CART`
CPC - Ads	The average cost per click on your social ads during the Reporting Period.CPC = Spend / Total Clicks Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_CLICK`
Cost per Estimated Ad Recall Lift (People) - Ads	The average cost per person estimated to recall your selected ads. Counts people, not actions, so it can’t be summed: Meta de-duplicates it for the report’s scope when the report loads. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_ESTIMATED_AD_RECALL_LIFT`
Cost per Landing Page View - Ads	The average cost per landing page view from your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_LANDING_PAGE_VIEW`
Cost per Lead - Ads	The average cost per lead attributed to your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_LEAD`
CPC (Cost per Link Click) - Ads	The average cost per link click on your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_LINK_CLICK`
CPM - Ads	The average cost per 1,000 impressions on your selected ad campaign during the Reporting Period. CPM = Total Spend / Impressions Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_MILE`
Cost per Outbound Click - Ads	The average cost per outbound click on your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_OUTBOUND_CLICK`
Cost per Post Engagement - Ads	The average cost per post engagement on your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_POST_ENGAGEMENT`
Cost per Purchase - Ads	The average amount spent per purchase attributed to your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_PURCHASE`
Cost per Result - Ads	The average amount spent per result. Only shown when every ad set in the group shares one result type Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_RESULT`
Cost per ThruPlay - Ads	The average cost per ThruPlay on your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_THRUPLAY`
Cost per Unique Click (All) - Ads	The average cost per person who performed a click (all) on your selected ads. Counts people, not actions, so it can’t be summed: Meta de-duplicates it for the report’s scope when the report loads. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`COST_PER_UNIQUE_CLICK`
Post Engagements - Ads	The total number of engagements on all ads within your selected campaign during the Reporting Period Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`ENGAGEMENTS`
Engagement Rate - Ads	The total percentage of users who engaged with your selected campaign after seeing an ad during the Reporting Period. Engagement Rate = Total Engagements / Impressions Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`ENGAGEMENT_RATE`
Estimated Ad Recall Lift (People) - Ads	An estimate of the number of additional people who would remember seeing your selected ads if asked within 2 days. Counts people, not actions, so it can’t be summed: Meta de-duplicates it for the report’s scope when the report loads. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`ESTIMATED_AD_RECALL_LIFT`
Estimated Ad Recall Lift Rate - Ads	Estimated ad recall lift (people) as a percentage of the people reached. Counts people, not actions, so it can’t be summed: Meta de-duplicates it for the report’s scope when the report loads. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`ESTIMATED_AD_RECALL_LIFT_RATE`
Frequency - Ads	The average number of times users saw ads in your campaign during the Reporting Period Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`FREQUENCY`
Impressions - Ads	The total number of impressions the ads in your selected campaign received during the Reporting Period Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`IMPRESSIONS`
Interactions - Ads	The total number of interactions your ads received during the reporting period Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`INTERACTIONS`
Landing Page Views - Ads	The number of times people landed on your website or Instant Experience after clicking a link in your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`LANDING_PAGE_VIEWS`
Leads - Ads	The number of leads attributed to your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`LEADS`
Link Clicks - Ads	The total number of times links on the ads in your selected campaign were clicked during the Reporting Period Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`LINK_CLICKS`
CTR (Link Click-Through Rate) - Ads	The percentage of times people clicked a link in your selected ads after seeing them Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`LINK_CLICK_THROUGH_RATE`
Outbound Clicks - Ads	The number of clicks on links that take people off Meta technologies, from your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`OUTBOUND_CLICKS`
Outbound CTR (Click-Through Rate) - Ads	The percentage of times people clicked an outbound link in your selected ads after seeing them Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`OUTBOUND_CLICK_THROUGH_RATE`
Page Engagements - Ads	The total number of engagements your page and its posts received from your ads during the Reporting Period Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`PAGE_ENGAGEMENTS`
Page Likes	The number of Page likes attributed to your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`PAGE_LIKES`
Post Comments - Ads	The number of comments on your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`POST_COMMENTS`
Post Reactions - Ads	The number of reactions on your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`POST_REACTIONS`
Post Saves - Ads	The number of times your selected ads were saved Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`POST_SAVES`
Post Shares - Ads	The number of shares of your selected ads Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`POST_SHARES`
Purchases - Ads	The number of purchases attributed to your selected ads, counted once across website, app and in-store purchases Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`PURCHASES`
Purchases Conversion Value - Ads	The total value of purchases attributed to your selected ads, in the ad account currency Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`PURCHASE_VALUE`
Reach - Ads	The total number of unique accounts that saw ads within your selected campaign during the Reporting Period. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`REACH`
Registrations Completed - Ads	The number of registrations completed that are attributed to your selected ads, counted once across website and app Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`REGISTRATIONS_COMPLETED`
Results - Ads	The number of times your selected ads achieved the outcome their ad set is optimised for, as Meta’s Results column counts it. Only shown when every ad set in the group shares one result type Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`RESULTS`
ROAS - Ads	The total return on ad spend for your selected campaign, as provided by Meta.ROAS = Calculated Purchase Conversion Value / Amount Spent Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`RETURN_ON_AD_SPEND`
ThruPlays - Ads	The number of times a video in your selected ads was played to completion, or for at least 15 seconds Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`THRUPLAYS`
Amount Spent - Ads	The average cost per click on your social ads during the Reporting Period.CPC = Spend / Total Clicks Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`TOTAL_SPENT`
Unique Clicks (All) - Ads	The number of people who performed a click (all) on your selected ads. Counts people, not actions, so it can’t be summed: Meta de-duplicates it for the report’s scope when the report loads. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`UNIQUE_CLICKS`
Unique CTR (All) - Ads	The percentage of people who saw your selected ads and performed a click (all). Counts people, not actions, so it can’t be summed: Meta de-duplicates it for the report’s scope when the report loads. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`UNIQUE_CLICK_THROUGH_RATE`
Unique Link Clicks - Ads	The number of people who clicked a link in your selected ads. Counts people, not actions, so it can’t be summed: Meta de-duplicates it for the report’s scope when the report loads. Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`UNIQUE_LINK_CLICKS`
Avg. Video Play Time - Ads	The average time a video in your selected ads was played, in seconds, weighted by the number of plays Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`VIDEO_AVG_PLAY_TIME`
Video Plays - Ads	The number of times a video in your selected ads started to play, excluding replays Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`VIDEO_PLAYS`
Video Plays at 100% - Ads	The number of times a video in your selected ads was played to 100% of its length, including plays that skipped to this point Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`VIDEO_PLAYS_100`
Video Plays at 25% - Ads	The number of times a video in your selected ads was played to 25% of its length, including plays that skipped to this point Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`VIDEO_PLAYS_25`
Video Plays at 50% - Ads	The number of times a video in your selected ads was played to 50% of its length, including plays that skipped to this point Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`VIDEO_PLAYS_50`
Video Plays at 75% - Ads	The number of times a video in your selected ads was played to 75% of its length, including plays that skipped to this point Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`VIDEO_PLAYS_75`
Video Plays at 95% - Ads	The number of times a video in your selected ads was played to 95% of its length, including plays that skipped to this point Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`VIDEO_PLAYS_95`
3-Second Video Plays - Ads	The total number of times videos in your selected ad campaign were viewed for over 3 seconds during the Reporting Period Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`VIDEO_VIEWS`
Web Conversions - Ads	The estimated number of conversions your selected ad campaign received during the Reporting Period, as measured by the Meta Pixel installed on your website Breakdown rows may not sum to the total. Conversions use each ad account’s attribution setting. Ad data updates daily, with Meta revising the last 28 days.	`WEB_CONVERSIONS`

Metric Name	Description	Metric API Name
Clicks - Ads	The number of clicks on your ads that led to a destination, such as a website, during the Reporting Period.	`CLICKS`
CTR - Ads	The percentage of times people saw your ad and performed a click (destination) during the reporting period.	`CLICK_THROUGH_RATE_DESTINATION`
CPC - Ads	The average cost per click on your ads during the Reporting Period that led to a destination, such as a website or landing page.	`COST_PER_CLICK`
CPM - Ads	The average cost per 1,000 impressions on your selected ad campaign during the Reporting Period.	`COST_PER_MILE`
Engaged Views - Ads	The number of times that videos in your campaign have been played for at least 6 seconds, or received at least 1 engagement within 1 day of seeing the ad.	`ENGAGED_VIEW`
Clicks (All) - Ads	The total number of all clicks on your ads, including link clicks, likes, shares, and comments, during the Reporting Period.	`ENGAGEMENTS`
Frequency - Ads	The average number of times users saw ads in your campaign during the Reporting Period.	`FREQUENCY`
Impressions - Ads	The total number of times users saw ads in your campaign during the Reporting Period.	`IMPRESSIONS`
Reach - Ads	The estimated number of unique accounts that saw ads within your selected campaign during the Reporting Period.	`REACH`
Real Time Conversions - Ads	The number of conversions your ad campaign received during the Reporting Period, based on the objective and settings selected in campaign setup.	`REAL_TIME_CONVERSIONS`
Real Time Conversion Rate - Ads	The percentage of ad conversions achieved per impression on your ad campaign during the Reporting Period.	`REAL_TIME_CONVERSION_RATE`
Amount Spent - Ads	The total amount of money you’ve spent on your selected ad campaign during the Reporting Period.	`TOTAL_SPENT`
Video View 100% - Ads	The number of times that videos in your campaign were played to 100% completion during the Reporting Period.	`VIDEO_VIEWS_P100`
Video View 50% - Ads	The number of times that videos in your campaign were played to 50% of their length during the Reporting Period.	`VIDEO_VIEWS_P50`
Video Watched (6 sec) - Ads	The number of times that videos in your campaign were played for at least 6 seconds during the Reporting Period. Replays are not counted.	`VIDEO_WATCHED_6S`

Next steps

With your ad campaign graph data, you can:

Build trend visualizations - Plot each campaign as a separate line on a chart
Identify performance patterns - Spot weekly patterns or optimal days for ad delivery
Track campaign lifecycles - Visualize performance from launch through optimization
Compare campaign effectiveness - Benchmark multiple campaigns against each other

Related guides:

Get Started

Reporting

Campaigns

Scheduler

Social Commerce

Social Listening

Community

Integration

MCP Server

Track ad campaign trends with graph reports

Use cases

Track campaign momentum

Identify peak performance

Monitor spend efficiency

Before you start

Test in the dashboard first

Implementation

Step 1: Get ad account IDs

For Meta Ads

For TikTok Ads

Compare across platforms

Step 2: Get ad campaigns

For Meta Ads

For TikTok Ads

Step 3: Map your report parameters

Step 4: Request the graph report

Compare multiple platforms

Step 5: Interpret the response

Response structure

Example insights

Metrics

Next steps

​Use cases

Track campaign momentum

Identify peak performance

Monitor spend efficiency

​Before you start

​Test in the dashboard first

​Implementation

​Step 1: Get ad account IDs

​For Meta Ads

​For TikTok Ads

​Compare across platforms

​Step 2: Get ad campaigns

​For Meta Ads

​For TikTok Ads

​Step 3: Map your report parameters

​Step 4: Request the graph report

​Compare multiple platforms

​Step 5: Interpret the response

​Response structure

​Example insights

​Metrics

​Next steps

Use cases

Before you start

Test in the dashboard first

Implementation

Step 1: Get ad account IDs

For Meta Ads

For TikTok Ads

Compare across platforms

Step 2: Get ad campaigns

For Meta Ads

For TikTok Ads

Step 3: Map your report parameters

Step 4: Request the graph report

Compare multiple platforms

Step 5: Interpret the response

Response structure

Example insights

Metrics

Next steps