Skip to main content

​
Google Ad Manager

In one line: Connect Google Ad Manager so your UnleashX agent can look up your network, browse orders and line items, and pull reports — all in plain language.

​
1. Overview

Google Ad Manager is Google’s ad serving and inventory management platform. It’s where publishers organize their network, sell inventory through orders and line items, and measure delivery with reports. Once connected to UnleashX, your agent can read your network details, list and open orders, browse the line items inside them, and pull the reports you use to track delivery and revenue. It works against your live Ad Manager network using your own Google sign-in, so it respects your role and permissions. This connector is read-focused — it looks things up rather than changing your ad setup. Connecting Google Ad Manager to UnleashX means you can ask about your inventory in plain language. Instead of clicking through the Ad Manager UI to check an order or find a line item, you ask your agent and it fetches the answer.

​
2. What you’ll need

  • A Google Ad Manager account with access to a network.
  • Your Ad Manager network code (shown in the Ad Manager UI and in the URL).
  • A user role in Ad Manager that can view orders, line items, and reports.
  • The Google Ad Manager API enabled for your network.
  • An UnleashX account with access to Data Connectors.
No API key to paste. Google Ad Manager uses OAuth — you click Authorize and sign in with Google. You’ll also supply your network code so the agent knows which network to read.
Google enforces your Ad Manager role. The Google Ad Manager API must be enabled for your network, and your Google user needs a role that can view orders, line items, and reports — otherwise the agent can’t read them either. Ask your network admin to adjust access if needed.

​
3. Get your credentials

There’s no key to copy. Authentication runs through Google’s secure OAuth sign-in.
1

Start the connection in UnleashX

Connecting Google Ad Manager (Section 4) opens a Google Sign in window.
2

Sign in with Google

Sign in with the Google account that has access to your Ad Manager network. Complete two-factor authentication if prompted.
3

Review and accept the scopes

Google shows the access UnleashX is requesting (see the scopes table). Click Allow.
4

Enter your network code

Provide your Ad Manager network code so UnleashX knows which network to read. You can find it in the Ad Manager UI (Admin → Global settings) or in the page URL.
5

Return to UnleashX

Google redirects you back automatically and the connector links to your network. Behind the scenes UnleashX authenticates with Google using an OAuth token — you never handle the token yourself.
Permissions (Google OAuth scopes) UnleashX requests:
Google OAuth scopes are granular. UnleashX requests only what these tools need, and Google — together with your Ad Manager role — enforces the limits.

​
4. Connect on UnleashX

1

Open your agent

Go to https://www.tryunleashx.com and open the agent you want to connect.
2

Open Data Connectors

Inside the agent, go to Data Connectors.
3

Find Google Ad Manager

Locate Google Ad Manager and click Connect (or Add / Configure).
4

Authorize with Google

Click Authorize, sign in with Google, accept the scopes, and enter your network code.
5

Confirm success

You return to UnleashX and the Google Ad Manager connector shows a Connected badge.

​
Use Google Ad Manager in a Workflow

Once connected, you can add Google Ad Manager to any automation from the Workflows builder. Its triggers and tools appear in the Apps panel, marked with an MCP badge.
1

Add a trigger node

Open Workflows → New Workflow. On the canvas, click + Add Trigger. In the Paths panel, open the Apps tab and select Google Ad Manager — its Triggers are listed underneath. Use the search box if you have many connectors.
2

Add an action node

Click the + below any node to add a step, then pick Google Ad Manager again — this time the panel lists its Actions.
3

Configure the step

Fill in the fields for the trigger or action you picked. Required fields are marked with a red asterisk (*).
4

Add or select your account

Under Selected account, choose an already-connected account, or click Add Account to connect one now.
5

Save and test

Click Save. Use Test to verify the step, then toggle Publish when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see Using MCP in Workflows.

​
5. Available tools

​
Available triggers

​
6. Example usage

“Show me all active orders for the Acme advertiser this quarter.” → Runs List Orders filtered by advertiser and status, then returns the active orders. “What line items are in order 12345, and which one is under-delivering?” → Runs Get Order for 12345, then List Line Items on it and reviews their delivery.

​
7. Permissions & data access

UnleashX can:
  • Read your network details.
  • List and open orders and line items.
  • List saved reports in the network.
UnleashX cannot:
  • Create, edit, or delete orders, line items, or reports (this connector is read-focused).
  • Do anything your Ad Manager role doesn’t permit.
  • Access a different network than the network code you provided.
To disconnect: In UnleashX, open Data Connectors → Google Ad Manager → Disconnect. You can also revoke access at https://myaccount.google.com/permissions (Third-party apps with account access). Disconnecting revokes access immediately.

​
8. Troubleshooting

For general MCP issues, see /mcp/integrations.

​
9. Frequently asked questions

Is my ad data stored by UnleashX? No. UnleashX reads your network, orders, and reports live through the Ad Manager API per request; it doesn’t keep a copy. Which network does the agent use? The one whose network code you entered when connecting. To read a different network, reconnect with that network code. Can the agent change my orders or line items? No. This connector is read-focused — it looks things up but doesn’t create or edit your ad setup. Why do I need to enable the Google Ad Manager API? The API must be turned on for your network before any tool can read data. Your Google user also needs an Ad Manager role with view access.

​
10. References