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

Manage Bid Modifiers

Campaign and ad group-level bid adjustments give you more control over your bids in Google Ads campaigns, providing the option to increase or decrease bids for different types of criteria.

Within the Google Ads API, campaign-level adjustments are accessible using CampaignBidModifierService and ad group-level adjustments are accessible using AdGroupBidModifierService .

Add, update, and remove bid adjustments

Use the create , update or remove fields of CampaignBidModifierOperation or AdGroupBidModifierOperation operations to add, amend or remove bid adjustments.

This example demonstrates how to add a new ad group-level mobile bid adjustment:

Java

 private 
  
 void 
  
 runExample 
 ( 
  
 GoogleAdsClient 
  
 googleAdsClient 
 , 
  
 long 
  
 customerId 
 , 
  
 long 
  
 adGroupId 
 , 
  
 double 
  
 bidModifier 
 ) 
  
 { 
  
 // Creates an ad group bid modifier for mobile devices with the specified ad group ID and 
  
 // bid modifier value. 
  
 AdGroupBidModifier 
  
 adGroupBidModifier 
  
 = 
  
 AdGroupBidModifier 
 . 
 newBuilder 
 () 
  
 . 
 setAdGroup 
 ( 
 ResourceNames 
 . 
 adGroup 
 ( 
 customerId 
 , 
  
 adGroupId 
 )) 
  
 . 
 setBidModifier 
 ( 
 bidModifier 
 ) 
  
 . 
 setDevice 
 ( 
 DeviceInfo 
 . 
 newBuilder 
 (). 
 setType 
 ( 
 Device 
 . 
 MOBILE 
 )) 
  
 . 
 build 
 (); 
  
 // Creates an ad group bid modifier operation for creating an ad group bid modifier. 
  
 AdGroupBidModifierOperation 
  
 adGroupBidModifierOperation 
  
 = 
  
 AdGroupBidModifierOperation 
 . 
 newBuilder 
 (). 
 setCreate 
 ( 
 adGroupBidModifier 
 ). 
 build 
 (); 
  
 // Issues a mutate request to add the ad group bid modifier. 
  
 try 
  
 ( 
 AdGroupBidModifierServiceClient 
  
 adGroupBidModifierServiceClient 
  
 = 
  
 googleAdsClient 
 . 
 getLatestVersion 
 (). 
 createAdGroupBidModifierServiceClient 
 ()) 
  
 { 
  
 MutateAdGroupBidModifiersResponse 
  
 response 
  
 = 
  
 adGroupBidModifierServiceClient 
 . 
 mutateAdGroupBidModifiers 
 ( 
  
 Long 
 . 
 toString 
 ( 
 customerId 
 ), 
  
 ImmutableList 
 . 
 of 
 ( 
 adGroupBidModifierOperation 
 )); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Added %d ad group bid modifiers:%n" 
 , 
  
 response 
 . 
 getResultsCount 
 ()); 
  
 for 
  
 ( 
 MutateAdGroupBidModifierResult 
  
 mutateAdGroupBidModifierResult 
  
 : 
  
 response 
 . 
 getResultsList 
 ()) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "\t%s%n" 
 , 
  
 mutateAdGroupBidModifierResult 
 . 
 getResourceName 
 ()); 
  
 } 
  
 } 
 } 
   AddAdGroupBidModifier 
 . 
 java

