To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

Set Bids Manually

Bids can be set at different levels of the campaign hierarchy: campaign, ad group, or ad group criterion. A bid set at a lower level overrides those set at higher levels. For example, a bid set on an individual ad group within a campaign would override the campaign-level bid strategy's bid.

Update bids

Multiple bids of different types can be set simultaneously; for example, cpc_bid_micros and cpm_bid_micros can both be set, but only the bid that's relevant for the selected bidding strategy type is used.

When updating bids, you can just include the bids you want to update. Google Ads will then update those bids, but won't change, add, or remove the other bids.

The following code example updates the CPC bid of an existing ad group.

Java

 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 { 
  
 UpdateAdGroupParams 
  
 params 
  
 = 
  
 new 
  
 UpdateAdGroupParams 
 (); 
  
 if 
  
 ( 
 ! 
 params 
 . 
 parseArguments 
 ( 
 args 
 )) 
  
 { 
  
 // Either pass the required parameters for this example on the command line, or insert them 
  
 // into the code here. See the parameter class definition above for descriptions. 
  
 params 
 . 
 customerId 
  
 = 
  
 Long 
 . 
 parseLong 
 ( 
 "INSERT_CUSTOMER_ID_HERE" 
 ); 
  
 params 
 . 
 adGroupId 
  
 = 
  
 Long 
 . 
 parseLong 
 ( 
 "INSERT_AD_GROUP_ID_HERE" 
 ); 
  
 params 
 . 
 cpcBidMicroAmount 
  
 = 
  
 Long 
 . 
 parseLong 
 ( 
 "INSERT_CPC_BID_MICRO_AMOUNT_HERE" 
 ); 
  
 } 
  
 GoogleAdsClient 
  
 googleAdsClient 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 googleAdsClient 
  
 = 
  
 GoogleAdsClient 
 . 
 newBuilder 
 (). 
 fromPropertiesFile 
 (). 
 build 
 (); 
  
 } 
  
 catch 
  
 ( 
 FileNotFoundException 
  
 fnfe 
 ) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
  
 "Failed to load GoogleAdsClient configuration from file. Exception: %s%n" 
 , 
  
 fnfe 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ioe 
 ) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
 "Failed to create GoogleAdsClient. Exception: %s%n" 
 , 
  
 ioe 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 try 
  
 { 
  
 new 
  
 UpdateAdGroup 
 () 
  
 . 
 runExample 
 ( 
  
 googleAdsClient 
 , 
  
 params 
 . 
 customerId 
 , 
  
 params 
 . 
 adGroupId 
 , 
  
 params 
 . 
 cpcBidMicroAmount 
 ); 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 gae 
 ) 
  
 { 
  
 // GoogleAdsException is the base class for most exceptions thrown by an API request. 
  
 // Instances of this exception have a message and a GoogleAdsFailure that contains a 
  
 // collection of GoogleAdsErrors that indicate the underlying causes of the 
  
 // GoogleAdsException. 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
  
 "Request ID %s failed due to GoogleAdsException. Underlying errors:%n" 
 , 
  
 gae 
 . 
 getRequestId 
 ()); 
  
 int 
  
 i 
  
 = 
  
 0 
 ; 
  
 for 
  
 ( 
 GoogleAdsError 
  
 googleAdsError 
  
 : 
  
 gae 
 . 
 getGoogleAdsFailure 
 (). 
 getErrorsList 
 ()) 
  
 { 
  
 System 
 . 
 err 
 . 
 printf 
 ( 
 "  Error %d: %s%n" 
 , 
  
 i 
 ++ 
 , 
  
 googleAdsError 
 ); 
  
 } 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
 } 
   UpdateAdGroup 
 . 
 java

