Skip to main content
POST
Ask the Google Ads assistant

Authorizations

api_key
string
header
required

Personal API key.

Path Parameters

app_id
string
required

ID of the app whose Google Ads campaigns to manage.

Body

application/json
question
string
required

What you want to ask about the app's Google Ads campaigns, in plain language.

Example:

"Why is my Performance Max campaign spending its budget without converting?"

campaign_id
string

A campaign ID to mention in the question. It is passed to the model as text for context only, so the assistant does not read the campaign's data from it.

Example:

"68b1c0d4e7b91d003c45a1f2"

history
object[]

Earlier turns of the conversation, oldest first. Only the last ten are used.

Example:

Response

The assistant's answer.

The assistant's answer.

reply
string
required

The answer, as three to five sentences of plain prose with no markdown and no code blocks. It is written for a person to read, so do not parse it. An empty string means the model returned nothing, which you cannot tell apart from a genuinely empty answer, so treat it as a failed call and retry.

Example:

"Your campaign is spending its full daily budget but converting below the account average, which usually points at the landing page rather than the targeting. Check that the page loads quickly on mobile and that the offer matches the ad copy. Narrowing the geo targets to your best-performing region would also concentrate the budget."