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 Smart and Performance Max campaigns (including PMAX Leads).
- Suggestions Service — provides AI-generated campaign configurations, keyword themes, geo targets, budget recommendations, and creative assets to help build effective 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.
- Generate AI-powered keyword themes, geo targets, budget recommendations, and creative assets using the Suggestions API.
- Create and launch Smart campaigns and Performance Max campaigns, including PMAX Leads.
- Pause and resume running campaigns without losing their configuration.
- Query performance metrics, search terms, shopping performance, and asset-level analytics for active campaigns.
- 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.
- Each campaign requires at least one geo target and a daily budget. Use the Suggestions Service to get AI-generated budget recommendations and geo target suggestions.
- Campaign performance data is only available once a campaign is in the
LAUNCHED status.
- 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.
- Performance Max (PMAX): A goal-based campaign type that runs across all Google channels (Search, Display, YouTube, etc.) using asset groups and audience signals.
- Asset Group: A collection of creative assets (headlines, descriptions, images, videos) used by a PMAX campaign 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.