C#

 public 
  
 void 
  
 Run 
 ( 
 GoogleAdsClient 
  
 client 
 , 
  
 long 
  
 customerId 
 , 
  
 long 
  
 adGroupId 
 , 
  
 double 
  
 bidModifierValue 
 ) 
 { 
  
 // Get the AdGroupBidModifierService. 
  
 AdGroupBidModifierServiceClient 
  
 adGroupBidModifierService 
  
 = 
  
 client 
 . 
 GetService 
 ( 
 Services 
 . 
 V21 
 . 
 AdGroupBidModifierService 
 ); 
  
 // Creates an ad group bid modifier for mobile devices with the specified ad group 
  
 // ID and bid modifier value. 
  
 AdGroupBidModifier 
  
 adGroupBidModifier 
  
 = 
  
 new 
  
 AdGroupBidModifier 
 () 
  
 { 
  
 AdGroup 
  
 = 
  
 ResourceNames 
 . 
 AdGroup 
 ( 
 customerId 
 , 
  
 adGroupId 
 ), 
  
 BidModifier 
  
 = 
  
 bidModifierValue 
 , 
  
 Device 
  
 = 
  
 new 
  
 DeviceInfo 
 () 
  
 { 
  
 Type 
  
 = 
  
 Device 
 . 
 Mobile 
  
 } 
  
 }; 
  
 // Creates an ad group bid modifier operation for creating an ad group bid modifier. 
  
 AdGroupBidModifierOperation 
  
 adGroupBidModifierOperation 
  
 = 
  
 new 
  
 AdGroupBidModifierOperation 
 () 
  
 { 
  
 Create 
  
 = 
  
 adGroupBidModifier 
  
 }; 
  
 // Send the operation in a mutate request. 
  
 try 
  
 { 
  
 MutateAdGroupBidModifiersResponse 
  
 response 
  
 = 
  
 adGroupBidModifierService 
 . 
 MutateAdGroupBidModifiers 
 ( 
 customerId 
 . 
 ToString 
 (), 
  
 new 
  
 AdGroupBidModifierOperation 
 [] 
  
 { 
  
 adGroupBidModifierOperation 
  
 }); 
  
 Console 
 . 
 WriteLine 
 ( 
 "Added {0} ad group bid modifiers:" 
 , 
  
 response 
 . 
 Results 
 . 
 Count 
 ); 
  
 foreach 
  
 ( 
 MutateAdGroupBidModifierResult 
  
 result 
  
 in 
  
 response 
 . 
 Results 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 $"\t{result.ResourceName}" 
 ); 
  
 } 
  
 } 
  
 catch 
  
 ( 
 GoogleAdsException 
  
 e 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
 "Failure:" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Message: {e.Message}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Failure: {e.Failure}" 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Request ID: {e.RequestId}" 
 ); 
  
 throw 
 ; 
  
 } 
 } 
   AddAdGroupBidModifier 
 . 
 cs

PHP

 public static function runExample( 
 GoogleAdsClient $googleAdsClient, 
 int $customerId, 
 int $adGroupId, 
 float $bidModifierValue 
 ) { 
 // Creates an ad group bid modifier for mobile devices with the specified ad group ID and 
 // bid modifier value. 
 $adGroupBidModifier = new AdGroupBidModifier([ 
 'ad_group' => ResourceNames::forAdGroup($customerId, $adGroupId), 
 'bid_modifier' => $bidModifierValue, 
 'device' => new DeviceInfo(['type' => Device::MOBILE]) 
 ]); 
 // Creates an ad group bid modifier operation for creating an ad group bid modifier. 
 $adGroupBidModifierOperation = new AdGroupBidModifierOperation(); 
 $adGroupBidModifierOperation->setCreate($adGroupBidModifier); 
 // Issues a mutate request to add the ad group bid modifier. 
 $adGroupBidModifierServiceClient = $googleAdsClient->getAdGroupBidModifierServiceClient(); 
 $response = $adGroupBidModifierServiceClient->mutateAdGroupBidModifiers( 
 MutateAdGroupBidModifiersRequest::build($customerId, [$adGroupBidModifierOperation]) 
 ); 
 printf("Added %d ad group bid modifier:%s", $response->getResults()->count(), PHP_EOL); 
 foreach ($response->getResults() as $addedAdGroupBidModifier) { 
 /** @var AdGroupBidModifier $addedAdGroupBidModifier */ 
 print $addedAdGroupBidModifier->getResourceName() . PHP_EOL; 
 } 
 }  AddAdGroupBidModifier.php

def main ( client : GoogleAdsClient , customer_id : str , ad_group_id : str , bid_modifier_value : float , ) - > None : ad_group_service : AdGroupServiceClient = client . get_service ( "AdGroupService" ) ad_group_bm_service : AdGroupBidModifierServiceClient = client . get_service ( "AdGroupBidModifierService" ) # Create ad group bid modifier for mobile devices with the specified ad # group ID and bid modifier value. ad_group_bid_modifier_operation : AdGroupBidModifierOperation = ( client . get_type ( "AdGroupBidModifierOperation" ) ) ad_group_bid_modifier : AdGroupBidModifier = ( ad_group_bid_modifier_operation . create ) # Set the ad group. ad_group_bid_modifier . ad_group = ad_group_service . ad_group_path ( customer_id , ad_group_id ) # Set the bid modifier. ad_group_bid_modifier . bid_modifier = bid_modifier_value # Sets the device. device_enum : DeviceEnum = client . enums . DeviceEnum ad_group_bid_modifier . device . type_ = device_enum . MOBILE # Add the ad group bid modifier. ad_group_bm_response : MutateAdGroupBidModifiersResponse = ( ad_group_bm_service . mutate_ad_group_bid_modifiers ( customer_id = customer_id , operations = [ ad_group_bid_modifier_operation ], ) )

