Assets in a Performance Max Campaign

Page Summary

Performance Max campaigns require a minimum number of different asset types.
Assets in Performance Max campaigns are organized into unique collections called AssetGroups.
Some assets can be automatically created through machine learning in Performance Max campaigns.
Reusing existing assets from other campaign types is possible when upgrading to Performance Max.
Automatically created text assets from page feeds require linking a page feed and ensuring TEXT_ASSET_AUTOMATION is opted in.
Auto-generated video assets can be replaced by uploading your own custom video, and you can opt out of enhanced YouTube video asset generation.

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.
Some assets can be generated automatically by machine learning.

Brand guidelines: business name and logo linkage

While most assets in a Performance Max campaign are organized within asset groups, key assets representing your brand's identity—specifically Business Nameand Business Logo—are handled differently if brand guidelines are enabled for your campaign.

These brand guideline assets are linked directly at the campaign level, not at the Asset Group level. This is done using the CampaignAsset resource. You link the asset to the campaign, specifying the appropriate AssetFieldType :

  * 
  
 `BUSINESS_NAME` 
  
 for 
  
 the 
  
 Business 
  
 Name 
  
 asset 
  
 ( 
 which 
  
 is 
  
 a 
  
 Text 
  
 Asset 
 ). 
 * 
  
 `LOGO` 
  
 for 
  
 the 
  
 Business 
  
 Logo 
  
 asset 
  
 ( 
 which 
  
 is 
  
 an 
  
 Image 
  
 Asset 
 ).

This campaign-level linkage ensures consistent brand representation across all asset groups within the Performance Max campaign.

Code example

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 
 ; 
 } 
   AddPerformanceMaxCampaign 
 . 
 java

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 
 . 
 V22 
 . 
 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 
 ; 
 } 
   AddPerformanceMaxCampaign 
 . 
 cs

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(MutateGoogleAdsRequest::build($customerId, $operations)); 
 $assetResourceNames = []; 
 foreach ($mutateGoogleAdsResponse->getMutateOperationResponses() as $response) { 
 /** @var MutateOperationResponse $response */ 
 $assetResourceNames[] = $response->getAssetResult()->getResourceName(); 
 } 
 self::printResponseDetails($mutateGoogleAdsResponse); 
 return $assetResourceNames; 
 }  AddPerformanceMaxCampaign.php

def create_multiple_text_assets ( client : GoogleAdsClient , customer_id : str , texts : List [ str ] ) - > List [ str ]: """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 : GoogleAdsServiceClient = client . get_service ( "GoogleAdsService" ) operations : List [ MutateOperation ] = [] for text in texts : mutate_operation : MutateOperation = client . get_type ( "MutateOperation" ) asset : Asset = mutate_operation . asset_operation . create asset . text_asset . text = text operations . append ( mutate_operation ) # Send the operations in a single Mutate request. response : MutateGoogleAdsResponse = googleads_service . mutate ( customer_id = customer_id , mutate_operations = operations , ) asset_resource_names : List [ str ] = [] 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

add_performance_max_campaign

. py

# 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

add_performance_max_campaign

. rb

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::V22::Services::GoogleAdsService:: MutateOperation - > new ({ assetOperation = > Google::Ads::GoogleAds::V22::Services::AssetService:: AssetOperation - > new ({ create = > Google::Ads::GoogleAds::V22::Resources:: Asset - > new ({ textAsset = > Google::Ads::GoogleAds::V22::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 ; }

add_performance_max_campaign . pl

Automatically created assets

Google automation using machine learning generates additional assets as needed to cover all relevant channels. Assets are automatically mixed and matched based on which Google Ad channel (such as YouTube, Gmail, or Search) your ad is being served on. For more details on managing these settings, see the asset automation settings guide .

Text assets

You can associate a page feed in your account with a Performance Max campaign to automatically generate assets .

To link a page feed with a campaign, use the same process as used for Dynamic Search Ads:

After you've associated a page feed, make sure the AssetAutomationSetting of type TEXT_ASSET_AUTOMATION is set to OPTED_IN . This is the default setting if you didn't set the AssetAutomationSetting when creating the campaign.

Using this setting means your campaign can use content from your landing page, domain, and provided assets to customize ads when predicted to improve performance. We recommend leaving this as OPTED-IN .

Video assets

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.

Smart automation may enhance your YouTube video assets by adjusting video orientation and intelligently shortening them to highlight key moments. If you prefer to maintain your original video assets, set the AssetAutomationSetting of type GENERATE_ENHANCED_YOUTUBE_VIDEOS to OPTED_OUT .

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-22 UTC.

Assets in a Performance Max Campaign

Page Summary

Brand guidelines: business name and logo linkage

Code example

Java

C#

PHP

Python

Ruby

Perl

Automatically created assets

Text assets

Video assets

Assets in a Performance Max Campaign Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Brand guidelines: business name and logo linkage

Code example

Java

C#

PHP

Python

Ruby

Perl

Automatically created assets

Text assets

Video assets

Assets in a Performance Max Campaign