For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Ads

Create campaigns, manage keywords, write ad copy, and analyze performance through natural conversation.

Time: ~5 minutes


Prerequisites

  1. Within the Agent Team Chat page, use your Ad Manager Account Email to complete the Google Connect (Setup). This will grant the permission to manage ads.

If you do not have a manager account yet, but you are asked for your Ad Manager Account email, just provide the email address you will use to create your Google Ads Manager Account later.

  1. You'll need a Google Ad Manager Account to obtain these information

    1. Developer Token — identifies your app to the Google Ads API

    2. Customer ID — identifies which ad account to work with

    3. MCC Customer ID — Ad Manager Account ID, mcc_customer_id


What's a Manager Account (MCC)?

A Manager account (MCC, or “My Client Center”) is a special Google Ads account that manages other ad accounts. It’s required for API access because the Developer Token is issued from it. Even if you only run your own ads, you’ll need to create a free Manager account and link your ad account—it only takes a few minutes.

The Manager Account (MCC) will provide the MCC Customer ID (see below), Developer Token (Step 1), while your ad account will provide the Customer ID

Manager Account (e.g. 816-xxx-xxxx) ← Manager Account ID or MCC Customer ID from here
├── Developer Token     ← get from here
└── Ad Account (e.g. 797-xxx-xxxx) ← Customer ID from here

👉 If you already have a Manager account, you can skip to the section Get your developer Token


1. Create a Manager account (~2 mins)

1

Go to https://ads.google.com/home/tools/manager-accounts/ Sign In and click "Create a manager account" or "New Google Ads Account"

2

Fill in the basic information

  • Account display name: anything (e.g. "Personal MCC")

  • Manage accounts for: select "Manage my accounts"

  • Country and time zone: match your main ad account

  • Currency: match your main ad account

  • Click Submit. You're now inside your new Manager account (the 10-digit ID appears at the top right, format xxx-xxx-xxxx).

3

Link your existing ad account under the Manager

  • Side menu → Accounts → Sub-account settings. (Still inside the Manager Account)

  • Click the + button, and Click "+ Link existing account"

  • Enter the 10-digit Customer ID from your active ad account—the same one you use to run ads (usually displayed in the top-right corner). Make sure it follows this format: xxx-xxx-xxxx, then click Send Request.

  • In the linked ad account: you'll get an invitation in Side menu → AdminAccess and securityManagers Accept, now you can go to next section for the Developer Token.

2. Get Your Developer Token (~2 mins)

  1. Sign in to Google Ads with your manager account.

Make sure you're signed into your Manager account (not your regular ad account). In the profile icon at the top-right, it should show "Manager account". If you see only "Ad account", switch accounts — regular ad accounts don't have an API Center menu.

  1. Click Admin (gear icon) in the side menu

  2. Under Admin, click API Center.

  3. Complete the API Access form, choose advertiser for company type. You should be granted "Explorer Access" right away.

If your access level is "Test Account" instead of "Explorer access", check again your company type selection below, change to "Advertiser" and you'll be granted exploerer access shortly.

Additionally, you may apply for a Basic Account access to access the full feature of keyword planner.

Google requires an Ad account with at least Basic Account level to use their keyword planner tools.


3. Get Your Customer ID

Now you've got the Developer Token. The last thing we need is the Customer ID of the ad account you actually run ads from — not the Manager account.

Your Customer ID is the 10-digit number formatted as xxx-xxx-xxxx , tap on your profile picture in the top-right corner of Google Ads Console, your accounts should be listed below.

lightbulb

Again, use the Customer ID of the specific ad account you want to manage (not the manager account itself).


4. Paste your Developer Token, Customer ID and MCC_customer_id (Done)

Go back to the chat and paste your Developer Token, Customer ID and MCC_customer_id, and you are all done! 🎉🎉🎉

MCC_customer_id is the Manager Account ID.

Note: If you are using your Manager Account to manage ad accounts outside your account or your organization, you should paste your MCC (manager account) ID. This allows the agent to help manage your ad sub-accounts.


What You Can Do

Category
Examples

Campaigns

Create, pause, resume, and review campaigns

Ad Copy

Write and edit text ads, responsive search ads

Keywords

Add, remove, and analyze keyword performance

Budgets

Set and adjust daily budgets

Reporting

Export performance data, view metrics, compare periods

Bidding

Review and update bid strategies


Safety Guarantees

We take extra care with Google Ads because real money is involved:

  • New campaigns are always created as PAUSED — nothing goes live without your explicit approval

  • The AI previews changes before applying them — you see exactly what will happen

  • No budget changes happen silently — the AI always confirms before adjusting spend


Sample Prompts

What you want
Try saying

Review performance

"How did my campaigns perform last week?"

Create a campaign

"Create a search campaign for winter boots"

Write ads

"Write 3 ad variations for my yoga studio"

Manage keywords

"Add 'organic coffee beans' as a keyword to my Coffee campaign"

Export data

"Export last month's campaign performance as a spreadsheet"

Pause spending

"Pause all active campaigns"


Troubleshooting

I don't have a Manager account and don't want to create one

Sorry, this is a Google API requirement, not ours. The Developer Token (which the API requires) is only issued inside Manager accounts. There's no workaround.

I don't see 'API Center' in Admin Settings

You're signed into a regular ad account. Switch to your Manager account via the profile icon. If you don't have a Manager account, do Step 1 first.

Developer token is not allowed with project 'xxxxxxxxx'

It means you have previously used this Google Cloud Project with another MCC Token. Google only allows one Ad MCC Token per Cloud Project, just create a new Google Cloud Project and setup with your MCC Token again.

"Customer ID is invalid"
  • The ID should be 10 digits, formatted as xxx-xxx-xxxx.

  • Make sure you're using the ad account ID, not the Manager Account ID (if you have one).

  • Remove any dashes or spaces when pasting if prompted.

"Authorization error" or "Access denied"
  • Your Google account must have access to the ad account you're trying to manage.

  • If using a Manager Account, make sure the ad account is linked to it.

  • If your token is in Test Account mode, it only works with test accounts. Wait for the approval to get Explorer Access, or apply for Basic or Standard access.

  • Make sure you copied the token from Tools & Settings > API Center (not from Google Cloud Console — they're different).

Last updated