add_ad_group_bid_modifier . py

def add_ad_group_bid_modifier ( customer_id , ad_group_id , bid_modifier_value ) # GoogleAdsClient will read a config file from # ENV['HOME']/google_ads_config.rb when called without parameters client = Google :: Ads :: GoogleAds :: GoogleAdsClient . new # Creates an ad group bid modifier for mobile devices with the specified # ad group ID and bid modifier value. ad_group_bid_modifier = client . resource . ad_group_bid_modifier do | mod | # Sets the ad group. mod . ad_group = client . path . ad_group ( customer_id , ad_group_id ) # Sets the Bid Modifier. mod . bid_modifier = bid_modifier_value # Sets the Device. mod . device = client . resource . device_info do | device | device . type = :MOBILE end end # Create the operation. operation = client . operation . create_resource . ad_group_bid_modifier ( ad_group_bid_modifier ) # Add the ad group ad. response = client . service . ad_group_bid_modifier . mutate_ad_group_bid_modifiers ( customer_id : customer_id , operations : [ operation ] ) puts "Added #{ response . results . size } ad group bid modifiers:" response . results . each do | added_ad_group_bid_modifier | puts " \t #{ added_ad_group_bid_modifier . resource_name } " end end

add_ad_group_bid_modifier

. rb

sub add_ad_group_bid_modifier { my ( $api_client , $customer_id , $ad_group_id , $bid_modifier_value ) = @_ ; # Create an ad group bid modifier for mobile devices with the specified ad group ID and # bid modifier value. my $ad_group_bid_modifier = Google::Ads::GoogleAds::V21::Resources:: AdGroupBidModifier - > new ({ adGroup = > Google::Ads::GoogleAds::V21::Utils::ResourceNames:: ad_group ( $customer_id , $ad_group_id ), bidModifier = > $bid_modifier_value , device = > Google::Ads::GoogleAds::V21::Common:: DeviceInfo - > new ({ type = > MOBILE })}); # Create an ad group bid modifier operation. my $ad_group_bid_modifier_operation = Google::Ads::GoogleAds::V21::Services::AdGroupBidModifierService:: AdGroupBidModifierOperation - > new ({ create = > $ad_group_bid_modifier }); # Add the ad group bid modifier. my $ad_group_bid_modifiers_response = $api_client - > AdGroupBidModifierService () - > mutate ({ customerId = > $customer_id , operations = > [ $ad_group_bid_modifier_operation ]}); printf "Created ad group bid modifier '%s'.\n" , $ad_group_bid_modifiers_response - > { results }[ 0 ]{ resourceName }; return 1 ; }

add_ad_group_bid_modifier . pl

Retrieve bid adjustments

You can retrieve existing campaign-level bid adjustments by looking for all the campaign_bid_modifier values. At the ad group level, search for ad_group_bid_modifier . Here is a GAQL query that retrieves all bid modifiers of the account that are related to a given ad group:

 SELECT 
  
 campaign 
 . 
 id 
 , 
  
 ad_group 
 . 
 id 
 , 
  
 ad_group_bid_modifier 
 . 
 bid_modifier 
 , 
  
 ad_group_bid_modifier 
 . 
 criterion_id 
 FROM 
  
 ad_group_bid_modifier 
 WHERE 
  
 ad_group 
 . 
 id 
  
 = 
  
  ad_group_id

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.

Manage Bid Modifiers

Add, update, and remove bid adjustments

Java

C#

PHP

Python

Ruby

Perl

Retrieve bid adjustments

Manage Bid Modifiers Stay organized with collections Save and categorize content based on your preferences.

Add, update, and remove bid adjustments

Java

C#

PHP

Python

Ruby

Perl

Retrieve bid adjustments

Manage Bid Modifiers