PlatformDocs

Ads audiences

Show ads to the people who visited your website: send them to Google, LinkedIn and Meta Ads as audiences.

View as Markdown

Connect the MCP server, then just ask.

list_google_ads_audiencesThe Google Ads retargeting audiences of a website: name, linked Google campaign, contacts uploaded and match stats.Read-only
get_google_ads_audienceOne retargeting audience: settings, contacts uploaded, match rate and the stats of its Google campaign.Read-only
sync_google_ads_audience_statsFetches the latest impressions, clicks and conversions of an audience’s campaign from Google Ads.Changes data

Use case

How are my Google Ads retargeting audiences doing this month?

Called list_google_ads_audiencesShow input
{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",
  "page": 1,
  "limit": 20
}

Each audience comes with its numbers as of the last refresh (the last 30 days) and how many contacts it holds.

Use case

Which contacts of my "Pricing visitors" audience failed to upload to Google, and why?

Called get_google_ads_audienceShow input
{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",
  "audienceId": "6530c1d2e3f4a5b6c7d8e9f7",
  "contactStatus": "failed",
  "limit": 50,
  "skip": 0
}

The answer counts the contacts per status (pending, pushed, failed) and lists up to 50 at a time, each failed one with its errorMessage. Your assistant finds the audienceId with list_google_ads_audiences.

Use case

Refresh the numbers of that audience from Google.

Called sync_google_ads_audience_statsShow input
{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",
  "audienceId": "6530c1d2e3f4a5b6c7d8e9f7"
}

It fetches the last 30 days of impressions, clicks, conversions, cost, CTR and CPC, plus the audience size Google matched. It fails until a Google Ads account is picked under Integrations → Google Ads and the audience is linked to a Google campaign.

The tools cover Google Ads audiences only; LinkedIn and Meta audiences are managed in the dashboard.

On this page