The Google Ads connector tools in Mark (Optimizely Agent Platform) provide a direct bridge to your advertising performance data, letting you retrieve detailed metrics across campaigns, ad groups, and individual keywords. This integration lets teams dive deep into audience demographics, geographic trends, and actual search queries to understand exactly how users are interacting with their ads. By centralizing these insights, marketers can more effectively optimize their budgets, refine targeting for Performance Max and Shopping campaigns, and drive higher ROI through data-backed experimentation.
First, a Mark administrator must configure the Google Ads connector in Mark (Optimizely Agent Platform). On the Connectors page, click Configure on the Google Ads tile and complete the steps. After the administrator configures the connector, individual Markusers and agent builders click Connect on the Google Ads tile and log in to Google Ads to access their information from Mark. Administrators only need to configure the Google Ads connector once.
Complete the following steps to enable the Google Ads tools in Mark.
Use cases
The following use cases show how you can use Google Ads connector tools in Mark to connect ad performance data with content and creative workflows.
Marketing strategy and performance optimization
Goal – Data-driven budget allocation and campaign scaling.
Key performance indicator (KPI) monitoring and budget shifting – Use the google_ads_get_campaigns and google_ads_get_budgets tools to identify campaigns with high conversion rates but low impression share (the percentage of eligible impressions your ads receive). Mark can draft a recommendation to reallocate funds from budget-constrained campaigns.
High-intent keyword discovery – Run the google_ads_get_keywords and google_ads_get_search_terms tools to surface high-value search queries that drive conversions but are not yet added as exact-match keywords.
Channel synergy analysis – Compare performance across Search, Shopping (google_ads_get_shopping_performance), and Performance Max (PMax) (google_ads_get_asset_groups) to determine which network is most efficient for specific product categories.
A/B experimentation
Goal – Validate creative and copy hypotheses.
Ad copy comparison – Use the google_ads_get_ads tool to compare the click-through rate (CTR) and conversion rate of different Responsive Search Ads (RSAs). Mark can analyze which headlines or descriptions drive performance and suggest variations for follow-up testing.
Landing page validation – Correlate specific ad groups (google_ads_get_adgroups) with conversion data to see which landing pages (mapped to those ad groups) are underperforming. Use this to trigger an Optimizely Web Experimentation or Optimizely Feature Experimentation test on those pages.
Demographic sensitivity testing – Use the google_ads_get_age_performance and google_ads_get_gender_performance tools to see if a specific creative resonates better with certain age groups. If a "Gen Z" creative is underperforming with its target, Mark can draft a brief for a more aligned creative direction.
Content pipeline and creative plans
Goal – Use search data to fuel Optimizely Content Marketing Platform (CMP).
Search-driven content briefs – Analyze top-performing search terms using the google_ads_get_search_terms tool. If a specific question or pain point appears frequently, Mark can generate a brief for a blog post in CMP to address that topic through organic search content.
PMax asset optimization – Use the google_ads_get_asset_groups tool to identify which asset groups in a Performance Max campaign have "Low" performance ratings. Mark can then help generate image prompts or headlines to replace the weak assets.
Seasonal creative refresh – Pull geographic performance data using the google_ads_get_geographic_performance tool. If a region is showing an uptick in interest for a specific product, use Mark to create localized ad copy or social assets tailored to that region's trends.
Audience insights and target strategy
Goal – Refine your audience and your geography.
Geographic expansion – Identify cities or regions with high conversion rates but low volume using the google_ads_get_geographic_performance tool. Use this insight to create localized landing page content or localized ad extensions.
Audience mapping – Use the google_ads_get_audiences tool to see which user lists are assigned. Mark can suggest Similar Segments or In-Market audiences based on the characteristics of the customers who convert at the highest rate.
Connect Mark with Google Ads
Find your Google Ads customer ID
Before you add the connector, find your Google Ads customer ID. See Find your Google Ads customer ID in the Google documentation for instructions. If you manage multiple Google Ads accounts under a Manager account (a single login that controls several customer accounts), also find the Manager account ID. This is your login customer ID.
Configure the Google Ads connector
When you click Configure, Mark opens the Configure Google Ads dialog. If the connector is not installed yet, an Install modal displays first. The dialog then has two steps: Settings, where you enter the details the connector needs to authenticate, and Tools, where you choose which tools to enable.
As a Mark administrator, complete the following steps:
Go to Connectors.
(Optional) Enter Google Ads in the Enter name field, or use the Provider, Active Status, and Provider Type filters to find the connector.
Click Configure on the Google Ads tile.
Note
The Install modal only displays if the connector is not installed yet. Installing adds the connector to your organization and makes its tools available. You install a connector once, for everyone.
On the Settings step, complete the following, and then click Next. The app stores these settings and applies them to everyone in your organization.
Under Google Ads API Authentication, enter your Customer ID. Use digits only, without hyphens. For example, 1234567890.
(Optional) Enter your Login Customer ID. This is your Manager account ID, in digits only. You only need it if you access sub-accounts through a manager account.
Under Tool Permissions, toggle Enable Data Reading on to enable read-only operations, such as getting campaigns, ad groups, ads, keywords, budgets, audiences, conversions, demographics, geographic performance, search terms, shopping, and Performance Max data. When this is off, Mark cannot view or query Google Ads data.
Toggle Enable Data Modifications on to enable write operations, such as pausing or enabling campaigns, ad groups, and ads, adding keywords, updating keyword bids, and updating budgets. When this is off, Mark cannot modify Google Ads entities.
On the Tools step, select the tools that users can use by default, and then click Save. Each tool displays its type, such as Read, Create, Update, or Delete. Use the search field to find a tool, or click Deselect all to clear the selection. Tools that you do not select still display on the connector's Tools tab, but remain disabled until you select them.
Important
Write operations can affect your live advertising campaigns and budgets.
After you configure the connector, the Google Ads tile displays Connect for everyone in your organization.
After you complete the steps in this section, each Mark user in your account can follow the steps in Authenticate with Google Ads to connect their own Google Ads login.
Authenticate with Google Ads
After an administrator connects Mark with Google Ads, log in from Mark to access your data. The Google Ads connector tools use user-level authentication, so you can only access data you have permission to view in Google Ads.
If the tile displays Contact Admin instead of Connect, an administrator has not configured the connector yet. Click Contact Admin to send them a request, which displays in their Notifications.
To authenticate, complete the following steps in Mark:
Go to Connectors > Connectors.
Click Connect on the Google Ads connector tools.
Log in to Google in the window Optimizely displays.
After an administrator configures the Google Ads connector and you log in using the User-level auth for Google Ads, you can call the following tools in Mark. Click on a tool to expand it to learn when to use the tool, available parameters, and example prompts. If you do not provide a required parameter, Mark prompts you for it.
Account access and verification
Use these tools to confirm which Google Ads account is connected and to discover all accounts available to you. This is especially useful for manager (MCC) accounts with multiple sub-accounts, and as a first step before running queries against a specific account.
When to use
Confirm which account is connected before running other queries.
Retrieve the account name, customer ID, currency code, and timezone of a specific Google Ads account.
Check the manager status and auto-tagging configuration of an account.
Parameters
(Optional) customerId – Google Ads Customer ID to query (digits only, no hyphens). For example, 1234567890. Default: Uses the Customer ID from authentication settings. Only needed if querying a different account than the default.
Example prompts
Get the current Google Ads account info.
Can you tell me the timezone and currency for customer ID 1234567890?
Check the manager status of my connected Google Ads account.
When to use
Discover sub-accounts available under a MCC account.
Verify which customer accounts the authenticated user can access before querying specific IDs.
Retrieve a list of accessible customer IDs to pass into other Google Ads tools like campaigns or keywords.
Parameters
None
Example prompts
List all the Google Ads accounts I have access to.
What customer accounts can my credentials see?
Show me all accessible customer IDs for my manager account.
Campaign and structure management
Use these tools to analyze the hierarchy of your Google Ads account, monitor high-level performance metrics, manage budgets, and drill into specific ad groups and ad creatives.
When to use
Monitor total spend, impressions, and conversions for specific campaigns over a set date range.
Compare performance between active and paused campaigns.
Identify top-performing campaigns to inform budget reallocation.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) campaignIds – JSON array of campaign IDs to filter by. For example, [12345678, 87654321].
(Optional) metrics – JSON array of metric names to include. For example, ['impressions', 'clicks', 'cost_micros', 'ctr', 'conversions'].
(Optional) customerId – Customer ID (digits only).
(Optional) campaignStatus – JSON array of campaign statuses to filter by. Provide as a JSON string. For example, single status: ['ENABLED'], multiple statuses: ['ENABLED', 'PAUSED'].
(Optional) campaignName – Filter campaigns by name (case-insensitive contains match).
Example prompts
Show me the total cost and conversions for all enabled campaigns last month.
How did my "Search - Brand" campaign perform over the last 14 days?
I need a list of all paused campaigns and their historical click-through rates.
When to use
Break down campaign results to see which themes or ad groups drive the most ROI.
Analyze conversion rates at the ad group level to identify optimization opportunities.
Filter by ad group status to review performance of specific experimental groups.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) campaignIds – JSON array of campaign IDs to filter by. For example, [12345678, 87654321].
(Optional) metrics – JSON array of metric names to include. For example, ['impressions', 'clicks', 'cost_micros', 'ctr', 'conversions'].
(Optional) adGroupIds – JSON array of ad group IDs to filter by. For example, [98765432, 87654321].
(Optional) adGroupStatus – JSON array of ad group statuses to filter by.
(Optional) customerId – Customer ID (digits only).
Example prompts
What are the top five ad groups by conversion rate in my "Winter Sale" campaign?
Show me the impressions and CPC for ad groups in campaign ID 12345.
List all enabled ad groups that had more than 10 conversions last week.
When to use
Evaluate the performance of specific Responsive Search Ads or Expanded Text Ads.
Identify which ad creatives have the highest CTR.
Audit the performance of active ads within a specific campaign to refine copy or assets.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) campaignIds – JSON array of campaign IDs to filter by. For example, [12345678, 87654321].
(Optional) metrics – JSON array of metric names to include. For example, ['impressions', 'clicks', 'cost_micros', 'ctr', 'conversions'].
(Optional) adIds – JSON array of ad IDs to filter by. For example, [11111111, 22222222].
(Optional) adGroupIds – JSON array of ad group IDs to filter by. For example, [98765432, 87654321].
(Optional) adStatus – JSON array of ad statuses to filter by. For example, ['ENABLED', 'PAUSED']. Valid statuses include ENABLED, PAUSED, and REMOVED.
(Optional) customerId – Customer ID (digits only).
Example prompts
Compare the performance of all enabled ads in my "Brand" ad group.
Which individual ads had the lowest cost per click (CPC) last month?
Show me the conversion data for all ads in campaign 987654.
When to use
Track how much of your daily budget your campaigns use.
Monitor shared budget performance to ensure even delivery.
Identify campaigns that are "Limited by Budget" by comparing cost to daily limits.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) budgetIds – JSON array of campaign budget IDs. For example, [12345678, 87654321].
(Optional) metrics – JSON array of metrics. For example, ['impressions', 'clicks', 'cost_micros'].
(Optional) customerId – Customer ID (digits only).
(Optional) deliveryMethods – JSON array of delivery methods. For example, ['STANDARD']. Valid methods include STANDARD and ACCELERATED.
Example prompts
Show me the daily budget and total spend for all campaigns this week.
Which budgets are shared across multiple campaigns and how is the spend distributed?
Check the performance of my primary budget for the current month.
Search and keyword intelligence
Use these tools to analyze the effectiveness of your targeted keywords and to identify the search queries that trigger your ads.
When to use
Analyze performance by keyword match type (Exact, Phrase, Broad). Keyword match types control how broadly Google matches your keyword against user search queries. Exact, Phrase, and Broad widen the match in that order.
Identify keywords with high cost but no conversions to pause or exclude.
Check Quality Score (Google's 1–10 rating of keyword relevance and ad experience) and expected click-through rate for keywords.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) metrics – JSON array of metrics. For example, ['impressions', 'clicks', 'cost_micros', 'ctr', 'conversions', 'quality_score'].
(Optional) customerId – Customer ID (digits only).
(Optional) campaignIds – JSON array of campaign IDs to filter by. For example, [12345678, 87654321].
(Optional) keywordTexts – JSON array of keyword texts to filter by. For example, ['running shoes', 'sneakers', 'athletic footwear'].
(Optional) adGroupIds – JSON array of ad group IDs to filter by. For example, [98765432, 87654321].
(Optional) matchTypes – JSON array of keyword match types to filter by. For example, ['EXACT', 'PHRASE']. Valid match types include the following:
EXACT – Exact match keywords.
PHRASE – Phrase match keywords.
BROAD – Broad match keywords.
Example prompts
What are the top 10 keywords by conversion value in campaign 123?
Show me all Exact match keywords that have a Quality Score below five.
List the cost per conversion for keywords in my "Search - NonBrand" campaign.
When to use
Discover search queries that triggered ads, and use them to find negative keyword opportunities.
Identify emerging search trends and high-intent queries that are not yet added as keywords.
Understand how Google matches broad keywords to user queries.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) campaignIds – JSON array of campaign IDs to filter by. For example, [12345678, 87654321].
(Optional) searchTermStatus – JSON array of search term statuses to filter by. For a single status, use ['NONE']. For multiple statuses, use ['ADDED', 'EXCLUDED'].
(Optional) metrics – JSON array of metrics. For example, ['impressions', 'clicks', 'cost_micros', 'ctr', 'conversions'].
Example prompts
Show me the search terms from the last 30 days that have not been added as keywords.
Which search queries had more than 5 conversions last month?
I need a list of search terms from the "Shoes" ad group with a CTR higher than 10%.
Specialized campaign performance
Use these tools for specialized Google Ads formats, such as Performance Max and Shopping, that require unique reporting. They provide insights into asset groups, product performance, and ad distribution across the Google network.
When to use
Evaluate the performance of different asset groups (combinations of text, images, and video) in Performance Max.
Identify which audiences or themes within a PMax campaign drive results.
Monitor the status and metrics of each PMax component.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) assetGroupIds – JSON array of asset group IDs. For example, [12345678, 87654321].
(Optional) metrics – JSON array of metrics. For example, ['impressions', 'clicks'].
(Optional) customerId – Customer ID (digits only).
(Optional) assetGroupStatus – JSON array of asset group statuses. For example, ['ENABLED']. Valid statuses include ENABLED, PAUSED, and REMOVED.
(Optional) campaignIds – JSON array of campaign IDs. For example, [12345678].
Example prompts
Show me the clicks and conversions for asset groups in my PMax campaign.
Which asset group in campaign 987 has the highest conversion value?
List all enabled asset groups and their performance for the last 30 days.
When to use
Identify the websites, YouTube channels, or mobile apps where Google displays your Performance Max ads.
Audit placements for brand safety and relevance.
Understand the distribution of your PMax budget across the Google Display Network.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) campaignIds – JSON array of campaign IDs. For example, [12345678].
(Optional) metrics – JSON array of metrics. For example, ['impressions', 'clicks'].
(Optional) customerId – Customer ID (digits only).
Example prompts
Where did my PMax ads show last week? Show me the top 20 placements by impressions.
List the placements for campaign ID 45678 and their respective conversion counts.
I need a placement report for my all-asset Performance Max campaign.
When to use
Analyze performance by Product ID or category in Shopping and PMax campaigns.
Identify "hero" products that drive the most revenue for your ecommerce store.
Spot products with high spend but low return on ad spend (ROAS) to adjust bids or negative keywords (terms that prevent your ads from showing for irrelevant queries).
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) metrics – JSON array of metrics. For example, ['impressions', 'clicks'].
(Optional) productIds – JSON array of product IDs in Merchant Center format. For example, ['online:en:US:12345', 'online:en:US:67890'].
(Optional) adGroupIds – JSON array of ad group IDs. For example, [12345678].
(Optional) customerId – Customer ID (digits only).
(Optional) campaignIds – JSON array of campaign IDs. For example, [12345678].
Example prompts
What are my top 10 best-selling products by conversion value in Google Shopping?
Show me the impressions and cost for product ID 'online:en:US:12345'.
List product performance for the "Electronics" category over the last quarter.
Audience and demographic insights
Use these tools to break down performance by age, gender, and pre-defined audience segments to understand who is engaging with your ads. These breakdowns help you tailor your messaging and targeting.
When to use
Determine which age groups have the highest conversion rates to refine targeting.
Evaluate if your ad creative is resonating with your target demographic.
Justify bid adjustments for specific age brackets (for example, 25–34) based on performance.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) metrics – JSON array of metrics. For example, ['impressions', 'clicks'].
(Optional) customerId – Customer ID (digits only).
(Optional) campaignIds – JSON array of campaign IDs. For example, [12345678].
(Optional) adGroupIds – JSON array of ad group IDs. For example, [12345678].
Example prompts
What is the conversion rate for the 18-24 age range in my "University" campaign?
Show me a breakdown of clicks and cost by age group for last month.
Which age range has the lowest cost per conversion across the whole account?
When to use
Compare performance between male, female, and undetermined segments.
Identify demographic shifts in performance for specific localized campaigns.
Optimize your budget by focusing spend on the most responsive gender segments.
Parameters
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) metrics – JSON array of metrics. For example, ['impressions', 'clicks'].
(Optional) customerId – Customer ID (digits only).
(Optional) campaignIds – JSON array of campaign IDs. For example, [12345678].
(Optional) adGroupIds – JSON array of ad group IDs. For example, [12345678].
Example prompts
Which gender segment has the highest CTR in my "Apparel" campaign?
Show me the conversion value breakdown by gender for campaign ID 445566.
Compare impressions by gender for all search campaigns over the last 60 days.
When to use
Review the audience segments (User Lists, Custom Audiences) used for targeting.
Audit audience definitions to ensure they align with your current marketing strategy.
Identify available audiences for re-marketing or lookalike targeting.
Parameters
(Optional) audienceIds – JSON array of audience IDs. For example, [12345678, 87654321].
(Optional) customerId – Customer ID (digits only).
Example prompts
List all custom audiences configured in my account.
What are the definitions for my current remarketing lists?
Show me the IDs for all "In-Market" audiences I am currently tracking.
Geographic and result tracking
These tools provide location-specific data and detailed conversion tracking insights. Use them to understand where your results come from and what actions users take.
When to use
Identify high-performing countries, regions, or cities for expanded targeting.
Determine which geographic areas should be excluded based on high spend and low conversions.
Inform location-based bid adjustments for specialized local service campaigns.
Parameters
(Optional) adGroupIds – JSON array of ad group IDs to filter by. Examples include the following:
Single ad group – [12345678]
Multiple ad groups – [12345678, 87654321].
(Optional) locationIds – JSON array of location criteria IDs to filter by. Examples include the following:
Single location – [2840] (United States).
Multiple locations – [2840, 2826, 2124] (United States, United Kingdom, and Canada).
(Optional) startDate – Date range in YYYY-MM-DD format. For example, 2025-01-01.
(Optional) endDate – Date range in YYYY-MM-DD format. For example, 2025-01-31.
(Optional) campaignIds – JSON array of campaign IDs to filter by. Provide as a JSON string. Examples include the following:
Single campaign – [12345678]
Multiple campaigns – [12345678, 87654321].
(Optional) metrics – JSON array of metric names to include in the response. For example, ['metrics.impressions', 'metrics.clicks', 'metrics.cost_micros', 'metrics.ctr', 'metrics.conversions'].
(Optional) customerIds – Google Ads Customer ID to query (digits only, no hyphens). For example, 1234567890.
Example prompts
What were the top five countries by conversion rate for my "Global Search" campaign?
Show me the cost per acquisition (CPA) for users in California versus New York over the last month.
List all cities in the UK where my ads generated more than 50 clicks last week.
When to use
Retrieve conversion tracking configuration to see which conversion actions are set up.
Check the categories, statuses, and types of your configured conversions.
Filter specific conversion actions by category (for example, purchases or leads) to audit tracking setups.
Parameters
(Optional) categories – JSON array of conversion categories. Example: "['PURCHASE', 'LEAD']". Valid categories: PURCHASE, LEAD, SIGNUP, PAGE_VIEW, ADD_TO_CART, etc.
(Optional) customerId – Customer ID (digits only). Uses default if not provided
Example prompts
Get all conversion actions configured in my Google Ads account.
Show me the configuration for conversion action IDs 12345678 and 87654321.
List all the conversion actions that are categorized under 'PURCHASE' or 'LEAD'.
Campaign and keyword management
Use these tools to make changes to your account, such as pausing campaigns, adjusting budgets and bids, and adding keywords. Unlike the reporting tools, these tools modify your live campaigns and can affect spend, so review the changes before you apply them.
When to use
Create one or more keyword criteria in a specified ad group.
Add multiple keywords with different match types (EXACT, PHRASE, or BROAD).
Add keywords with a default cost-per-click (CPC) bid to an ad group.
Parameters
adGroupId – The ad group ID to add keywords to. For example, 12345678.
keywords – JSON array of keyword objects. Each object must have text and matchType.
(Optional) cpcBidMicros – Default CPC bid in micros for all keywords being added. 1,000,000 micros = $1.00.
(Optional) customerId – Google Ads Customer ID (digits only, no hyphens). Default: Uses the Customer ID from authentication settings.
Example prompts
Add the exact match keyword "running shoes" to ad group 12345678.
Can you add "best running shoes" as a phrase match and "athletic footwear" as broad match to ad group 12345678?
Add the keyword "running shoes" with an exact match and a default CPC bid of $1.50 to ad group 12345678.
When to use
Update the CPC bid amount for a specific keyword criterion.
Adjust bids in micros (1,000,000 micros = $1.00).
Change the bid for an individual keyword without affecting the entire ad group.
Parameters
adGroupId – The ad group ID that contains the keyword. For example, 12345678.
cpcBidMicros – New CPC bid amount in micros. 1,000,000 micros = $1.00.
criterionId – The keyword criterion ID to update the bid for. For example, 99887766.
(Optional) customerId – Google Ads Customer ID (digits only, no hyphens). Default: Uses the Customer ID from authentication settings.
Example prompts
Set the CPC bid to $1.50 for keyword criterion 99887766 in ad group 12345678.
Update the keyword bid to $0.50 for criterion 99887766 in ad group 12345678.
Change the CPC bid to $10.00 for keyword 99887766 in my ad group 12345678.
When to use
Update the status of one or more keyword criteria to ENABLED or PAUSED.
Pause a single underperforming keyword in an ad group.
Enable multiple keywords at once.
Parameters
adGroupId – The ad group ID that contains the keywords. For example, 12345678.
criterionIds – JSON array of keyword criterion IDs to update. Provide as a JSON string.
status – New status for the keywords. Valid values: ENABLED or PAUSED.
(Optional) customerId – Google Ads Customer ID (digits only, no hyphens). Default: Uses the Customer ID from authentication settings.
Example prompts
Pause keyword criterion 99887766 in ad group 12345678.
Enable keyword criteria 99887766 and 55443322 in ad group 12345678.
Please update the status to PAUSED for keyword 99887766 in ad group 12345678.
When to use
Update the status of one or more ads to ENABLED or PAUSED.
Pause a single underperforming ad in an ad group.
Enable multiple ads at once within the same ad group.
Parameters
adGroupId – The ad group ID that contains the ads. Required to construct the ad resource name. For example, 12345678.
adIds – JSON array of ad IDs to update. Provide as a JSON string.
status – New status for the ad(s). Valid values: ENABLED or PAUSED.
(Optional) customerId – Google Ads Customer ID (digits only, no hyphens). Default: Uses the Customer ID from authentication settings.
Example prompts
Pause ad 99887766 in ad group 12345678.
Enable ads 99887766 and 55443322 in ad group 12345678.
Update the status to PAUSED for ad 99887766 in ad group 12345678.
When to use
Update the status of one or more ad groups to ENABLED or PAUSED.
Pause a single ad group.
Enable multiple ad groups at once.
Parameters
adGroupIds – JSON array of ad group IDs to update. Provide as a JSON string.
status – New status for the ad groups. Valid values: ENABLED or PAUSED.
(Optional) customerId – Google Ads Customer ID (digits only, no hyphens). Default: Uses the Customer ID from authentication settings.
Example prompts
Pause ad group 12345678.
Enable ad groups 12345678 and 87654321.
Change the status to PAUSED for ad group 12345678.
When to use
Update the status of one or more campaigns to ENABLED or PAUSED.
Pause a single campaign that has ended or is underperforming.
Enable multiple campaigns at once.
Parameters
campaignIds – JSON array of campaign IDs to update. Provide as a JSON string.
status – New status for the campaigns. Valid values: ENABLED or PAUSED.
(Optional) customerId – Google Ads Customer ID (digits only, no hyphens). Default: Uses the Customer ID from authentication settings.
Example prompts
Pause campaign 12345678.
Enable campaigns 12345678 and 87654321.
Update the status of campaign 12345678 to PAUSED.
When to use
Change the daily budget amount for a campaign budget.
Increase the budget for a high-performing campaign.
Decrease the daily budget to limit spend on a specific campaign.
Parameters
amountMicros – New daily budget amount in micros. 1,000,000 micros = $1.00
budgetId – The campaign budget ID to update. For example, 12345678.
(Optional) customerId – Google Ads Customer ID (digits only, no hyphens). Default: Uses the Customer ID from authentication settings.
Example prompts
Set the budget to $50/day for budget ID 12345678.
Update the campaign budget to $100/day for budget ID 12345678.
Increase the budget amount to $500/day for budget ID 12345678.
