Performance Max campaigns have some unique characteristics regarding assets.
- There are a minimum required number of assets of different types.
- Assets are grouped together in a collection called an
AssetGroup
, which is unique to Performance Max campaigns. - Assets are generated automatically by machine learning.
Ensure minimum asset requirements are met
Each Performance Max campaign requires an initial minimum set of assets. These may be existing assets used in other campaigns or new assets specifically for a Performance Max campaign.
Asset type | Field type | Specifications | Min | Max |
---|---|---|---|---|
TEXT | HEADLINE | 30 characters max; include at least one with 15 characters or less. | 3 | 5 |
LONG_HEADLINE | 90 characters max | 1 | 5 | |
DESCRIPTION | 90 characters max; include at least one with 60 characters or less. | 2 | 5 | |
BUSINESS_NAME | 25 characters max | 1 | 1 | |
IMAGE | MARKETING_IMAGE | Landscape (1.91:1) 1200 x 628 recommended; 600 x 314 min; 5120KB max file size | 1 | 20 |
SQUARE_MARKETING_IMAGE | (1:1) 1200 x 1200 recommended; 300 x 300 min; 5120KB max file size | 1 | 20 | |
PORTRAIT_MARKETING_IMAGE | (4:5) 960 x 1200 recommended; 480 x 600 min | 0 | 20 | |
LOGO | (1:1) 1200 x 1200 recommended; 128 x 128 min; 5120KB max file size | 1 | 5 | |
LANDSCAPE_LOGO | (4:1) 1200 x 300 recommended; 512 x 128 min; 5120KB max file size | 0 | 5 | |
YOUTUBE_VIDEO | YOUTUBE_VIDEO | horizontal, vertical, or square, >=10 seconds in length | 0 | 5 |
CALL_TO_ACTION | CALL_TO_ACTION_SELECTION | Automated by default, or select from a list | 0 | 1 |
MEDIA_BUNDLE | MEDIA_BUNDLE | < 150 KB | 0 | 1 |
The repeated assets (HEADLINE
, DESCRIPTION
) must be created in a separate
request prior to creating the campaign.
The following code snippet illustrates creating the necessary repeated assets in a new request:
Java
/** Creates multiple text assets and returns the list of resource names. */ private List<String> createMultipleTextAssets( GoogleAdsClient googleAdsClient, long customerId, List<String> texts) { List<MutateOperation> mutateOperations = new ArrayList<>(); for (String text : texts) { Asset asset = Asset.newBuilder().setTextAsset(TextAsset.newBuilder().setText(text)).build(); AssetOperation assetOperation = AssetOperation.newBuilder().setCreate(asset).build(); mutateOperations.add(MutateOperation.newBuilder().setAssetOperation(assetOperation).build()); } List<String> assetResourceNames = new ArrayList<>(); // Creates the service client. try (GoogleAdsServiceClient googleAdsServiceClient = googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) { // Sends the operations in a single Mutate request. MutateGoogleAdsResponse response = googleAdsServiceClient.mutate(Long.toString(customerId), mutateOperations); for (MutateOperationResponse result : response.getMutateOperationResponsesList()) { if (result.hasAssetResult()) { assetResourceNames.add(result.getAssetResult().getResourceName()); } } printResponseDetails(response); } return assetResourceNames; }
C#
/// <summary> /// Creates multiple text assets and returns the list of resource names. /// </summary> /// <param name="client">The Google Ads Client.</param> /// <param name="customerId">The customer's ID.</param> /// <param name="texts">The texts to add.</param> /// <returns>A list of asset resource names.</returns> private List<string> CreateMultipleTextAssets( GoogleAdsClient client, long customerId, string[] texts) { // Get the GoogleAdsService. GoogleAdsServiceClient googleAdsServiceClient = client.GetService(Services.V13.GoogleAdsService); MutateGoogleAdsRequest request = new MutateGoogleAdsRequest() { CustomerId = customerId.ToString() }; foreach (string text in texts) { request.MutateOperations.Add( new MutateOperation() { AssetOperation = new AssetOperation() { Create = new Asset() { TextAsset = new TextAsset() { Text = text } } } } ); } // Send the operations in a single Mutate request. MutateGoogleAdsResponse response = googleAdsServiceClient.Mutate(request); List<string> assetResourceNames = new List<string>(); foreach (MutateOperationResponse operationResponse in response.MutateOperationResponses) { MutateAssetResult assetResult = operationResponse.AssetResult; assetResourceNames.Add(assetResult.ResourceName); } PrintResponseDetails(response); return assetResourceNames; }
PHP
private static function createMultipleTextAssets( GoogleAdsClient $googleAdsClient, int $customerId, array $texts ): array { // Here again, we use the GoogleAdService to create multiple text assets in a single // request. $operations = []; foreach ($texts as $text) { // Creates a mutate operation for a text asset. $operations[] = new MutateOperation([ 'asset_operation' => new AssetOperation([ 'create' => new Asset(['text_asset' => new TextAsset(['text' => $text])]) ]) ]); } // Issues a mutate request to add all assets. $googleAdsService = $googleAdsClient->getGoogleAdsServiceClient(); /** @var MutateGoogleAdsResponse $mutateGoogleAdsResponse */ $mutateGoogleAdsResponse = $googleAdsService->mutate($customerId, $operations); $assetResourceNames = []; foreach ($mutateGoogleAdsResponse->getMutateOperationResponses() as $response) { /** @var MutateOperationResponse $response */ $assetResourceNames[] = $response->getAssetResult()->getResourceName(); } self::printResponseDetails($mutateGoogleAdsResponse); return $assetResourceNames; }
Python
def create_multiple_text_assets(client, customer_id, texts): """Creates multiple text assets and returns the list of resource names. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. texts: a list of strings, each of which will be used to create a text asset. Returns: asset_resource_names: a list of asset resource names. """ # Here again we use the GoogleAdService to create multiple text # assets in a single request. googleads_service = client.get_service("GoogleAdsService") operations = [] for text in texts: mutate_operation = client.get_type("MutateOperation") asset = mutate_operation.asset_operation.create asset.text_asset.text = text operations.append(mutate_operation) # Send the operations in a single Mutate request. response = googleads_service.mutate( customer_id=customer_id, mutate_operations=operations, ) asset_resource_names = [] for result in response.mutate_operation_responses: if result._pb.HasField("asset_result"): asset_resource_names.append(result.asset_result.resource_name) print_response_details(response) return asset_resource_names
Ruby
# Creates multiple text assets and returns the list of resource names. def create_multiple_text_assets(client, customer_id, texts) operations = texts.map do |text| client.operation.mutate do |m| m.asset_operation = client.operation.create_resource.asset do |asset| asset.text_asset = client.resource.text_asset do |text_asset| text_asset.text = text end end end end # Send the operations in a single Mutate request. response = client.service.google_ads.mutate( customer_id: customer_id, mutate_operations: operations, ) asset_resource_names = [] response.mutate_operation_responses.each do |result| if result.asset_result asset_resource_names.append(result.asset_result.resource_name) end end print_response_details(response) asset_resource_names end
Perl
sub create_multiple_text_assets { my ($api_client, $customer_id, $texts) = @_; # Here again we use the GoogleAdService to create multiple text assets in a # single request. my $operations = []; foreach my $text (@$texts) { # Create a mutate operation for a text asset. push @$operations, Google::Ads::GoogleAds::V13::Services::GoogleAdsService::MutateOperation ->new({ assetOperation => Google::Ads::GoogleAds::V13::Services::AssetService::AssetOperation-> new({ create => Google::Ads::GoogleAds::V13::Resources::Asset->new({ textAsset => Google::Ads::GoogleAds::V13::Common::TextAsset->new({ text => $text })})})}); } # Issue a mutate request to add all assets. my $mutate_google_ads_response = $api_client->GoogleAdsService()->mutate({ customerId => $customer_id, mutateOperations => $operations }); my $asset_resource_names = []; foreach my $response (@{$mutate_google_ads_response->{mutateOperationResponses}}) { push @$asset_resource_names, $response->{assetResult}{resourceName}; } print_response_details($mutate_google_ads_response); return $asset_resource_names; }
Asset groups
Each campaign requires at minimum one asset group. Assets are automatically mixed and matched based on which Google Ad channel (YouTube, Gmail, Search, etc.) your ad is being served on.
Automation generated assets
Google automation using machine learning generates additional assets as needed to cover all relevant channels.
If you don't add a video to your Performance Max asset group, then one or more video assets might be generated from the assets in your asset group. If you no longer want auto-generated videos to serve in your Performance Max campaign, then you can upload your own custom video, and the auto-generated videos will stop serving.