> ## Documentation Index > Fetch the complete documentation index at: https://developer.dashsocial.com/llms.txt > Use this file to discover all available pages before exploring further. # Monitor ad campaign metrics across brands > Retrieve aggregated ad campaign metrics across Meta Ads and TikTok Ads for multiple 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. Compare ad spend and performance metrics across Meta and TikTok campaigns to optimize budget allocation Monitor ad campaign effectiveness across multiple brands from a single dashboard 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](https://developer.dashsocial.com/guides/get-started/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: ```http theme={null} 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: ```http theme={null} 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): ```json theme={null} [ { "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: ```http theme={null} PUT https://facebook.dashsocial.com/brands/marketing_v2/campaigns body = { "ad_account_ids": ["1368643043296927"], "brand_ids": [144] } ``` #### For TikTok Ads Send a PUT request: ```http theme={null} PUT https://tiktok.dashsocial.com/marketing/ad_campaigns body = { "brand_ids": [144], "source_ad_account_ids": ["7113956961980284930"] } ``` Sample response (both platforms): ```json theme={null} [ { "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 report on. See [Metrics](#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
`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_TOTAL_METRIC` for this report
*** ### 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: ```http theme={null} 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: ```json theme={null} { "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 | 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: * [Track Ad Campaign Trends with Graph Reports](https://developer.dashsocial.com/guides/track-ad-campaign-trends-with-graph-reports) * [View Full API Reference](https://developers.dashsocial.com/reference/get_reports-data)