AdvisorPPC

Documentation · Shield connector

AdvisorPPC Shield

Shield finds paid clicks that look invalid, such as bots, data centres and repeat clickers, and keeps them out of your Google Ads campaigns. Through Claude you can review what Shield saw and decide which IP addresses to exclude.

1. Connect Shield to Claude

  1. In Claude, open Settings, then Connectors, and add Shield from the directory, or add a custom connector with this URL: https://shield.advisorppc.com/shield/mcp
  2. Sign in with your AdvisorPPC account (or create one). Shield opens your private workspace and asks you to allow Claude. There is no client ID, secret or passcode to copy.
  3. Claude now holds a token for your Shield workspace only. You can disconnect it in Claude at any time.

2. Install the site tag

Ask Claude for your tag (shield_tracking_snippet) and paste it into every page your ads send people to, ideally in the page head:

<script src="https://shield.advisorppc.com/shield/v1/s.js?k=YOUR_SITE_KEY" async></script>

The tag records each ad click and how the visit behaves, so Shield can score it. What it collects is listed in the Shield section of our privacy policy. Tell your visitors about it in your own privacy notice and cookie banner where your law requires.

3. Connect Google Ads

Ask Claude to connect Google Ads. Shield returns a one-time link to Google's own sign-in, where you approve access. Then choose the account to protect (manager accounts work). Shield never sees your Google password.

4. Review and sync exclusions

  • Ask "which clicks this week look fraudulent and why?" Claude reads the scored clicks and their reasons.
  • Every change previews first. Excluding, removing and syncing IP addresses show exactly what would change and change nothing until you confirm in the conversation.
  • A sync adds the queued addresses to the IP exclusions of your Google Ads campaigns. Remove an address with shield_remove_exclusion if you change your mind.

5. Microsoft Advertising

Microsoft's API does not accept IP exclusions from applications, so Shield gives you a paste-ready list instead. Ask for your Bing status and paste the list into the IP exclusions of your Microsoft Advertising campaigns.

6. Tools

Read-only:

  • shield_overview Clicks, suspicious share and exclusions at a glance.
  • shield_recent_clicks The latest scored clicks with the reasons for each score.
  • shield_daily_trend Clicks and suspicious clicks per day.
  • shield_list_exclusions IP addresses Shield has queued or pushed.
  • shield_get_settings Score threshold and automation settings.
  • shield_list_sites The sites in your workspace and their keys.
  • shield_tracking_snippet The site tag to paste into your website.
  • shield_google_status Whether Google Ads is connected and which account is used.
  • shield_bing_status Microsoft Advertising status and the paste-ready IP list.
  • shield_connect_google A one-time link to connect Google Ads.
  • shield_connect_bing A one-time link to connect Microsoft Advertising.
  • shield_billing_status Your Shield plan and usage.
  • shield_upgrade_link A link to change plan.
  • shield_billing_portal A link to the billing portal.

Changes (each previews first and needs your confirmation):

  • shield_exclude_ips Queue IP addresses for exclusion.
  • shield_remove_exclusion Take an IP address off the exclusion list.
  • shield_sync_exclusions Push queued exclusions to your Google Ads account.
  • shield_update_settings Change the score threshold or automation.
  • shield_set_google_account Choose the Google Ads account Shield protects.
  • shield_create_site Add a site and get its key.

7. Plans

Shield has a free plan with limits and paid plans for more clicks and sites. See Shield pricing. When a limit is reached, Shield says so and links to an upgrade instead of failing silently.

8. Data and support

How Shield handles your visitors' click data is in the privacy policy; use of the service is governed by our terms. Questions or data requests: [email protected].