Monitor ad campaign metrics across brands

Pull aggregated ad campaign metrics across Meta Ads and TikTok Ads. Use the data to monitor and compare ad campaign performance across brands.

Use cases

Tracking ad campaign performance manually across platforms wastes hours each week. Social advertising metric reports give you cross-platform ad performance benchmarks instantly.

Monitor campaign ROI

Compare ad spend and performance metrics across Meta and TikTok campaigns to optimize budget allocation

Track multi-brand performance

Monitor ad campaign effectiveness across multiple brands from a single dashboard

Identify top performers

Analyze which campaigns drive the most clicks, conversions, and engagement across platforms

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 metrics 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:

Step 4: Request the metric report

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

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_TOTAL_METRIC&
		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": {
            "campaign_name": "Summer Sale Campaign",
            "data_type": "CAMPAIGN",
            "metrics": {
                "LINK_CLICKS": {
                    "META_ADS": {
                        "context": 1250,
                        "context_change": 0.24,
                        "value": 1550
                    }
                }
            },
            "source_ad_account_id": "1368643043296927",
            "source_campaign_id": "120236587787680490",
            "user_has_access": true
        }
    },
    "product_category": "ADS"
}

Step 5: Interpret the response

The response includes 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
metrics: Object containing requested metrics
- value: Metric total for the reporting period
- context: Metric total for the comparison period
- context_change: Decimal representing percent change (e.g., 0.24 = +24%, -0.09 = -9%)

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.
Null values in response - Campaigns may return null if no data exists for the period.

Metrics

Meta Ads
TikTok Ads

Metric Name	Description	Metric API Name
Clicks (All) - Ads	The total number of times the ads in your selected campaign were clicked during the Reporting Period	`CLICKS`
CTR - Ads	The percentage of times people clicked your ads after seeing them during the Reporting Period. CTR = Total Clicks / Impressions	`CLICK_THROUGH_RATE`
Conversion Rate - Ads	The percentage of people who saw the ad and performed the desired action	`CONVERSION_RATE`
CPC - Ads	The average cost per click on your social ads during the Reporting Period.CPC = Spend / Total Clicks	`COST_PER_CLICK`
CPM - Ads	The average cost per 1,000 impressions on your selected ad campaign during the Reporting Period. CPM = Total Spend / Impressions	`COST_PER_MILE`
Engagements - Ads	The total number of engagements on all ads within your selected campaign during the Reporting Period	`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	`ENGAGEMENT_RATE`
Frequency - Ads	The average number of times users saw ads in your campaign during the Reporting Period	`FREQUENCY`
Impressions - Ads	The total number of impressions the ads in your selected campaign received during the Reporting Period	`IMPRESSIONS`
Link Clicks - Ads	The total number of times links on the ads in your selected campaign were clicked during the Reporting Period	`LINK_CLICKS`
Page Engagements - Ads	The total number of engagements your page and its posts received from your ads during the Reporting Period	`PAGE_ENGAGEMENTS`
Reach - Ads	The total number of unique accounts that saw ads within your selected campaign during the Reporting Period.	`REACH`
ROAS - Ads	The total return on ad spend for your selected campaign, as provided by Meta.ROAS = Calculated Purchase Conversion Value / Amount Spent	`RETURN_ON_AD_SPEND`
Amount Spent - Ads	The average cost per click on your social ads during the Reporting Period.CPC = Spend / Total Clicks	`TOTAL_SPENT`
Video Views - Ads	The total number of times videos in your selected ad campaign were viewed for over 3 seconds during the Reporting Period	`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	`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 metrics, you can:

Build performance dashboards - Compare campaign performance across brands and platforms
Track ROI trends - Query monthly to spot campaign effectiveness changes
Optimize ad spend - Compare metrics across campaigns to identify top performers
Inform budget allocation - Use performance data to guide investment decisions across platforms

Related guides:

Documentation Index

​Use cases

Monitor campaign ROI

Track multi-brand performance

Identify top performers

​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 metric report

​Compare multiple platforms

​Step 5: Interpret the response

​Response structure

​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 metric report

Compare multiple platforms

Step 5: Interpret the response

Response structure

Metrics

Next steps