Common errors when working with Performance Max

  • Asset groups need to meet minimum asset count requirements and include a short description.

  • When brand guidelines are enabled, brand assets, logos, and the business name asset must be linked at the campaign level.

  • Text assets and image assets have size, length, and aspect ratio requirements that must be met.

  • The final URL in the asset group must match the website specified in your Merchant Center account for shopping campaigns.

Here are some common errors when working with Performance Max campaigns and how to fix them:

Error
AssetGroupError.NOT_ENOUGH_*_ASSET The AssetGroup did not meet minimum asset count requirements for the specified asset type and was not created. See Common asset group errors for more information.
AssetGroupError.SHORT_DESCRIPTION_REQUIRED The AssetGroup is missing a DESCRIPTION asset of 60 characters or less. See Common asset group errors for more information.
AssetGroupSignalError.CANNOT_REMOVE_ALL_SIGNALS Each asset group in a Local Services Performance Max campaign must retain at least one signal. Attempting to remove all signals will trigger this error.
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN For Local Services Performance Max campaigns, at least one positive location criterion must remain. Attempting to remove all positive location criteria results in this error.
AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL Brand assets must be linked at the campaign level when brand guidelines are enabled for the campaign. Beginning in v21, brand guidelines are enabled by default on all new Performance Max campaigns. Link brand assets using a CampaignAsset. See the brand guidelines troubleshooting guide for more information.
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN For Local Services Performance Max campaigns, at least one positive location criterion must remain. Attempting to remove all positive location criteria results in this error.
CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED The campaign has brand guidelines enabled but is missing the minimum number of LOGO assets. Link at least one LOGO asset using a CampaignAsset. See the brand guidelines troubleshooting guide for more information.
CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED The campaign has brand guidelines enabled but is missing a BUSINESS_NAME asset. Link exactly one BUSINESS_NAME asset using a CampaignAsset. See the brand guidelines troubleshooting guide for more information.
StringLengthError.TOO_LONG A text asset exceeds the maximum length limit allowed for that asset type. Shorten the text asset according to limits specified in asset requirements.
MediaUploadError.ASPECT_RATIO_NOT_ALLOWED An image asset does not meet aspect ratio requirements. Ensure image assets meet the specifications listed in asset requirements.
MediaUploadError.DIMENSIONS_NOT_ALLOWED An image asset does not meet the dimension requirements. Ensure image assets are larger than the minimum dimensions listed in asset requirements.
AssetGroupError.FINAL_URL_SHOPPING_MERCHANT_HOME_PAGE_URL_DOMAINS_DIFFER The final_url in the AssetGroup must use the same website as specified in your Merchant Center account.
CriterionError.CANNOT_TARGET_LANGUAGE The targeted language is not supported for the campaign's country.
AssetGroupError.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN A Performance Max campaign must always have at least one active asset group. To remove an asset group, first create or add a new active asset group, or delete/pause the campaign itself.
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Local Services Performance Max (GLS PMax) campaigns require at least one positive location criterion to remain targeted to ensure the campaign can serve locally. Add a new location targeting criterion before attempting to remove the last remaining location.
AssetGroupSignalError.CANNOT_REMOVE_ALL_SIGNALS An asset group cannot have all of its targeting signals removed. Ensure at least one signal remains linked to the asset group.