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.
- 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.
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.
- 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.