Build Google Ads tracking fix prompt
Creates the app’s Google Ads conversion goals if it does not have them, then returns an instruction that tells the AI how to install conversion tracking in the app.
Send the returned composer_prompt to Send chat message and the AI does the wiring for you. Publish the app afterwards, because Google Ads only records conversions from the published app. Pair it with Scan Google Ads conversion tracking to see what needs fixing first.
This call changes the Google Ads account. Any goal missing from the standard set is created on it, covering PURCHASE, ADD_TO_CART, BEGIN_CHECKOUT, SIGNUP, SUBMIT_LEAD_FORM, CONTACT, REQUEST_QUOTE, BOOK_APPOINTMENT, SUBSCRIBE_PAID, and PHONE_CALL_LEAD. Creating a goal is not reversible through this API. Read List Google Ads conversion actions first if you want to know what the account already has.
Send wire_events as true to get a prompt that also wires each of the account’s enabled conversion mappings, instead of only installing the base tag. On an account that has enabled mappings, that path waits for Google to publish the tag for each mapped goal and retries the read up to four times about a second apart, so the request can take several seconds.
wire_events is supported in the body. The builder UI sends a snapshot of the app’s source alongside it, which is internal and not part of this API.Authorizations
Personal API key.
Path Parameters
ID of the app whose Google Ads conversion tracking you want to manage.
Body
Whether the prompt should also wire the account's enabled conversion mappings (true) or only install the base tag (false).
true
Response
The prompt to send to the AI.
A ready-made instruction for the AI to install conversion tracking.
The instruction to send to Send chat message. It ends with a reminder to publish, because Google Ads only records conversions from the published app. The value is an empty string when skipped_reason is set.
"Wire up Google Ads conversion tracking for this app.\n\nCall get_capability_guide(\"google_ads\") first, then follow it."
The gtag conversion ID baked into the prompt, or an empty string when the prompt tells the AI to look each one up instead of carrying a concrete ID. Absent when skipped_reason is set.
"AW-123456789"
How many conversion goals the account has after this call, counting the ones it already had. Absent when skipped_reason is set.
10
How many of the account's conversion mappings the prompt carries wiring guidance for. When you send wire_events and the account has no enabled mapping, this reports the number of conversion categories the prompt offers instead, so read any value above 0 as a sign that the prompt carries wiring guidance rather than as a mapping count. Absent when skipped_reason is set.
3
Why no prompt was produced. The only value is no_google_ads_account, which means the app has no Google Ads account that can carry conversion tracking. The field is absent whenever a prompt was produced.
"no_google_ads_account"