Actions119
- Analyze Search Terms
- Analyze Wasted Spend
- Explain Performance Anomaly
- Get Benchmark Context
- Get Business Profile
- Get Campaign Performance
- Get Campaign Structure
- Get Campaign Targeting
- Get Pmax Audience Signals
- Get Pmax Search Themes
- Get Usage Status
- Help User Upload
- Infer Business Profile
- List Campaign Extensions
- List Campaigns
- Optimize Budget Allocation
- Pause Ad
- Pause Campaign
- Remove Pmax Audience Signal
- Resume Ad
- Resume Campaign
- Save Business Profile
- Search Audiences
- Select Google Campaign Type
- Update Bid Strategy
- Update Campaign
- Update Keyword
- Validate Video
- Analyze Meta Ad Performance
- Analyze Meta Audiences
- Analyze Meta Wasted Spend
- Browse Meta Targeting
- Detect Meta Creative Fatigue
- Discover Meta Assets
- Duplicate Meta Campaign
- Explain Meta Anomaly
- Get Meta Ad Creatives
- Get Meta Audience Insights
- Get Meta Campaign Details
- Get Meta Campaign Performance
- Get Meta Lead Form Submissions
- List Meta Ad Sets
- List Meta Ads
- List Meta Campaigns
- List Meta Custom Audiences
- List Meta Instagram Accounts
- List Meta Lead Forms
- List Meta Pixels
- Optimize Meta Budget
- Optimize Meta Placements
- Pause Meta Campaign
- Resume Meta Campaign
- Select Meta Campaign Type
- Update Meta Ad
- Update Meta Campaign
- Add Linkedin Creative
- Add Linkedin Text Creative
- Add Linkedin Video Creative
- Analyze Linkedin Creative Performance
- Analyze Linkedin Wasted Spend
- Associate Linkedin Conversion
- Delete Linkedin Creative
- Discover Linkedin Assets
- Explain Linkedin Anomaly
- Explain Linkedin Objectives
- Generate Linkedin Ad Creatives
- Get Linkedin Campaign Performance
- Get Linkedin Campaign Structure
- Get Linkedin Campaign Targeting
- Get Linkedin Engagement Metrics
- Get Linkedin Organizations
- List Linkedin Campaign Groups
- List Linkedin Campaigns
- List Linkedin Conversions
- List Linkedin Creatives
- Manage Linkedin Conversions
- Optimize Linkedin Budget
- Pause Linkedin Campaign
- Pause Linkedin Creative
- Resume Linkedin Campaign
- Resume Linkedin Creative
- Search Linkedin Targeting
- Select Linkedin Campaign Type
- Update Linkedin Campaign Budget
- Update Linkedin Campaign Group
- Update Linkedin Campaign Schedule
- Update Linkedin Creative
- Analyze Tiktok Geo Performance
- Analyze Tiktok Wasted Spend
- Detect Tiktok Creative Fatigue
- Discover Tiktok Assets
- Explain Tiktok Anomaly
- Get Tiktok Ad Performance
- Get Tiktok Audience Insights
- Get Tiktok Campaign Details
- Get Tiktok Campaign Performance
- List Tiktok Ad Groups
- List Tiktok Ads
- List Tiktok Campaigns
- Optimize Tiktok Budget
- Pause Tiktok Ad
- Pause Tiktok Ad Group
- Pause Tiktok Campaign
- Resume Tiktok Ad
- Resume Tiktok Ad Group
- Resume Tiktok Campaign
- Update Tiktok Campaign
- Audit Conversion Tracking
- Delete Monitor
- Get Connections Status
- Get Monitor History
- Get Research Status
- List Connected Accounts
- List Monitors
- List Pending Actions
- List Scheduled Tasks
- Manage Action
- Manage Scheduled Task
- Test Monitor
Get Campaign Performance
AI-generatedSummary
Retrieve advertising campaign performance metrics from a selected platform, currently supporting Google Ads with parameters to specify customer ID, date ranges, and output detail level.
Inputs
- Platform (required) — The advertising platform from which to fetch campaign performance data. Options include Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, and Utility.
- Customer Id — For Google Ads platform, the specific customer ID to query performance metrics.
- Date Range — For Google Ads, a date range preset such as 'last_7_days', 'last_14_days', 'last_30_days', 'last_60_days', or 'last_90_days' to define the period of the performance data.
- Start Date — For Google Ads, the start date of the performance data in 'YYYY-MM-DD' format.
- End Date — For Google Ads, the end date of the performance data in 'YYYY-MM-DD' format.
- Lookback Days — For Google Ads, an optional numeric value (7, 30, 60, or 90) representing the number of days to look back for performance analytics. Leave blank to omit.
- Raw Data — For Google Ads, when set to true, returns only the raw campaign metrics as a JSON code block including spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, and ROAS by campaign/ad/date.
Output shape
a single JSON object containing campaign performance metrics relevant to the selected platform and parameters
Currently, detailed input parameters and outputs are clearly defined only for Google Ads. Other platforms might be supported but their parameters were not detailed. The output shape can vary, especially if 'Raw Data' is true, in which case it returns raw metrics in JSON format. Dates can be specified either by preset ranges or explicit start and end dates, but overlapping usage is subject to API behavior.
Examples
Example 1: Fetching Google Ads campaign metrics for a specific customer over the last 30 days with raw data output
Platform set to Google Ads, Customer Id provided, Date Range set to 'last_30_days', Raw Data enabled as true