Google Performance Max Campaigns

Create a Google Ads Performance Max campaign in one request from text and image URLs, with a daily budget, one asset group and its assets built together.

POST /ads/google/campaigns

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 0b7a6f1c-2d4e-4c55-9a3e-2f8d1b7c9e11" \
-X POST https://api.ayrshare.com/api/ads/google/campaigns \
-d '{
  "accountId": "123-456-7890",
  "name": "Fall sale PMax",
  "type": "performanceMax",
  "budget": { "amount": 40, "type": "daily" },
  "bidding": { "strategy": "maximizeConversions" },
  "targeting": { "locations": ["2840"] },
  "euPoliticalAdvertising": false,
  "platformOptions": {
    "google": {
      "finalUrl": "https://example.com/fall-sale",
      "assets": {
        "headlines": ["Fall sale", "Shoes 30% off", "Free returns"],
        "longHeadlines": ["Every running shoe 30% off this week only"],
        "descriptions": ["Every shoe 30% off this week.", "Free returns on every order."],
        "businessName": "Acme Shoes",
        "marketingImages": ["https://example.com/images/fall-1200x628.png"],
        "squareMarketingImages": ["https://example.com/images/fall-1200x1200.png"],
        "logos": ["https://example.com/images/logo-512.png"]
      }
    }
  }
}'

200: Campaign Created

{
  "status": "success",
  "platform": "google",
  "campaignId": "21534567891",
  "assetGroupId": "6512345678",
  "campaignStatus": "paused"
}

Set up conversion tracking first. Performance Max uses your conversions to decide where to show ads and how much to bid. Ayrshare does not block a campaign without it, but Google may limit its spend until conversion tracking is set up in your Google Ads account. Ayrshare does not set it up for you. When the account has none, the create response includes a warnings entry saying so.

Create a Google Ads Performance Max campaign in one request. You send text and image URLs; Google mixes them into ads across Search, YouTube, Display, Discover, Gmail and Maps. Ayrshare builds the budget, the campaign, one asset group and all its assets together. If Google refuses any part, nothing is created.

The request uses the shared Ad Campaigns shape. Reading and changing a campaign, insights and errors work as on Google Search Campaigns. This page covers what is different.

• Google ads are turned on per account. Contact us to enable them.
• New campaigns start paused unless you send status: "active".
• The budget is per day, in the ad account’s currency, and is never shared with other campaigns.
• Spend in another currency is converted to USD for billing at that day’s exchange rate from Open Exchange Rates. An account in a currency that cannot be converted answers code: 101 before anything is created.
• Video is not supported. Google may make videos from your images.

Header Parameters

Idempotency-Key · string · required

A new unique value, such as a UUID, for each new campaign. Repeating a request with the same key returns the first response. When a create fails before Ayrshare sends the campaign to Google (for example, an image that is the wrong size), the key is freed, so you can fix the request and retry with the same key.

Body Parameters

type · string · required

performanceMax.

bidding · object · required

Performance Max takes only these strategies. Any other answers code: 101.

• maximizeConversions: get the most conversions for the budget.
• targetCpa with targetCpa: the same, aiming at that cost per conversion.
• maximizeConversionValue: get the most conversion value for the budget.
• targetRoas with targetRoas: the same, aiming at that return on ad spend, for example 3.5 for 350%.

euPoliticalAdvertising · boolean · required

Google requires this declaration on every campaign.

targeting.locations · string[]

Google location ids, for example 2840 for the United States. Leave it out to target every location.

platformOptions.google · object · required

Show properties

finalUrl · string · required

The http or https page the ads open.

assets · object · required

Your text and images. Each list’s items must be different from each other.

Show properties

headlines · string[] · required

3 to 15, each up to 30 characters.

longHeadlines · string[] · required

1 to 5, each up to 90 characters.

descriptions · string[] · required

2 to 5, each up to 90 characters. At least one must be 60 characters or fewer.

businessName · string · required

One business name, up to 25 characters.

marketingImages · string[] · required

1 to 20 landscape image URLs: 1.91:1, at least 600×314.

squareMarketingImages · string[] · required

1 to 20 square image URLs: 1:1, at least 300×300.

logos · string[] · required

1 to 5 square logo URLs: 1:1, at least 128×128.

landscapeLogos · string[]

Up to 4 wide logo URLs: 4:1, at least 512×128. Google takes 5 logos and wide logos together at most.

Images

Ayrshare downloads each image from its URL and checks it before sending anything to Google:

• GIF, JPG or PNG, up to 5120 KB each.
• At least the minimum size above, with the aspect ratio of its field (within 1%).
• All images together up to 45 MB.
• The URL must be public. Private addresses are refused.

An image that fails answers code: 101 naming it, for example platformOptions.google.assets.logos[0]: the image is 100x100; use at least 128x128.

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 0b7a6f1c-2d4e-4c55-9a3e-2f8d1b7c9e11" \
-X POST https://api.ayrshare.com/api/ads/google/campaigns \
-d '{
  "accountId": "123-456-7890",
  "name": "Fall sale PMax",
  "type": "performanceMax",
  "budget": { "amount": 40, "type": "daily" },
  "bidding": { "strategy": "maximizeConversions" },
  "targeting": { "locations": ["2840"] },
  "euPoliticalAdvertising": false,
  "platformOptions": {
    "google": {
      "finalUrl": "https://example.com/fall-sale",
      "assets": {
        "headlines": ["Fall sale", "Shoes 30% off", "Free returns"],
        "longHeadlines": ["Every running shoe 30% off this week only"],
        "descriptions": ["Every shoe 30% off this week.", "Free returns on every order."],
        "businessName": "Acme Shoes",
        "marketingImages": ["https://example.com/images/fall-1200x628.png"],
        "squareMarketingImages": ["https://example.com/images/fall-1200x1200.png"],
        "logos": ["https://example.com/images/logo-512.png"]
      }
    }
  }
}'

200: Campaign Created

{
  "status": "success",
  "platform": "google",
  "campaignId": "21534567891",
  "assetGroupId": "6512345678",
  "campaignStatus": "paused"
}