/wix-manage

RECIPE: Create and Launch a Performance Max Campaign

A Performance Max (PMAX) campaign runs across every Google channel from a single asset group — a bundle of headlines, descriptions, images, and (optionally) videos that Google mixes into ads. There are three flavors, set by campaignType:

• PERFORMANCE_MAX — general multi-channel campaign.
• PERFORMANCE_MAX_LEADS — lead-gen variant (phone/form conversions, search-theme signals, negative keywords, a ~28-day learning phase). Requires at least one asset group with headlines, descriptions, and images; assets are validated synchronously, so bad assets fail the create call immediately.
• Retail / Shopping — a PERFORMANCE_MAX campaign linked to a Google Merchant Center feed (set merchantCenterAccountId on the account first — see install-and-create-account — and use feedLabel). Retail campaigns don't require a hand-built asset group.

Base URL: https://www.wixapis.com/_serverless/pa-google/v1. <AUTH> is the Authorization header; body calls also need Content-Type: application/json. The bidding strategy is server-enforced to MAXIMIZE_CONVERSIONS — never set it yourself.

Launching spends real money. Present the assembled asset group and budget and get explicit approval before the Launch call (STEP 5). Create in PAUSED first — nothing serves until Launch.

Prerequisite: a Google Ads account (ACCOUNT_NOT_FOUND → run install-and-create-account). You need account.id as campaign.accountId.

Flow: STEP 1 text assets → STEP 2 image assets → STEP 3 (leads) search themes → STEP 4 budget recommendation → assemble & create PAUSED → show & approve → STEP 5 launch.

STEP 1: Generate text assets (headlines & descriptions)

suggestionInfo.landingPageUrl and textSuggestionInfo.languageCode are both required. Response may take up to 60s.

curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/text-asset-suggestions' \
  -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
  -d '{
    "suggestionInfo": { "landingPageUrl": "https://www.example.com", "assetTypes": ["HEADLINE", "DESCRIPTION"] },
    "textSuggestionInfo": { "languageCode": "en" }
  }'

{ "assetSuggestions": [
  { "assetType": "HEADLINE", "headlineAsset": { "text": "Fresh Baked Every Morning" } },
  { "assetType": "HEADLINE", "headlineAsset": { "text": "Award-Winning Pastries" } },
  { "assetType": "DESCRIPTION", "descriptionAsset": { "text": "Visit us for artisan breads, custom cakes, and more." } }
] }

STEP 2: Generate image assets

Images are generated with AI and automatically uploaded to the site's Wix Media Manager — the returned url is a static.wixstatic.com link you can use directly in the asset group. suggestionInfo.landingPageUrl is required.

curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/image-asset-suggestions' \
  -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
  -d '{ "suggestionInfo": { "landingPageUrl": "https://www.example.com", "assetTypes": ["MARKETING_IMAGE", "SQUARE_MARKETING_IMAGE"] } }'

{ "assetSuggestions": [
  { "assetType": "MARKETING_IMAGE", "imageAsset": { "name": "storefront-banner", "url": "https://static.wixstatic.com/media/abc123.jpg" } },
  { "assetType": "SQUARE_MARKETING_IMAGE", "imageAsset": { "name": "product-square", "url": "https://static.wixstatic.com/media/def456.jpg" } }
] }

STEP 3 (PMAX Leads only): Generate search themes

Search themes are the targeting signals for a leads campaign's asset group. textSuggestionInfo.languageCode is required.

curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/search-theme-suggestions' \
  -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
  -d '{ "landingPageUrl": "https://www.example.com", "textSuggestionInfo": { "languageCode": "en" } }'

{ "searchThemes": ["artisan bakery", "custom birthday cakes", "fresh bread delivery", "gluten free pastries", "wedding cake shop"] }

Each string becomes a { "searchTheme": { "text": "…" } } signal in the asset group (max 25).

STEP 4: Get a budget recommendation

PMAX uses Generate Budget Recommendation (not the Smart-campaign budget-suggestions endpoint). campaignType, assetGroupInfo (with a finalUrl), and currency are required.

curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/budget-recommendation' \
  -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
  -d '{
    "campaignType": "PERFORMANCE_MAX",
    "assetGroupInfo": [ {
      "finalUrl": "https://www.example.com",
      "headlines": ["Fresh Baked Every Morning", "Award-Winning Pastries"],
      "descriptions": ["Artisan breads and custom cakes baked fresh daily."]
    } ],
    "currency": "USD",
    "countryCodes": ["US"],
    "languageCodes": ["en"]
  }'

