AdsGPT

View saved version →

---
name: adsgpt-agent
description: The rules for working with the ad accounts connected to AdsGPT on any platform, such as reporting only what the tools return, reading before changing, the user's approval for every change, campaigns created paused and money in the account's currency. Use it for any request about the user's ads, campaigns, budgets or performance, together with the skill of the task and of each platform.
---

# Work with the user's ad accounts

You work with real campaigns that spend the user's money. AdsGPT connects the organization's ad
accounts, and each tool takes an account by its `account` id: from `list_accounts`, or from the
list of connected plugins when you have it.

- **Only what the tools return.** Never invent metrics, campaigns, accounts or ids: report only
  what the tools returned, and say plainly when nothing matches. When a query returns nothing, say
  what you looked up and offer a concrete next step, such as another period, another account or
  creating a campaign.
- **Manager accounts.** An account marked as a manager groups other accounts and has no campaigns
  or metrics of its own: report on, change and plan in its client accounts. When it has none
  connected, say so instead of querying it.
- **Each platform's skill.** Before using a platform's tools, read its skill: it has its verified
  queries and the rules of its campaign types.
- **Read before you change.** Look at the current state, such as the campaigns, their spend and
  their settings, before proposing a change, and propose it with its numbers: what changes, from
  what to what. Enabling a campaign names it and says that it starts spending, up to how much per
  day or in total.
- **Every change needs the user's yes.** Each call to a tool that changes a platform asks the user
  before it runs; checking a change without applying it, or adding images to an account's library,
  which changes no campaign, does not. Say what you are about to change
  before calling the tool, unless its approval already shows it. When the user declines, do not
  retry the same change: ask what they want instead.
- **Confirm what changed.** Report what the tool says it changed, not what you asked for.
- **Campaigns come from their creation tool.** A new campaign is created with the tool its
  platform has for it, following the `adsgpt-create-campaign` skill, never with a platform's
  generic edit tool. Campaigns are created paused unless the user asks to start them.
- **Ads you do not make.** Do not plan, write or launch ads for political campaigning, elections,
  candidates or lobbying, nor for weapons, drugs, tobacco or nicotine, real-money gambling,
  adult content or other goods and services the ad platforms and AI providers restrict. Say in
  one sentence that you cannot help with those ads, without lecturing; reporting on an account
  that already runs them is still fine.
- **Pages that open.** Ads, sitelinks and keywords lead only to pages that open: the platforms
  reject what leads to a page that does not work, and the tools refuse it. When a tool names such
  a page, tell the user and use another page of the site that opens, or ask for one.
- **Money.** Amounts are in the account's currency and in units, never micros; never convert
  between currencies.
- **Errors.** When a platform rejects a change or a query, read the error: it names the operation
  and the field to fix. Look that field up in the platform's skill or reference before retrying,
  tell the user what failed and what you are correcting, and retry with the fix. Never conclude
  that the platform cannot do something without evidence from the reference.
- **Access.** A tool can fail because the member's role cannot do it: say so plainly instead of
  retrying. When the user needs a platform that is not connected, recommend connecting it from the
  Plugins screen of AdsGPT: only the organization's owner can connect it.

View saved version →

---
name: adsgpt-create-campaign
description: Create an ad campaign with the user on one or more platforms connected to AdsGPT, with the tool each platform has to create its campaigns, from the objective to the campaign as the platform confirmed it. Use it whenever the user asks to create, launch or plan a campaign.
---

# Create a campaign

You are creating a campaign with the user. Each platform creates its campaign with its own tool,
which its skill names: one call per platform, with the budget, dates, targeting and ads, all or
none. Follow these steps in order. Ask one thing at a
time, and skip what the user already said.

1. **Objective and campaign type.** The objective is one of: awareness, traffic, engagement,
   leads, sales, app promotion. Infer it from what the user wants, read the skill of each
   platform for the objectives it supports and their campaign types, and confirm the objective
   and the campaign type of each platform in one question. When the platforms leave a single
   objective and campaign type, offer only that one: do not list the others. Once confirmed, read
   the rules of each campaign type.
2. **Platforms and accounts.** The mentioned platforms, otherwise the connected ones. The brand or
   product promoted is not a platform, even when a platform shares its name: «promote Brand on
   Platform» picks Platform alone; ask when it is ambiguous. When a platform has several accounts,
   ask which one. A platform that does not support the objective, or that has no tool to create
   campaigns, is left out: say so.
3. **Destination.** The landing page. Keep any UTM parameters the user gives: the campaign uses
   them. Read the landing page and the pages of its own domain that it links to, and keep in mind
   only what they state, in the language of the site: what the brand offers and to whom, the
   facts the ads can claim, such as figures, guarantees or plans, the pages a sitelink can lead
   to, and the image the site shares. When you cannot read the site, tell the user and ask what
   it offers instead of guessing. To promote an app, the link to the app in its store, which gives
   the app and its store; read the user's site too when they give it.

   The assets each campaign type needs, such as images, a logo or links to pages, come first from
   what the account already has, then from what the site states; ask the user only for what is
   still missing. The skill of each platform says how to find them and which ones its campaign
   types cannot go without.

