您可以在广告系列层次结构的不同级别（广告系列、广告组或广告组条件）设置出价。较低级别设置的出价会覆盖较高级别设置的出价。例如，为广告系列中的单个广告组设置的出价会覆盖广告系列级出价策略的出价。
更新出价
您可以同时设置不同类型的多个出价；例如，cpc_bid_micros 和 cpm_bid_micros 均可设置，但系统只会使用与所选出价策略类型相关的出价。
更新出价时，只需添加要更新的出价即可。Google Ads 将更新这些出价，但不会更改、添加或移除其他出价。
以下代码示例更新现有广告组的每次点击费用出价。
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);
}
}
C#
public void Run(GoogleAdsClient client, long customerId, long adGroupId,
long? cpcBidMicroAmount)
{
AdGroupServiceClient adGroupService = client.GetService(Services.V16.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;
}
}
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
);
}
Python
def main(client, customer_id, ad_group_id, cpc_bid_micro_amount):
ad_group_service = client.get_service("AdGroupService")
# Create ad group operation.
ad_group_operation = client.get_type("AdGroupOperation")
ad_group = 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),
)
# Update the ad group.
ad_group_response = ad_group_service.mutate_ad_groups(
customer_id=customer_id, operations=[ad_group_operation]
)
print(f"Updated ad group {ad_group_response.results[0].resource_name}.")
Ruby
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
Perl
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::V16::Resources::AdGroup->new({
resourceName =>
Google::Ads::GoogleAds::V16::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::V16::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;
}
移除出价
要移除某个出价，请将其字段更新为 null。
展示广告网络的条件维度
对于在展示广告网络中投放的广告，您可以针对许多不同的维度设置广告组出价。如果在不同维度中设置了多个出价，可使用 display_custom_bid_dimension 字段指定应当用于绝对出价的维度。搜索网络上的广告始终使用关键字出价。
您还可以设置出价调整，以便在条件不在绝对出价维度中时使用。可以使用广告组条件的 bid_modifier 字段进行访问。