C#

 public 
  
 void 
  
 Run 
 ( 
 GoogleAdsClient 
  
 client 
 , 
  
 long 
  
 customerId 
 , 
  
 long 
  
 adGroupId 
 , 
  
 long? 
  
 cpcBidMicroAmount 
 ) 
 { 
  
 AdGroupServiceClient 
  
 adGroupService 
  
 = 
  
 client 
 . 
 GetService 
 ( 
 Services 
 . 
 V21 
 . 
 AdGroupService 
 ); 
  
 // Create an ad group with the specified ID. 
  
 AdGroup 
  
 adGroup 
  
 = 
  
 new 
  
 AdGroup 
 (); 
  
 adGroup 
 . 
 ResourceName 
  
 = 
  
 ResourceNames 
 . 
 AdGroup 
 ( 
 customerId 
 , 
  
 adGroupId 
 ); 
  
 // Pause the ad group. 
  
 adGroup 
 . 
 Status 
  
 = 
  
 AdGroupStatusEnum 
 . 
 Types 
 . 
 AdGroupStatus 
 . 
 Paused 
 ; 
  
 // Update the CPC bid if specified. 
  
 if 
  
 ( 
 cpcBidMicroAmount 
  
 != 
  
 null 
 ) 
  
 { 
  
 adGroup 
 . 
 CpcBidMicros 
  
 = 
  
 cpcBidMicroAmount 
 . 
 Value 
 ; 
  
 } 
  
 // Create the operation. 
  
 AdGroupOperation 
  
 operation 
  
 = 
  
 new 
  
 AdGroupOperation 
 () 
  
 { 
  
 Update 
  
 = 
  
 adGroup 
 , 
  
 UpdateMask 
  
 = 
  
 FieldMasks 
 . 
 AllSetFieldsOf 
 ( 
 adGroup 
 ) 
  
 }; 
  
 try 
  
 { 
  
 // Update the ad group. 
  
 MutateAdGroupsResponse 
  
 retVal 
  
 = 
  
 adGroupService 
 . 
 MutateAdGroups 
 ( 
  
 customerId 
 . 
 ToString 
 (), 
  
 new 
  
 AdGroupOperation 
 [] 
  
 { 
  
 operation 
  
 }); 
  
 // Display the results. 
  
 MutateAdGroupResult 
  
 adGroupResult 
  
 = 
  
 retVal 
 . 
 Results 
 [ 
 0 
 ]; 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Ad group with resource name '{adGroupResult.ResourceName}' " 
  
 + 
  
 "was updated." 
 ); 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 e 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 "Failure:" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Message: {e.Message}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Failure: {e.Failure}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Request ID: {e.RequestId}" 
 ); 
  
 throw 
 ; 
  
 } 
 } 
   UpdateAdGroup 
 . 
 cs

PHP

 public static function runExample( 
 GoogleAdsClient $googleAdsClient, 
 int $customerId, 
 int $adGroupId, 
 $bidMicroAmount 
 ) { 
 // Creates an ad group object with the specified resource name and other changes. 
 $adGroup = new AdGroup([ 
 'resource_name' => ResourceNames::forAdGroup($customerId, $adGroupId), 
 'cpc_bid_micros' => $bidMicroAmount, 
 'status' => AdGroupStatus::PAUSED 
 ]); 
 // Constructs an operation that will update the ad group with the specified resource name, 
 // using the FieldMasks utility to derive the update mask. This mask tells the Google Ads 
 // API which attributes of the ad group you want to change. 
 $adGroupOperation = new AdGroupOperation(); 
 $adGroupOperation->setUpdate($adGroup); 
 $adGroupOperation->setUpdateMask(FieldMasks::allSetFieldsOf($adGroup)); 
 // Issues a mutate request to update the ad group. 
 $adGroupServiceClient = $googleAdsClient->getAdGroupServiceClient(); 
 $response = $adGroupServiceClient->mutateAdGroups(MutateAdGroupsRequest::build( 
 $customerId, 
 [$adGroupOperation] 
 )); 
 // Prints the resource name of the updated ad group. 
 /** @var AdGroup $updatedAdGroup */ 
 $updatedAdGroup = $response->getResults()[0]; 
 printf( 
 "Updated ad group with resource name: '%s'%s", 
 $updatedAdGroup->getResourceName(), 
 PHP_EOL 
 ); 
 }  UpdateAdGroup.php