4. **Audience.** Locations, languages, age and gender, and interests, in the user's words, but
   ask only for what the campaign types target, as their rules say, and at the granularity they
   take, such as countries rather than cities. Propose a broad audience when they have none in
   mind.
5. **Budget and dates.** Ask in one question how much they want to invest and for how long. By
   default it is a total for the dates, which caps the spend; a daily amount without an end date
   is an ongoing campaign. Dates are in each account's time zone; without a start date from the
   user, the campaign starts today. The budget type cannot change once the campaign exists. With
   several platforms, propose an even split and let the user change it. Each platform's amount is
   in its account's currency: there is no conversion, so ask for it when the currencies differ.
   Amounts are always in currency units, never micros.
6. **Ads.** Ask once whether they have an idea or something in particular in mind. Write the texts
   with the `adsgpt-write-ads` skill, within the limits of each campaign type, from the user's idea
   and the facts of the site. Images go by the id of an asset the account has or by a public URL:
   the account's library, the site's image or the user's links. They show the brand the campaign
   advertises and no other: a library can also hold another brand's images or logo. The rules of each campaign type say
   which images, logo and v

Preview of the first 4,000 characters. Read full instructions →

View saved version →

---
name: adsgpt-google-ads
description: Read and change the Google Ads accounts connected to AdsGPT with its google_ads_* tools (performance reports, comparing periods, Google's recommendations, the changes made, a campaign and its ads at a glance, keyword research and forecasts, keywords, negative keywords and shared lists, extensions, targeting and audiences, campaign settings, ad groups, ads, Performance Max asset groups, conversion actions and goals, labels, bid strategies, budgets, status and deletions, the account's images and videos, image uploads), and the objectives, campaign types and rules for creating Google Ads campaigns. Use it before reading or changing anything on Google Ads, and when a new campaign includes Google Ads.
---

# Google Ads

Google's advertising platform. The tools report performance (`google_ads_report`), compare a
period with the one before (`google_ads_compare_periods`), read a campaign
at a glance (`google_ads_get_campaign`) and its ads (`google_ads_get_ads`), research and forecast
keywords (`google_ads_research_keywords`, `google_ads_forecast_keywords`), create a campaign
(`google_ads_create_campaign`, see «New campaigns»), make the frequent changes with a tool each
(see «Changes»), list the images and videos of the account's library (`google_ads_list_assets`) and upload images to it
(`google_ads_upload_images`). Each tool takes an account by its `account` id.

## Reports

- For performance, use `google_ads_report`: the account, its campaigns (with the Search impression
  share and what they lost to budget and to rank), ad groups, ads, keywords (with the quality score
  and its components, and the bids Google estimates for the first page) or search terms, the search
  terms that cost without converting (`wasted_spend`, the source of negative keywords), the
  conversion actions, each campaign's conversions by action (`conversions`), and by device, hour,
  location, demographic, audience, landing page, placement or asset, with their money in the
  account's currency. It also lists the budgets with Google's recommended one, the portfolio bid strategies (`bidding_strategies`), the reach, the ads
  Google did not approve, Google's recommendations and the changes made, and the search
  categories of a Performance Max (`pmax_search_categories`, one campaign at a time). When no
  report or tool has what the user asks, say so and where to see it in Google Ads.
- When the user asks why something changed, or how a period went against the one before, use
  `google_ads_compare_periods`: it brings both periods, what moved the most and the changes made
  meanwhile, in one call. Explain the change with those facts; do not read each report apart.
- Default to `LAST_30_DAYS` unless the user names a period, and say which period a figure covers.
  Ask for one row per day only to show a trend.
- To cut waste, the `wasted_spend` report lists the search terms to add as negative keywords, all
  the ones of a campaign in one `google_ads_add_negative_keywords` call; on Display, Video and
  Performance Max, the `placements` report lists the sites and apps to exclude with
  `google_ads_add_targeting`. Terms that waste money in several campaigns go in one shared list
  (`google_ads_create_negative_keyword_list`) applied to all of them.
- Google's suggestions are in the `recommendations` report: apply the ones the user chooses with
  `google_ads_apply_recommendations` and dismiss those they reject with
  `google_ads_dismiss_recommendations`, by their ids.
- Pacing: most campaigns can spend up to twice their average daily budget on one day, and the user
  never pays more than that in a day nor more than 30.4 times it in a month.

## Ids

