입찰가 조정

입찰가 조정을 사용하면 캠페인 또는 광고그룹의 타겟팅을 변경하지 않고 특정 기준에 대한 입찰가를 조정할 수 있습니다. 예를 들어 휴대기기에 대한 광고그룹 입찰가 조정은 다른 기기 유형의 노출을 제외하지 않지만 모바일 노출에 대한 입찰가를 올리거나 내릴 수 있습니다.

수정자는 bid_modifier 필드에서 부동 소수점 곱수로 설정됩니다. 예를 들어 1.2 값은 입찰가를 20% 인상하고 0.8 값은 입찰가를 20% 인하합니다. 지원되는 기준 (예: 기기 유형 제외)의 경우 0.0 값(Google Ads UI의 -100% 입찰가 조정과 동일)은 기준을 선택 해제합니다. 여러 입찰가 조정이 노출에 적용되면 함께 곱해져 최종 입찰가 조정이 계산됩니다. 유효한 값 범위는 CampaignBidModifier 및 AdGroupBidModifier 참조 문서를 참고하세요.

입찰 작동 방식과 입찰가 조정 설정 방법에 대한 자세한 내용은 입찰 개요 및 입찰가 조정 관리 가이드를 참고하세요.

참고: 캠페인에서 스마트 자동 입찰 (예: 타겟 CPA 또는 타겟 ROAS)을 사용하는 경우 입찰가 조정은 전략 유형에 따라 다르게 작동하거나 무시될 수 있습니다. 예를 들어 타겟 CPA가 있는 기기 입찰가 조정은 입찰가 자체가 아니라 CPA 타겟을 조정합니다.

캠페인 입찰가 조정

`CampaignBidModifierService`를 사용하여 다음 기준 유형에 대한 입찰가 조정을 캠페인 수준에서 지정할 수 있습니다.

InteractionTypeInfo

미리 정의된 InteractionType enum 중 하나를 사용하여 InteractionTypeInfo 기준을 정의합니다. CALL 은 캠페인 입찰가 조정에 지원되는 유일한 enum 값입니다. 다른 값을 지정하면 CriterionError가 반환됩니다.

광고그룹 입찰가 조정

`AdGroupBidModifierService`를 사용하여 다음 기준 유형에 대한 입찰가 조정을 광고그룹 수준에서 지정할 수 있습니다.

DeviceInfo

미리 정의된 Device enum 중 하나를 사용하여 DeviceInfo 기준을 정의합니다.

다양한 여행 기준

v26 이상 에서는 업종에 관계없는 기준(UserSetDatesInfo, AdvanceBookingWindowInfo, LengthOfBookingInfo, StartDayOfWeekInfo, StartDateRangeInfo)을 사용하여 여행 일정 기준에 대한 수정자를 설정합니다. v25 이하에서는 다음 항목에 대한 호텔별 수정자를 설정합니다. HotelDateSelectionTypeInfo, HotelAdvanceBookingWindowInfo, HotelLengthOfStayInfo, HotelCheckInDayInfo 및 HotelCheckInDateRangeInfo 자세한 내용은 호텔 광고 입찰가 조정 가이드를 참고하세요.

기준 수준 입찰가 조정

전용 입찰가 조정 서비스 외에도 CampaignCriterion 또는 AdGroupCriterion 리소스에 설정된 특정 기준은 bid_modifier 필드를 직접 설정하는 것을 지원합니다. (CampaignCriterion.bid_modifier 또는 AdGroupCriterion.bid_modifier, 예: 위치, 광고 일정 또는 인구통계 기준)

참고: v25부터는 곱셈 bid_modifier를 사용하는 대신 여행용 검색 캠페인 (AI Max 검색 캠페인이 사용 설정되고 연결된 호텔 피드가 있는 검색 캠페인)의 특정 호텔 항목 (entity_bid.item_code)에 항목별 수동 CPC 입찰가 (cpc_bid_micros)를 EntityBid (CriterionType.VERTICAL_ADS_ITEM_BID) 기준을 사용하여 AdGroupCriterion에 설정할 수 있습니다. 이렇게 하려면 MANUAL_CPC 입찰이 필요합니다. 자세한 내용은 항목별 수동 CPC 입찰을 참고하세요.

코드 예

다음 코드 예는 광고그룹 수준 휴대기기 입찰가 조정을 추가하는 방법을 보여줍니다.

자바

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.V25.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
      

Python

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
      

Ruby

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
      

Perl

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::V25::Resources::AdGroupBidModifier->new({
      adGroup => Google::Ads::GoogleAds::V25::Utils::ResourceNames::ad_group(
        $customer_id, $ad_group_id
      ),
      bidModifier => $bid_modifier_value,
      device      => Google::Ads::GoogleAds::V25::Common::DeviceInfo->new({
          type => MOBILE
        })});

  # Create an ad group bid modifier operation.
  my $ad_group_bid_modifier_operation =
    Google::Ads::GoogleAds::V25::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
      

curl

참고: 이 단계에 대한 직접 REST 코드 샘플은 여기에 제공되지 않지만 수동 REST 요청을 사용하여 이 작업을 수행할 수 있습니다.

Google Ads API REST 인터페이스 문서 및 메서드별 참조 페이지를 참고하세요. 프로토 정의를 기반으로 JSON 페이로드를 구성해야 합니다.

주요 리소스:

• REST 사용
• REST 인터페이스 구조
• JSON 필드 매핑
• 특정 서비스 및 메서드는 REST API 참조를 참고하세요.