Build Google Ads tracking fix prompt

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

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.

<Note>Only 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.</Note>

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

post/api/apps/{app_id}/google-ads/tracking-scan/build-bootstrap-prompt

Path parameters

app_idstring required

ID of the app whose Google Ads conversion tracking you want to manage.

Request body

wire_eventsboolean

Whether the prompt should also wire the account's enabled conversion mappings (true) or only install the base tag (false).

Example request

{
  "wire_events": true
}

Response

The prompt to send to the AI.

composer_promptstring required

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.

conversion_idstring nullable

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.

actions_created_or_existinginteger nullable

How many conversion goals the account has after this call, counting the ones it already had. Absent when skipped_reason is set.

wired_mappingsinteger nullable

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.

skipped_reasonstring nullable

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.

Example response

{
  "composer_prompt": "Wire up Google Ads conversion tracking for this app.\n\nCall get_capability_guide(\"google_ads\") first, then follow it.",
  "conversion_id": "AW-123456789",
  "actions_created_or_existing": 10,
  "wired_mappings": 3,
  "skipped_reason": "no_google_ads_account"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.