AdCopilot docsby Atromx
Tool reference

Conversions and auto-apply

Create or change a Google Ads conversion action, get the ID and label its tag needs, and pause the recommendations Google applies without asking.

View as Markdown
Open inClaudePerplexity

create_conversion_action

Write. Creates a conversion action (what the account counts as a result) and returns the conversion ID and label its website tag needs.

  • Only website conversions (type WEBPAGE) can be created. Conversions imported from Google Analytics cannot be created through the Google Ads API, and are refused with an explanation.
  • It creates one enabled action and changes nothing else.
  • Nothing is counted until the tag is on your site. With Tag Manager connected, AdCopilot can stage a "Google Ads Conversion Tracking" tag with that ID and label; you publish the container yourself. See Tag Manager.

Set up a conversion for sign-ups on my thank-you page.

update_conversion_action

Write. Changes the settings of one conversion action you already have, and only the settings you ask for:

  • primary or secondary: a primary action is one campaigns that bid for conversions aim for; a secondary one is reported but not bid on;
  • counting: one result per ad click, or every result;
  • the value of one result, and whether that value is used for every result or only when your tag sends none;
  • the click-through window: how many days after an ad click a result still counts (1 to 90);
  • the attribution model, last click or data-driven, on website and click-import actions only.

It reads the action first and returns each setting before and after, so a change can be put back with a second call, except a setting that had no value before or an attribution model Google has retired. It never removes an action, and never changes its name, category or type. A removed action, one shared from a manager account, and one whose settings come from where it is imported from (Google Analytics, Firebase, a Floodlight activity) are refused before anything is sent; change those in Google Ads (Goals → Conversions) or at their source.

Make the page-view conversion secondary, so bidding aims for sign-ups.

Auto-apply recommendations

Google can apply some recommendation types to your account without asking.

  • list_auto_apply_subscriptions — Read. Which types are on. The Google Ads API covers only some types; the rest can only be seen and changed in the Google Ads interface, and the answer names them.
  • pause_auto_apply_subscription — Write. Pauses one type. It cannot switch a type on, create one or remove one.

Stop Google auto-applying broad match to my account.

On this page