About Google Ads APIs

Wix Google Ads APIs allow your app to create and manage Google paid advertising campaigns on behalf of Wix site owners. The APIs cover the full advertising lifecycle — from installing the integration and setting up an account, to creating and launching campaigns, retrieving performance data, and managing billing.

The Google Ads APIs are organized into the following services:

  • App Installer Service — installs the Wix Google Ads app on a site. Install it before creating a Google Ads account with the Account Service.
  • Account Service — creates and manages the Google Ads account linked to the site, including incentive offers and subscription details.
  • Campaign Service — creates, updates, launches, pauses, and deletes Performance Max campaigns and Smart campaigns. Creating new Smart campaigns is deprecated.
  • Suggestions Service — suggests keyword themes, geo targets, and budgets, generates campaign configurations and creative assets with AI, and retrieves Google Ads recommendations for existing campaigns.
  • Analytics Service — queries performance metrics, conversion data, search terms, shopping performance, and asset-level data for running campaigns.
  • Payment Details Service — retrieves the current and upcoming billing details for the site's Google Ads account.

With the Google Ads APIs, you can:

  • Install the Wix Google Ads integration on a site and create a linked Google Ads account.
  • Get keyword theme, geo target, and budget suggestions, and generate campaign configurations and creative assets with AI, using the Suggestions API.
  • Create and launch Performance Max or Smart campaigns (creating new Smart campaigns is deprecated).
  • Pause and resume running campaigns without losing their configuration.
  • Query performance metrics, search terms, shopping performance, and asset-level analytics for active campaigns.
  • Get prioritized suggestions for improving a campaign's performance, including changes to its landing page and site, with the Paid Ads Platform Suggestions API.
  • Retrieve Google Ads recommendations for a site's Google Ads account and its campaigns, such as budget and asset changes.
  • Retrieve current and upcoming billing details for a site's Google Ads account.

Use cases

Before you begin

It's important to note the following points before starting to code:

  • The Wix Google Ads app must be installed on the site using the App Installer Service before creating a Google Ads account with the Account Service. This is a one-time prerequisite per site.
  • A Google Ads account must be created for the site using the Account Service before creating campaigns. The site must be published, have a Premium plan, and have a connected domain before an account can be created.
  • Each campaign requires at least one geo target, a language, and a daily budget. Use the Suggestions Service to get budget and geo target suggestions.
  • A retail PERFORMANCE_MAX campaign advertises the products in the account's linked Google Merchant Center feed. The account's merchantCenterAccountLinkStatus.status must be ENABLED before you create one.
  • Campaign performance data is only available after a campaign is launched and starts serving ads.
  • Budget amounts are expressed in micros: 1,000,000 micros equals 1 unit of the account's currency.
  • Campaigns created through the API appear in the Promote/Ads section of the site's dashboard, the same as campaigns created manually by the site owner.

Terminology

  • Campaign: A Google Ads advertising campaign, either a Smart campaign or a Performance Max (PMAX) campaign, that targets specific audiences and budgets.
  • Smart Campaign: A simplified campaign type where Google automatically manages bidding and ad delivery based on keyword themes and geo targets. Creating new Smart campaigns is deprecated; use a Performance Max campaign instead.
  • Performance Max (PMAX): A goal-based campaign that runs across all Google channels (Search, Display, YouTube, etc.). There are 2 types: PERFORMANCE_MAX and PERFORMANCE_MAX_LEADS.
  • PERFORMANCE_MAX: A retail (shopping) Performance Max campaign that advertises the products in the account's linked Google Merchant Center feed, including on Shopping.
  • PERFORMANCE_MAX_LEADS: A Performance Max campaign that builds its ads from an asset group you provide and is optimized for leads, such as phone calls and form fills.
  • Asset Group: A collection of creative assets (headlines, descriptions, a business name, images, and logos) that a PERFORMANCE_MAX_LEADS campaign uses to generate ads.
  • Budget: The daily spend limit set for a campaign.
  • Geo Target: A geographic location (country, region, or city) that a campaign targets.
  • Keyword Theme: A topic or phrase that tells Google what search queries a Smart campaign should match.
  • App Installer: The service that installs the Wix Google Ads integration on a site, linking the Wix site to the Google Ads platform.
  • Incentive Offer: A promotional credit offered to new Google Ads accounts that meet a minimum spend threshold.

Last updated: 15 November 2026

Did this help?