Skip to main content
POST
Sync Google Ads campaigns

Authorizations

Authorization
string
header
required

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

Path Parameters

app_id
string
required

ID of the app whose Google Ads campaigns to manage.

Response

The campaigns Google reported, as Base44 saved them.

google_campaign_id
string
required

The campaign's ID in Google Ads. Match it against google_campaign_id from List campaigns to find Base44's id for the campaign.

Example:

"21098765432"

name
string
required

Name shown for the campaign.

Example:

"Spring sale in Berlin"

status
string
required

Serving state Google reports, ENABLED or PAUSED.

Example:

"ENABLED"

campaign_type
string
required

Campaign type, passed through as Google reports it. Base44 creates SMART and PERFORMANCE_MAX. The other values appear only on campaigns created outside Base44.

Example:

"SMART"

impressions
integer
required

Times the campaign's ads were shown.

Example:

15420

clicks
integer
required

Clicks the campaign received.

Example:

612

cost_micros
integer
required

Spend in micros of the account currency, where 1,000,000 micros is one unit, so 248000000 is 248.00.

Example:

248000000

conversions
number
required

Conversions Google attributed to the campaign.

Example:

31

review_status
string
required

Google's policy review status as Base44 last recorded it (REVIEWED, UNDER_REVIEW, …). A sync doesn't refresh it, and it's empty on a campaign the sync just added.

Example:

"REVIEWED"

serving_status
string
required

Google's serving status, passed through as Google reports it.

Example:

"SERVING"

primary_status
string
required

Google's summary of whether the campaign is serving well, passed through as Google reports it (ELIGIBLE, LIMITED, NOT_SERVING, …).

Example:

"ELIGIBLE"

primary_status_reasons
string[]
required

Google's reasons behind primary_status, for example why a campaign is limited. Empty when there is nothing to explain.

Example: