> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/sample-flows.md

## Article Content:

# Google Ads APIs: Sample Flows

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

## Install the app and create a Google Ads account

A site owner wants to set up Google Ads for their Wix site for the first time.

To install the app and create a Google Ads account:

1. Call [Install App](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-ads-app-installer-v1/install-google-ads-if-not-installed.md) to install the Wix Google Ads integration on the site. This is required before calling any other service.
1. Call [Create Account](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-account-v1/create-account.md) to create a new Google Ads account linked to the site. Pass the site owner's preferred currency in the `currency` field.

## Create and launch a Smart campaign

A site owner wants to create a simple, automatically managed Google Ads campaign.

To create and launch a Smart campaign:

1. Call [Get Keyword Theme Suggestions](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-keyword-theme-suggestions.md) and [Get Geo Options](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-geo-options.md) with the site's URL to get keyword themes and geographic targets suggested by Google.
1. Call [Get Budget Suggestions](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-budget-suggestions.md) to get low, recommended, and high daily budget options with estimated click ranges.
1. Call [Create Campaign](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/campaign-v1/create-campaign.md) with `campaignType` set to `SMART`, the suggested keyword themes and locations, and the chosen `budget.dailyBudgetMicros`. The campaign is created in the status you specify.
1. Call [Launch Campaign](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/campaign-v1/launch-campaign.md) with the campaign's `id` to activate it and begin serving ads.

## Create and launch a Performance Max campaign

A site owner wants to run a Performance Max (PMAX) campaign across all Google channels using their creative assets.

To create and launch a Performance Max campaign:

1. Call [Get Text Asset Suggestions](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-text-asset-suggestions.md) with the site's landing page URL to get AI-generated headlines, descriptions, and other text assets.
1. Call [Get Image Asset Suggestions](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-image-asset-suggestions.md) to get AI-generated image assets. Images are automatically uploaded to the site's Wix Media Manager.
1. Call [Generate Budget Recommendation](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/generate-budget-recommendation.md) with `campaignType` set to `PERFORMANCE_MAX` to get a budget recommendation from Google.
1. Call [Create Campaign](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/campaign-v1/create-campaign.md) with `campaignType` set to `PERFORMANCE_MAX`, the generated asset groups, and the recommended daily budget.
1. Call [Launch Campaign](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/campaign-v1/launch-campaign.md) with the campaign's `id` to activate it.

## Pause and resume a campaign

A site owner wants to temporarily stop a running campaign and resume it later without losing its configuration.

To pause a campaign:

1. Call [Pause Campaign](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/campaign-v1/pause-campaign.md) with the campaign's `id`. The campaign stops serving ads immediately, but all settings and data are preserved.

To resume the paused campaign:

1. Call [Resume Campaign](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/campaign-v1/resume-campaign.md) with the campaign's `id` to reactivate it.

## Retrieve campaign performance analytics

A site owner wants to see how their running campaign is performing.

To retrieve campaign analytics:

1. Call [Query Performance Metrics](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/performance-metrics-v1/query-performance-metrics.md) with the campaign's `campaignResourceName` and a `dateRange` to retrieve impressions, clicks, CTR, and cost. Performance data is typically available within a few hours of campaign activity.
1. Optionally, call [Query Search Term Metrics](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/performance-metrics-v1/query-search-term-metrics.md) with the campaign's resource name to see which search queries triggered the campaign's ads.
1. Optionally, call [Query Conversion Metrics](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/performance-metrics-v1/query-conversion-metrics.md) with the campaign's `id` to retrieve conversion and revenue data from Wix Analytics.

## Retrieve payment details

A site owner wants to review their ad spend and upcoming charges for a Google Ads account.

To retrieve payment details:

1. Call [Get Payment Details](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/payment-details-v1/get-payment-details.md) to get the current billing period breakdown, including ad spend, Wix service fee, total charge, and any coupon adjustments. A positive `creditBalance` means the account has credits available; a negative value indicates outstanding debt that hasn't yet been charged.