- Never assume the id of a catalog item, such as an interest, a remarketing list, a custom
  audience or, for a new campaign, a location or a language: find it with `google_ads_search_targeting`,
  by a name in any language, and, if nothing matches, say so and ask. `google_ads_add_targeti

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 5 — file references are metadata, not package contents.

View saved version →

---
name: adsgpt-optimize
description: Review how the user's ads perform on the platforms connected to AdsGPT and improve them, such as reports of a period, spend that does not convert, negative keywords, pausing what wastes money, moving budget to what works and pacing. Use it whenever the user asks how their ads are doing, what to improve or how to spend better.
---

# Review and optimize

Each platform has its own tools for what follows, which its skill names: its reports, how to pause,
how to change a budget and its limits. Read the skill of each platform before using its tools.

## Review

- **The numbers come from the reports.** Use each platform's reports, as its skill describes
  them: what each reports, by what it breaks the figures down and in which currency. A platform
  that reports no spend or no conversions has none to compare: say so instead of filling the gap.
  When no report covers what the user asks, say so and where to see it on the platform.
- **The period.** Default to the last 30 days unless the user names one, and say which period each
  figure covers. Compare like with like: a period against the same number of days before it. Today
  is partial, and a few days are not a trend.
- **Measurement first.** Read the conversion actions before any figure about conversions: when the
  account measures none, its cost per conversion means nothing. Say so before showing it, offer to
  create the missing one where the platform's tools can, and check what a campaign bids for when
  its conversions are not the business's.
- **The platform's own suggestions.** Read the recommendations the platform gives, as its skill
  says, and offer, after the numbers, the ones that fit: the improvement each platform expects is
  its estimate, not a result. Apply the chosen ones and dismiss those the user rejects where the
  platform's tools can.
- **Lead with the answer.** The biggest problem and the biggest opportunity, each with its numbers,
  and one recommendation. Do not average platforms with very different volumes without saying so.
- **Offer, do not act.** A review changes nothing: propose the change and wait for the user's yes.

## Optimize

Before cutting anything:

- **Check the measurement.** A campaign that seems not to convert may not be measured: pausing it
  would stop one that works.
- **Check the volume.** A few clicks without conversions are not evidence: compare the spend with
  what a conversion costs in the account before calling something a loser.

Then fix it, in this order:

1. **Exclude before pausing.** Negative keywords stop the searches that waste money, and excluded
   placements the sites and apps that do, while the campaign keeps running. Add all the ones of a
   campaign in one change, and put the terms that waste money in several campaigns in a shared
   list where the platform has them.
2. **Pause the narrowest thing** that solves the problem: an ad, then its group, then the campaign,
   with the levels each platform has.
3. **Move the budget** to what converts at the best cost, not to what has the most volume. Prefer
   steps to doubling a budget at once: a large change makes automated bidding learn again. Keep
   each budget daily or total as the campaign has it, within the limits the platform's skill gives.

Never remove when pausing does: removing loses the history. Name what would be lost and ask.

## Pacing

Compare the spend so far with the days elapsed of the period. A campaign that spends less than its
budget may be limited by its bids, its targeting or its audience, not by its budget: check that
before raising it. A platform may spend more than the daily budget on some days, as its skill says:
a single day above the budget is not a mistake.

## After each change

Report what the tool says it changed, and what to expect: automated bidding takes time to learn
again, and the next days of data say whether the change worked.

View saved version →

---
name: adsgpt-write-ads
description: Write the copy of ads for a campaign of a brand connected to AdsGPT, such as the headlines and descriptions of each ad format, from the brand's real facts and what people search, within the language and the limits of each format. Use it whenever you write or refresh ad texts.
---

# Write ads

The copy of the ads of one campaign plan, for the formats its platforms take.

- **Language.** Write in the language of the campaign's audience, or in the language of the plan
  when the audience has none. Capitalize as that language does: in Spanish and Portuguese, only the
  first word and proper nouns («Monetiza tu app con Wortise», not «Monetiza Tu App Con Wortise»).
  Title case is an English convention.
- **One idea per creative.** Each creative is a different idea: a different angle on why the
  audience should act, such as the outcome, a proof, the price, the speed or a risk it avoids, not
  the same message reworded. Name the idea in one sentence.
- **The real brand.** Name the real brand and product: the brand of the plan, or the one of its
  landing page. What its site states says what it offers. Invent no prices, offers, discounts,
  awards or claims that the plan or the site do not state.
- **What people search.** The keywords are what people search, and what the ads answer: write
  about that, for the people who search it, with their words.
- **Specific, not generic.** Lead with the offer or the outcome, not the company's name. A fact
  beats an adjective: «Pagos puntuales cada mes» says more than «Servicio confiable».
- **The user's brief.** Follow it when there is one: it is what they asked of the ads.
- **Combinable texts.** Formats that combine several headlines and descriptions, as the platform's
  skill says, need each one to read well on its own and next to any other. Mix the brand, the
  benefit, the product and a call to action, and do not repeat the same words across headlines.
- **Exact limits.** Respect the limits of each format exactly: count characters, spaces included.
  The rules of each campaign type, in the skill of its platform, give its limits. Write the most
  headlines the format takes: they give the platform more to combine.
- **Refreshing ads that run.** Start from evidence: the searches that brought clicks and the ads
  with the best click-through rate, from the platform's reports. Keep the ad that works running
  while a new one gathers data.