Suggestions API: Sample Flows

This article presents a possible use case and corresponding sample flow that you can support. It provides a useful starting point as you plan your implementation.

Review and track campaign improvements

After a site owner creates a Google Ads Performance Max Leads campaign, you can display a prioritized campaign success guide and let them track the recommendations they complete.

To review and track campaign improvements:

1. Call Get or Create Campaign Success Guide, specifying campaignId and setting platformType to GOOGLE.
2. Use the returned campaignSuccessGuide to display the suggestions in their returned order. The first request can take up to 120 seconds while the guide is generated. Later requests return the saved guide unless a new analysis is required.
3. When the site owner completes a recommendation, call Update Campaign Success Guide Suggestion Status, specifying campaignId, the suggestion's type, and COMPLETED as its status.
4. Use the returned campaignSuccessGuide to refresh the displayed statuses.
5. To reopen a completed suggestion, call Update Campaign Success Guide Suggestion Status again with OPEN as the status.
6. Call Get or Create Campaign Success Guide when the site owner returns to the campaign to retrieve the latest saved guide.