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.
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.
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.{} → no account yet. Continue to STEP 1.Example response for an existing account:
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.
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.
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 type | Tell the owner | How to fix it |
|---|---|---|
HAS_PREMIUM | The site needs a Premium plan | Link 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_CONNECTED | The site needs a custom domain connected | Offer Connect Domain, which covers buying a new domain or connecting one the owner has |
SITE_PUBLISHED | The site needs to be published | Offer 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.
Idempotent — safe to call even if already installed (no effect). Required before Create Account.
Returns {}. Always run this before the first Create Account on a site.
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).
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.
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.
Response — save account.id for campaign creation:
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.
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.
The response's merchantCenterAccountLinkStatus.status starts at PENDING — the Merchant Center account owner must approve the link before it becomes ENABLED.
Conversion actions (Purchase, Page View, etc.) are what campaigns optimize toward. To inspect them:
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.
Returns {}. Errors with ACCOUNT_NOT_FOUND if no account exists.
| Symptom | Cause | Fix |
|---|---|---|
ALREADY_EXISTS / ACCOUNT_ALREADY_EXISTS on Create Account | An account is already linked to this site | Don't create another — use Get Account For Current Site and continue with the existing account.id |
FAILED_PRECONDITION / SITE_NOT_ELIGIBLE on Create Account | The 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 created | Don'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 Account | Account creation is temporarily disabled platform-wide | Not a caller error; surface it and retry later |
ACCOUNT_NOT_FOUND on any campaign/analytics/billing call | Setup wasn't completed (no account) | Run this recipe: install the app, then Create Account |
| App-not-installed error before Create Account | STEP 2 was skipped | Call Install (STEP 2); it's idempotent |
| Get Incentives returns no offers | Currency not supported for incentives | Proceed to Create Account without selectedIncentiveId |
NOT_FOUND / ACCOUNT_NOT_FOUND on Delete Account | No account exists for the site | Nothing to delete; confirm with Get Account For Current Site |
Last updated: 16 November 2026