Skip to main content
POST
Suggest Google Ads setup targeting

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

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

Response

Suggested locations, keyword themes and conversion goals.

Suggested targeting and conversion goals for a first campaign.

geo_targets
GoogleAdsSetupLocation · object[]
required

Up to 10 locations worth advertising in, one per place the model named. Empty when it couldn't tell.

Example:
keyword_themes
string[]
required

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

Example:
conversion_categories
string[]
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.

Example:
language_code
string
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:

"en"

limits
GoogleAdsTargetingLimits · object
required

The limits the themes and excluded terms you save have to fit.