Workspaces
| Tool | Access | Description |
|---|---|---|
| Get Organizations And Workspaces | Read-only | Returns the organizations and workspaces accessible to the authenticated user. |
| Get Workspace Details | Read-only | Describes one or more workspaces: each one’s name, the publisher domains it collects data on, the cohort tags used in it, and its reach (users and page views, whole-workspace and broken down by domain, device, and country). |
Campaigns
| Tool | Access | Description |
|---|---|---|
| Get Campaign | Read-only | Reads one GAM campaign (order) — its details and lifetime delivery (impressions, CTR, viewability) — with optional breakdowns per cohort, per day, or per line item. |
| List Campaigns | Read-only | Lists a workspace’s individual GAM campaigns (orders), one per row, with each campaign’s lifetime delivery — impressions, CTR, and active status — filtered by a name/id search, active/inactive status, and Permutive-targeting, and ordered by name, dates, impressions, or CTR. Returns one page of named campaigns at a time. |
Cohorts
| Tool | Access | Description |
|---|---|---|
| Get Cohort Detail | Read-only | Returns metadata for specific cohorts: name, type, state, tags, subject entity, description, creation time, owning workspace, and which of the requested workspaces the cohort is available in. |
| List Cohorts | Read-only | Browses the cohorts available across one or more workspaces, filtered by type, state, tags, subject entity, a name keyword, and a user-count range, and ordered by short id, name, user count, or creation time. Each returned cohort includes its state, tags, subject entity, creation time, and estimated unique users over the last 30 days. Returns one page at a time. |
| Search Cohorts | Read-only | Searches for cohorts matching a natural language query across one or more workspaces. |
Audience Analysis
| Tool | Access | Description |
|---|---|---|
| Compare Audience | Read-only | Measures how a set of cohorts you specify relate to an audience: for each cohort, its overlap with the audience, its index — how much more or less likely a cohort member is to be in it than the average user — and how many net-new users it would add. Use this to get precise numbers on how cohorts are related to each other. |
| Find Audience Extensions | Read-only | Discovers cohorts you have not specified whose users correlate with a seed audience — the cohorts most worth considering as an extension of it, each with its overlap and index (affinity). A discovery tool, not a reporting one. |
| Measure Audiences | Read-only | Measures the reach of an audience by combining multiple cohorts — how many users are in it and how many page views they generate. |