About the Suggestions API

The Suggestions API provides prioritized actions that can help improve a Google Ads Performance Max Leads campaign. Each campaign success guide combines recommendations for the campaign, its landing page, and the Wix site.

Site owners can review the guide in the Google Ads dashboard and mark individual recommendations as completed.

With the Suggestions API, you can:

• Generate a campaign success guide or retrieve a saved guide.
• Review optimization suggestions in priority order.
• Mark suggestions as completed or reopen them.

How campaign success guides work

The first request for a campaign success guide analyzes the campaign's landing page and configuration and checks relevant site connections. The response includes only suggestions that need attention, ordered by priority. New suggestions have an OPEN status.

A later request returns the saved guide unless a new analysis is required. Changing the campaign's landing page URL triggers a new analysis. Other campaign changes trigger one only when the saved campaign suggestions haven't been updated in the previous 28 days. The age of the guide alone doesn't trigger a new analysis.

Landing page suggestions and their statuses are shared by campaigns on the same site that use the same landing page URL. Site suggestions and their statuses are shared by all campaigns on the site. Campaign suggestions and their statuses apply only to the specified campaign. A new analysis replaces the applicable shared suggestions with new suggestions that have an OPEN status, which can also reset suggestions displayed in other campaign guides.

Before you begin

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

• Campaign success guides currently support only Google Ads Performance Max Leads campaigns. Set platformType to GOOGLE.
• The campaign must already exist on the site. Use the Google Ads Campaign API to create and manage campaigns.
• The first request can take up to 120 seconds while the guide is generated.
• Updating a suggestion's status records progress. It doesn't verify that the recommended change was made. Only suggestions included in the guide can be updated.

Use cases

• Review and track campaign improvements.

Terminology

• Campaign success guide: A prioritized list of optimization suggestions for a paid ads campaign.
• Landing page suggestion: A suggestion shared by campaigns on the same site that use the same landing page URL.
• Campaign suggestion: A suggestion based on a single campaign's configuration or ad content.
• Site suggestion: A suggestion shared by all campaign success guides on the same site.