def main ( client : GoogleAdsClient , customer_id : str , ad_group_id : str , cpc_bid_micro_amount : int , ) - > None : ad_group_service : AdGroupServiceClient = client . get_service ( "AdGroupService" ) # Create ad group operation. ad_group_operation : AdGroupOperation = client . get_type ( "AdGroupOperation" ) ad_group : AdGroup = ad_group_operation . update ad_group . resource_name = ad_group_service . ad_group_path ( customer_id , ad_group_id ) ad_group . status = client . enums . AdGroupStatusEnum . PAUSED ad_group . cpc_bid_micros = cpc_bid_micro_amount client . copy_from ( ad_group_operation . update_mask , protobuf_helpers . field_mask ( None , ad_group . _pb ), ) operations : List [ AdGroupAdOperation ] = [ ad_group_operation ] # Update the ad group. ad_group_response : MutateAdGroupsResponse = ( ad_group_service . mutate_ad_groups ( customer_id = customer_id , operations = operations , ) ) print ( f "Updated ad group { ad_group_response . results [ 0 ] . resource_name } ." )

update_ad_group . py

def update_ad_group ( customer_id , ad_group_id , bid_micro_amount ) # GoogleAdsClient will read a config file from # ENV['HOME']/google_ads_config.rb when called without parameters client = Google :: Ads :: GoogleAds :: GoogleAdsClient . new resource_name = client . path . ad_group ( customer_id , ad_group_id ) operation = client . operation . update_resource . ad_group ( resource_name ) do | ag | ag . status = :PAUSED ag . cpc_bid_micros = bid_micro_amount end response = client . service . ad_group . mutate_ad_groups ( customer_id : customer_id , operations : [ operation ] , ) puts "Ad group with resource name = ' #{ response . results . first . resource_name } ' was updated." end

update_ad_group

. rb

sub update_ad_group { my ( $api_client , $customer_id , $ad_group_id , $cpc_bid_micro_amount ) = @_ ; # Create an ad group with the proper resource name and any other changes. my $ad_group = Google::Ads::GoogleAds::V21::Resources:: AdGroup - > new ({ resourceName = > Google::Ads::GoogleAds::V21::Utils::ResourceNames:: ad_group ( $customer_id , $ad_group_id ), status = > PAUSED , cpcBidMicros = > $cpc_bid_micro_amount }); # Create an ad group operation for update, using the FieldMasks utility to # derive the update mask. my $ad_group_operation = Google::Ads::GoogleAds::V21::Services::AdGroupService:: AdGroupOperation - > new ({ update = > $ad_group , updateMask = > all_set_fields_of ( $ad_group )}); # Update the ad group. my $ad_groups_response = $api_client - > AdGroupService () - > mutate ({ customerId = > $customer_id , operations = > [ $ad_group_operation ]}); printf "Updated ad group with resource name: '%s'.\n" , $ad_groups_response - > { results }[ 0 ]{ resourceName }; return 1 ; }

update_ad_group . pl

Display Network criteria dimensions

For ads running on the Display Network, there are a number of different dimensions for which an ad group bid can be set. If multiple bids are set in different dimensions, the display_custom_bid_dimension field can be used to specify the dimension that should be used for absolute bids. Ads on the Search Network always use keyword bids.

You can also set a bid adjustment to be used when the criterion is not in an absolute bidding dimension. It can be accessed using the bid_modifier field of the ad group criterion.

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-09-03 UTC.

Set Bids Manually

Update bids

Java

C#

PHP

Python

Ruby

Perl

Remove bids

Display Network criteria dimensions

Set Bids Manually Stay organized with collections Save and categorize content based on your preferences.

Update bids

Java

C#

PHP

Python

Ruby

Perl

Remove bids

Display Network criteria dimensions

Set Bids Manually