RECIPE: Install Google Ads and Create an Account

Download skillThe skill is a reference md and part of wix-manage skill. You can use the following command to add the full wix-manage skill to your project:
Copy

Setting up Google Ads on a Wix site is a strict two-step prerequisite for everything else in this area: (1) install the Wix Google Ads app, then (2) create the Google Ads account. Account creation is gated on site eligibility: the site must be published, have a Premium plan, and have a custom domain connected, or Create Account fails with SITE_NOT_ELIGIBLE and no account is created. Campaigns, suggestions, analytics, and billing all fail with ACCOUNT_NOT_FOUND (or an app-not-installed error) until both are done. This is a one-time setup per site.

Base URL for the Google Ads endpoints: https://www.wixapis.com/_serverless/pa-google/v1. The eligibility check (STEP 1) is on the Paid Ads Platform API: https://www.wixapis.com/pa-platform/eligibility/v1. The <AUTH> placeholder is shorthand for the Authorization header; body-bearing calls also need Content-Type: application/json.

This flow creates a billable advertising account. Creating the account and launching campaigns spends the site owner's real money. Confirm intent with the user before calling Create Account, and surface the chosen currency.


STEP 0: Check whether an account already exists (do this first)

Before installing or creating anything, check for an existing account. Get Account For Current Site returns an empty response (not an error) when none exists, so it's the safe probe.

Copy
  • account present → setup is already done. Skip to whatever the user actually wants (create a campaign, view analytics, etc.). Do not create a second account — Create Account returns ACCOUNT_ALREADY_EXISTS.
  • Empty response {} → no account yet. Continue to STEP 1.

Example response for an existing account:

Copy

account.id is the Wix-internal GUID used as campaign.accountId when creating campaigns. googleAccountId is the underlying Google Ads customer ID (display only). currentBudget is remaining ad credit — a negative value means outstanding debt not yet charged.


STEP 1: Check that the site is eligible to advertise

Run this before installing the app or offering an incentive, so the owner isn't walked through currency and offers for an account that can't be created. It reads the site in the request context and takes no parameters.

Copy
Copy
  • eligibilityInfo.eligible: true → continue to STEP 2.
  • eligibilityInfo.eligible: false → stop: don't install the app, don't fetch incentives, don't ask for a currency, and never call Create Account (it fails with SITE_NOT_ELIGIBLE). Tell the owner that Google Ads needs a published site with a Premium plan and a connected domain, list only the criteria whose eligible is false, and give the fix for each, in this order:
Failed typeTell the ownerHow to fix it
HAS_PREMIUMThe site needs a Premium planLink the upgrade page: https://manage.wix.com/premium-pricing/studio/select-plan?siteGuid={siteId} for a Wix Studio site (editorType: STUDIO in the site context or a Query Sites lookup), otherwise https://manage.wix.com/premium-pricing/sunrise/select-plan?siteGuid={siteId}. The owner buys the plan there; there is no API for it. List it first: connecting a domain also needs Premium
DOMAIN_CONNECTEDThe site needs a custom domain connectedOffer Connect Domain, which covers buying a new domain or connecting one the owner has
SITE_PUBLISHEDThe site needs to be publishedOffer to publish it; publishing puts the site live, so ask first. On the owner's go-ahead, call Publish Site: POST https://www.wixapis.com/site-publisher/v1/site/publish with no body; it returns {}. SITE_IS_NOT_DEFINED_AS_PUBLISHABLE means the site hasn't been opened and saved in the editor yet: tell the owner to do that first

Offer the fixes; don't perform any of them without the owner's go-ahead. Once the owner says they've made the changes, call Get Eligibility Info again and continue to STEP 2 only when eligible is true.

If Get Eligibility Info itself returns an error, don't stop the setup: continue to STEP 2. Create Account runs the same checks and fails with SITE_NOT_ELIGIBLE and failedCriteria when the site isn't eligible, which the error table below handles.


STEP 2: Install the Wix Google Ads app

Idempotent — safe to call even if already installed (no effect). Required before Create Account.

Copy

Returns {}. Always run this before the first Create Account on a site.


STEP 3 (optional): Offer a promotional incentive

New accounts in supported currencies can attach an incentive — a promotional credit granted after the account spends a threshold. Skip this step for unsupported currencies (the call returns no offers).

Copy

Returns up to three tiers (lowOffer, mediumOffer, highOffer), each with an incentiveId, an awardAmount (credit granted), and a requiredAmount (spend needed to unlock it), plus a consolidatedTermsAndConditionsUrl. Present the tiers to the user and let them pick; carry the chosen incentiveId into STEP 4 as selectedIncentiveId. The incentive is recorded now and applied automatically once the account's budget is assigned — there is no separate apply call in this flow.


STEP 4: Create the Google Ads account

Requires currency (ISO-4217, e.g. USD) and a site that passed STEP 1. Pass selectedIncentiveId if the user picked one in STEP 3. Confirm with the user before this call — it provisions a billable account.

Copy

Response — save account.id for campaign creation:

Copy

The currency choice is durable and drives budget minimums/maximums and manager-account selection — settle it with the user before creating. A currency Google doesn't natively support (only USD, EUR, GBP, JPY are native) still works; the account reports budgetInSupportedCurrency as the converted amount.


Managing an existing account

UpdateAccount is a partial update — send only the fields you're changing. Merchant Center linking is needed before a retail Performance Max campaign can serve product ads.

Copy

The response's merchantCenterAccountLinkStatus.status starts at PENDING — the Merchant Center account owner must approve the link before it becomes ENABLED.

View conversion actions

Conversion actions (Purchase, Page View, etc.) are what campaigns optimize toward. To inspect them:

Copy

Delete the account

DeleteAccount unlinks and removes the account. This is destructive and cannot be undone — always confirm with the user first, and prefer pausing campaigns over deleting the whole account when the user just wants to stop spending.

Copy

Returns {}. Errors with ACCOUNT_NOT_FOUND if no account exists.


Error handling

SymptomCauseFix
ALREADY_EXISTS / ACCOUNT_ALREADY_EXISTS on Create AccountAn account is already linked to this siteDon't create another — use Get Account For Current Site and continue with the existing account.id
FAILED_PRECONDITION / SITE_NOT_ELIGIBLE on Create AccountThe site isn't published, has no Premium plan, or has no connected domain. details.applicationError.data.failedCriteria lists the failed types, e.g. ["HAS_PREMIUM", "DOMAIN_CONNECTED"]. No account was createdDon't retry. Give the owner the fix for each listed type, as in STEP 1, then call Get Eligibility Info again before retrying Create Account
INTERNAL / CREATION_BLOCKED on Create AccountAccount creation is temporarily disabled platform-wideNot a caller error; surface it and retry later
ACCOUNT_NOT_FOUND on any campaign/analytics/billing callSetup wasn't completed (no account)Run this recipe: install the app, then Create Account
App-not-installed error before Create AccountSTEP 2 was skippedCall Install (STEP 2); it's idempotent
Get Incentives returns no offersCurrency not supported for incentivesProceed to Create Account without selectedIncentiveId
NOT_FOUND / ACCOUNT_NOT_FOUND on Delete AccountNo account exists for the siteNothing to delete; confirm with Get Account For Current Site

References

Last updated: 16 November 2026

Did this help?