Sign in

Suggest Google Ads setup targeting

Changed on

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

Suggests where to advertise, which keyword themes to target, and which conversions to track for the app's first campaign, read from the app itself.

A language model reads the app's name, description, pages, data entities and page source once, then Base44 resolves the places it names to real Google locations. Everything here is a suggestion for someone to confirm. Nothing is saved, and the app does not need a Google Ads account yet.

The call never fails on the suggestions themselves. When the app has nothing to read, the model fails or answers with nothing usable, or Google can't resolve a place, the affected lists come back empty under a 200, so an empty list means "no suggestion" rather than "none apply". conversion_categories in particular is empty unless the app already has the flow behind a goal, such as a booking page or a checkout. Expect it to take 30 seconds or more.

Once the app has a provisioned Google Ads account, Suggest Google Ads setup keyword themes gets Google's own themes for the locations you settle on. Use those first and fill up from keyword_themes.

<Note>This endpoint runs a language model and draws on a shared quota of 20 requests per minute per app, which every Google Ads AI endpoint debits. Enterprise workspaces get a higher quota. A 429 means the quota is spent, not that this endpoint has its own limit.</Note>

It is refused with a 409 while the workspace is on a Google Ads billing hold. Running the model does not spend credits.

<Note>This endpoint accepts a personal API key from anyone who can edit the app. A read-only key is refused with a 403, and so are workspace API keys.</Note>

post/api/apps/{app_id}/google-ads/setup-suggestions

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/google-ads/setup-suggestions
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the app you are setting up Google Ads for.

Response

Suggested locations, keyword themes and conversion goals.

keyword_themesstring[] required

Up to 25 search themes a buyer might type, best first, in the app's own language.

conversion_categoriesstring[] required

Conversion goals worth tracking because the app already has the flow behind them, from PURCHASE, ADD_TO_CART, BEGIN_CHECKOUT, SUBSCRIBE_PAID, SUBMIT_LEAD_FORM, BOOK_APPOINTMENT, REQUEST_QUOTE, CONTACT, PHONE_CALL_LEAD and SIGNUP. Often empty.

language_codestring required

Two-letter code of the language keyword_themes is written in, as the model reported it. Empty when it couldn't tell. Pass it to Suggest Google Ads setup keyword themes.

Example response

{
  "geo_targets": [
    {
      "canonical_name": "Dublin,County Dublin,Ireland",
      "country_code": "IE",
      "name": "Dublin",
      "reach": "1300000",
      "resource_name": "geoTargetConstants/1007339"
    }
  ],
  "keyword_themes": [
    "phone screen repair",
    "iphone battery replacement"
  ],
  "conversion_categories": [
    "BOOK_APPOINTMENT",
    "PHONE_CALL_LEAD"
  ],
  "language_code": "en",
  "limits": {
    "max_keyword_themes": 25,
    "max_excluded_terms": 25,
    "term_max_len": 80,
    "term_max_words": 10
  }
}

Changes