{ "budgetRecommendation": {
  "recommendedBudgetAmountMicros": "15000000",
  "budgetOptions": [
    { "budgetAmountMicros": "8000000",  "impact": { "potentialMetrics": { "impressions": 1200, "clicks": 35, "conversions": 2 } } },
    { "budgetAmountMicros": "15000000", "impact": { "potentialMetrics": { "impressions": 2800, "clicks": 78, "conversions": 5 } } }
  ]
} }

Use recommendedBudgetAmountMicros as budget.amountMicros, or present the budgetOptions with their projected impact and let the user pick. budgetRecommendation is absent when Google has too little data — fall back to a manual budget within GET /v1/campaign/daily-budget-boundaries.

Assemble & create the campaign (in PAUSED)

An asset group lives at performanceMaxCampaign.assetGroups[]. Its creative assets go under assetGroupAssets.assets[] — each asset sets exactly one payload field plus its assetFieldType. For a PMAX Leads asset group, meet Google's minimums or the create call fails with NOT_ENOUGH_ASSETS:

Image url must be a Wix Media Manager URL (static.wixstatic.com) — the STEP 2 generated images already are; for other images, upload via the Media Manager first (see Upload Media to Wix). Search themes go under assetGroupSignals.signals[] (PMAX Leads).

Create a PMAX Leads campaign (status required; create PAUSED):

curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/campaigns' \
  -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \
  -d '{
    "campaign": {
      "accountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "campaignType": "PERFORMANCE_MAX_LEADS",
      "status": "PAUSED",
      "name": "Summer Lead-Gen PMAX",
      "budget": { "amountMicros": "15000000" },
      "locations": [
        { "location": { "geoTargetConstant": "geoTargetConstants/1023191" }, "displayName": "New York, United States" }
      ],
      "performanceMaxCampaign": {
        "url": "https://www.example.com",
        "languages": [ { "languageCode": "en" } ],
        "assetGroups": [ {
          "assetGroupAssets": { "assets": [
            { "headlineAsset":     { "text": "Fresh Baked Every Morning" }, "assetFieldType": "HEADLINE" },
            { "headlineAsset":     { "text": "Award-Winning Pastries" },    "assetFieldType": "HEADLINE" },
            { "headlineAsset":     { "text": "Order Custom Cakes Today" },  "assetFieldType": "HEADLINE" },
            { "longHeadlineAsset": { "text": "Artisan breads and custom cakes baked fresh every morning" }, "assetFieldType": "LONG_HEADLINE" },
            { "descriptionAsset":  { "text": "Award-winning pastries made fresh daily." }, "assetFieldType": "DESCRIPTION" },
            { "descriptionAsset":  { "text": "Custom cakes for every occasion. Order online." }, "assetFieldType": "DESCRIPTION" },
            { "businessNameAsset": { "text": "Sunrise Bakery" }, "assetFieldType": "BUSINESS_NAME" },
            { "imageAsset": { "name": "storefront-banner", "url": "https://static.wixstatic.com/media/abc123.jpg" }, "assetFieldType": "MARKETING_IMAGE" },
            { "imageAsset": { "name": "product-square",    "url": "https://static.wixstatic.com/media/def456.jpg" }, "assetFieldType": "SQUARE_MARKETING_IMAGE" },
            { "callToActionSelectionAsset": { "callToAction": "SHOP_NOW" }, "assetFieldType": "CALL_TO_ACTION_SELECTION" }
          ] },
          "assetGroupSignals": { "signals": [
            { "searchTheme": { "text": "artisan bakery" } },
            { "searchTheme": { "text": "custom birthday cakes" } }
          ] }
        } ]
      }
    }
  }'

For a general PERFORMANCE_MAX campaign, use campaignType: "PERFORMANCE_MAX" (the assetGroupSignals are Leads-only). For retail/Shopping, link a Merchant Center account on the account first and set performanceMaxCampaign.feedLabel; a retail campaign can serve from the product feed without a hand-built asset group.

Save the returned campaign.id and resourceName. status is read-only and syncs from Google — a PMAX Leads campaign shows LEARNING for ~28 days after launch.

Now show the user the asset group (headlines, descriptions, images) and the daily budget, and get explicit approval.

STEP 5: Launch the campaign

curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/campaigns/{campaignId}/launch' \
  -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' -d '{}'

Returns the campaign with an updated status. Ads begin serving across Google channels; see Query Campaign Performance Analytics — PMAX Leads supports per-asset metrics.

Error handling

References

• Campaign Service introduction
• Create Campaign
• Launch Campaign
• Get Text Asset Suggestions
• Get Image Asset Suggestions
• Get Search Theme Suggestions
• Generate Budget Recommendation