# About the Suggestions API

The Suggestions API helps you build Google Ads campaigns for a Wix site and improve them over time. It generates campaign configurations, keyword themes, geo targets, budgets, and creative assets based on the site's content and business, and retrieves the recommendations that Google Ads generates for the site's existing campaigns.

With the Suggestions API, you can:

- Get keyword theme suggestions based on the site's business.
- Search for geo targets by location name.
- Get daily budget options and recommended budgets, with estimated performance.
- Get AI-generated campaign configurations, text assets, image assets, and search themes.
- Get Google Ads recommendations for the site's account and campaigns, such as budget and asset changes.

Suggestions are a starting point for creating a campaign with the [Campaign API](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/campaign-v1/introduction).

## Before you begin

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

- [Get Recommendations](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-recommendations) requires a Google Ads account for the site. To create one, use the [Account API](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-account-v1/introduction).
- Suggestions aren't saved. To use them, pass them to [Create Campaign](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/campaign-v1/create-campaign). Generated images are the exception: they're saved to the site's Media Manager, in the "Google Ads AI generated images" folder.
- [Get Keyword Theme Suggestions](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-keyword-theme-suggestions), [Get Budget Suggestions](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-budget-suggestions), and [Get Geo Options](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-geo-options) respond quickly. [Get Campaign Suggestions](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-campaign-suggestions), [Get Text Asset Suggestions](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-text-asset-suggestions), [Get Image Asset Suggestions](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-image-asset-suggestions), and [Get Search Theme Suggestions](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-search-theme-suggestions) generate content with AI and can take 60 to 120 seconds to respond.
- Search theme suggestions and `PERFORMANCE_MAX_LEADS` campaign suggestions are generated from the site's business profile, such as its business goal, target audience, and value proposition. Missing profile details are filled in automatically from the site's pages, so a complete profile isn't required beforehand.
- Google Ads generates recommendations from the account's settings and recent performance, and updates them regularly. The same request can return different results over time.
- Recommendation types and the structure of a recommendation's `details` are defined by the Google Ads API, and can change when Google Ads updates its API.
- Get Recommendations returns only recommendations you can act on through Wix, such as budget, asset, and setting changes, or creating a Performance Max campaign. You make Shopping fixes in Wix Stores or Google Merchant Center.

## Use cases

- [Create and launch a Performance Max campaign](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/sample-flows#create-and-launch-a-performance-max-campaign).
- [Improve campaign performance](fallback::https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/sample-flows#improve-campaign-performance).

## Terminology

- **Keyword theme**: A topic or phrase that tells Google Ads which searches a Smart campaign's ads can show for.
- **Geo target**: A location, such as a country, region, or city, that a campaign targets.
- **Search theme**: A topic that tells Google Ads which searches a `PERFORMANCE_MAX_LEADS` campaign's ads can show for.
- **Asset**: A piece of ad content, such as a headline, description, image, or logo, that Google Ads combines into ads for a `PERFORMANCE_MAX_LEADS` campaign.
- **Budget recommendation**: A daily budget that Google Ads recommends for a campaign, with the estimated performance of that budget.
- **Recommendation**: A suggestion from Google Ads for improving an account or campaign, such as raising a campaign's budget or adding assets to it.

@sdk_package_setup

Mintlify Sandbox

Coding Examples

Overview

Sled Tests

Go Headless

Studio Two

Dashboard Extensions

Backend Extensions

Site Extensions

Extend Websites with SDK

Wix APIs and References

Build Apps

Wix Design System (WDS)

Client (Deprecated)

API Preview

Wix CLI

Contexts

Ricos

Extend Websites with Velo

API Reference

Velo

Picasso