google_ads_add_keywords
ChatGPTAdds keywords to an ad group. New keywords start ENABLED.
google_ads_add_negative_keywords
ChatGPTAdds negative keywords to a campaign so its ads stop showing for those searches.
google_ads_apply_recommendations
ChatGPTApplies the given Google optimization recommendations to the account. This changes campaign settings and can overwrite budgets, bids and ads.
google_ads_dismiss_recommendations
ChatGPTDismisses the given Google optimization recommendations so they stop showing; a dismissed recommendation cannot be brought back. Campaign settings do not change.
google_ads_get_account_summary
ChatGPTReturns aggregate spend, clicks, impressions, conversions and campaign count for one Google Ads account over a date range.
google_ads_get_keyword_ideas
ChatGPTGenerates keyword ideas from seed keywords and/or a page URL with Keyword Planner, with average monthly searches, competition and top-of-page bid range.
google_ads_get_keyword_metrics
ChatGPTReturns average monthly searches, competition and top-of-page bid range for a known list of keywords.
google_ads_get_performance
ChatGPTReturns spend, impressions, clicks, CTR, CPC, conversions, conversion value, CPA and ROAS for a Google Ads account, broken down by account, campaign, ad group, ad or keyword, over a date range, sorted by spend. Money is in the account currency.
google_ads_get_search_terms
ChatGPTReturns the search queries that triggered ads, with spend, clicks, conversions and the campaign and ad group, sorted by spend. Use it to find wasted spend and negative keyword candidates.
google_ads_list_accounts
ChatGPTLists the Google Ads accounts the connected Google login can access, with name, currency, time zone and whether each is a manager (MCC) account. Every other Google Ads tool takes the account_id it returns.
google_ads_list_ad_groups
ChatGPTLists ad groups with status and default CPC bid, optionally for one campaign. Removed ad groups are excluded.
google_ads_list_ads
ChatGPTLists ads with status, type, final URL and responsive search ad headlines and descriptions, optionally for one campaign or ad group. Removed ads are excluded.
google_ads_list_campaigns
ChatGPTLists campaigns in a Google Ads account with status, channel type, daily budget and bidding strategy, sorted by name. Removed campaigns are excluded.
google_ads_list_conversion_actions
ChatGPTLists the conversion actions configured in a Google Ads account with category, status and whether they count toward bidding.
google_ads_list_keywords
ChatGPTLists the keywords (not negatives) with match type, status and CPC bid, optionally for one campaign or ad group. Removed keywords are excluded.
google_ads_list_manager_clients
ChatGPTLists the client accounts under a Google Ads manager (MCC) account. Pass the client account_id together with manager_account_id to the other Google Ads tools.
google_ads_list_negative_keywords
ChatGPTLists campaign-level negative keywords with match type, optionally for one campaign.
google_ads_list_recommendations
ChatGPTLists Google's optimization recommendations for an account with their type and resource name.
google_ads_remove_keywords
ChatGPTPermanently removes keywords from an ad group. This cannot be undone; pausing is the reversible alternative.
google_ads_remove_negative_keywords
ChatGPTPermanently removes campaign negative keywords, so ads can show for those searches again.
google_ads_set_ad_group_status
ChatGPTSets an ad group to ENABLED or PAUSED.
google_ads_set_ad_status
ChatGPTSets an ad to ENABLED or PAUSED.
google_ads_set_campaign_status
ChatGPTSets a campaign to ENABLED or PAUSED. Pausing stops delivery and can be undone by enabling again.
google_ads_set_keyword_status
ChatGPTSets a keyword to ENABLED or PAUSED.
google_ads_update_campaign_budget
ChatGPTReplaces the daily budget of a campaign, in the account currency. Refuses budgets shared between campaigns. The previous value is returned.
google_ads_update_keyword_bid
ChatGPTReplaces the max CPC bid of a keyword, in the account currency.
meta_ads_get_account_summary
ChatGPTReturns the status, currency, time zone, lifetime amount spent, spending cap and billing balance of a Meta ad account, plus totals for a date range (spend, impressions, link clicks, CTR, CPC, purchases, leads, conversions, CPA, ROAS). Money is in the account currency. clicks are link clicks. purchases count the first present of omni_purchase, purchase, offsite_conversion.fb_pixel_purchase, onsite_web_purchase; leads the first present of lead, offsite_conversion.fb_pixel_lead; registrations the first present of complete_registration, offsite_conversion.fb_pixel_complete_registration. conversion_value and ROAS use purchase value only. The balance is what the account owes Meta so far, not funds left, unless the account is prepaid.
meta_ads_get_ad_set
ChatGPTReturns one ad set with its targeting (ages, genders, locations, interests, behaviors, custom audiences, placements, Advantage audience), optimization goal, billing event, bid, budget, schedule and promoted object. Budgets and bids are in the account currency.
meta_ads_get_change_history
ChatGPTReturns the change log of a Meta ad account for a date range: who changed what and when (status, budget, bid, targeting, creative and other edits), newest first. Up to 100 events per call.
meta_ads_get_creative
ChatGPTReturns one ad creative with headline, primary text, call to action, type, image or thumbnail link, video id, and the Facebook Page id and post id behind it when the ad runs from a Page post. Image links are temporary.
meta_ads_get_performance
ChatGPTReturns spend, impressions, reach, frequency, link clicks, CTR, CPC, purchases, leads, registrations, conversions, conversion value, CPA and ROAS from Meta Insights, by account, campaign, ad set or ad, over a date range, optionally split by day or month. Rows are sorted by spend; totals cover every row. Money is in the account currency. clicks are link clicks. purchases count the first present of omni_purchase, purchase, offsite_conversion.fb_pixel_purchase, onsite_web_purchase; leads the first present of lead, offsite_conversion.fb_pixel_lead; registrations the first present of complete_registration, offsite_conversion.fb_pixel_complete_registration. conversion_value and ROAS use purchase value only. Ad-level conversion sums can run a few percent below account totals because Meta does not assign every modeled conversion to an ad.
meta_ads_get_performance_breakdown
ChatGPTReturns Meta Insights performance split by one dimension: age, gender, age_gender, country, region, publisher_platform (Facebook, Instagram, Audience Network, Messenger), placement (platform plus position such as feed, story, reels), device_platform or impression_device. Use it to see which audience or placement converts. Money is in the account currency. clicks are link clicks. purchases count the first present of omni_purchase, purchase, offsite_conversion.fb_pixel_purchase, onsite_web_purchase; leads the first present of lead, offsite_conversion.fb_pixel_lead; registrations the first present of complete_registration, offsite_conversion.fb_pixel_complete_registration. conversion_value and ROAS use purchase value only.
meta_ads_list_ad_accounts
ChatGPTLists the Meta (Facebook and Instagram) ad accounts the connected Meta login can access, with id, name and currency. Every other Meta Ads tool takes the ad_account_id it returns. Returns at most 100 accounts.
meta_ads_list_ad_sets
ChatGPTLists ad sets in a Meta ad account, optionally for one campaign, with status, effective status, optimization goal, billing event, bid strategy, bid amount, budget and schedule. Budgets and bids are in the account currency. Paged: pass next_cursor back as after for more. When the response is too large, incomplete is true, only the first items came back and next_cursor is null; ask again with a smaller limit.
meta_ads_list_ads
ChatGPTLists ads in a Meta ad account, optionally for one campaign or ad set, with status, effective status, creative id and parent ids. Paged: pass next_cursor back as after for more. When the response is too large, incomplete is true, only the first items came back and next_cursor is null; ask again with a smaller limit.
meta_ads_list_campaigns
ChatGPTLists campaigns in a Meta ad account with status, effective (delivery) status, objective, buying type, bid strategy, daily or lifetime budget and schedule. A campaign with a budget uses Advantage campaign budget; without one, budgets live on its ad sets. Budgets are in the account currency. Paged: pass next_cursor back as after for more. When the response is too large, incomplete is true, only the first items came back and next_cursor is null; ask again with a smaller limit.
meta_ads_list_creatives
ChatGPTLists ad creatives in a Meta ad account with headline, primary text, call to action, type and image or thumbnail link. Image links are temporary and expire within hours. Returns at most 100.
meta_ads_list_custom_audiences
ChatGPTLists custom and lookalike audiences in a Meta ad account with subtype, approximate minimum size and processing status. Paged: pass next_cursor back as after for more. When the response is too large, incomplete is true, only the first items came back and next_cursor is null; ask again with a smaller limit.
meta_ads_list_lead_forms
ChatGPTLists the instant (lead generation) forms of a Facebook Page with status, creation time, lead count and questions. The connected Meta login needs a role on the Page. Returns at most 50 forms; lead contact details are not returned.
meta_ads_list_pages
ChatGPTLists the Facebook Pages the connected Meta login has a role on, with id, name and category. Paged: pass next_cursor back as after for more. When the response is too large, incomplete is true, only the first items came back and next_cursor is null; ask again with a smaller limit.
meta_ads_list_pixels
ChatGPTLists the Meta pixels (datasets) of an ad account with the time each last received an event. Use it to check whether conversion tracking is firing.
meta_ads_remove_ad
ChatGPTArchives or deletes a Meta ad. This cannot be undone: an archived or deleted ad can never be edited or turned back on, and nothing new can be added under it. When every ad of an ad set is archived, Meta archives the ad set too, and then possibly its campaign. Pausing is the reversible alternative. Refuses an id that is not a ad. Confirm the exact item with the user first.
meta_ads_remove_ad_set
ChatGPTArchives or deletes a Meta ad set. This cannot be undone: an archived or deleted ad set can never be edited or turned back on, and nothing new can be added under it. When every ad set of a campaign is archived, Meta archives the campaign too. Pausing is the reversible alternative. Refuses an id that is not a ad set. Confirm the exact item with the user first.
meta_ads_remove_campaign
ChatGPTArchives or deletes a Meta campaign. This cannot be undone: an archived or deleted campaign can never be edited or turned back on, and nothing new can be added under it. Its ad sets and ads stop delivering with it. Pausing is the reversible alternative. Refuses an id that is not a campaign. Confirm the exact item with the user first.
meta_ads_search_ad_library
ChatGPTSearches Meta's public Ad Library for ads any advertiser runs on Facebook and Instagram; no ad account connection is needed. Pass exactly one of domain (a competitor's root website, e.g. brand.com), page_id (a Facebook Page id) or query (a keyword or brand name, mixed advertisers). Returns the longest-running ads first with image or video link, text, call to action, landing page, start date and days running. Takes 15 to 30 seconds.
meta_ads_set_ad_set_status
ChatGPTSets a Meta ad set to ACTIVE or PAUSED. Pausing stops delivery and can be undone by setting ACTIVE again; ACTIVE resumes delivery and spend. It still needs an active campaign to deliver. Refuses an id that is not a ad set.
meta_ads_set_ad_status
ChatGPTSets a Meta ad to ACTIVE or PAUSED. Pausing stops delivery and can be undone by setting ACTIVE again; ACTIVE resumes delivery and spend. It still needs an active ad set and campaign to deliver. Refuses an id that is not a ad.
meta_ads_set_campaign_status
ChatGPTSets a Meta campaign to ACTIVE or PAUSED. Pausing stops delivery and can be undone by setting ACTIVE again; ACTIVE resumes delivery and spend. An active campaign only delivers through ad sets and ads that are active too. Refuses an id that is not a campaign.
meta_ads_update_ad_set_budget
ChatGPTReplaces the daily budget of an ad set, in the account currency. Refuses ad sets in a campaign with Advantage campaign budget (change the campaign budget instead) and ad sets with a lifetime budget. The previous value is returned.
meta_ads_update_campaign_budget
ChatGPTReplaces the daily budget of a campaign that uses Advantage campaign budget, in the account currency. Refuses campaigns whose budgets are set on their ad sets and campaigns with a lifetime budget. The previous value is returned.
ryze_create_connection_link
ChatGPTCreates a one-time link the user opens to connect Google Ads or Meta Ads to their Ryze workspace. Give the user the url; it expires after a while.
ryze_get_connection_link
ChatGPTReturns whether a connection link is still waiting, already connected, or expired.
ryze_list_connections
ChatGPTLists which marketing platforms are connected in the Ryze workspace and which are not.
ryze_list_workspaces
ChatGPTLists the Ryze workspaces this connection can use, with name, id and website. Pass one as "workspace" to other tools when there are several.