ตัวปรับราคาเสนอ

ตัวปรับราคาเสนอช่วยให้คุณปรับราคาเสนอตามเกณฑ์ที่เฉพาะเจาะจงได้โดยไม่ต้องเปลี่ยนการกำหนดเป้าหมายของแคมเปญหรือกลุ่มโฆษณา เช่น ตัวปรับราคาเสนอระดับกลุ่มโฆษณาสําหรับอุปกรณ์เคลื่อนที่จะไม่รวมการแสดงผลสําหรับอุปกรณ์ประเภทอื่นๆ แต่จะช่วยให้คุณเพิ่มหรือลดราคาเสนอสําหรับการแสดงผลในอุปกรณ์เคลื่อนที่ได้

ตัวปรับแต่งจะตั้งเป็นตัวคูณจุดลอยตัวในช่อง bid_modifier เช่น ค่า 1.2 จะเพิ่มราคาเสนอ 20% ส่วนค่า 0.8 จะลดราคาเสนอ 20% สําหรับเกณฑ์ที่รองรับ (เช่น การยกเว้นประเภทอุปกรณ์) ค่า 0.0 (เทียบเท่ากับการปรับราคาเสนอ -100% ใน UI ของ Google Ads) จะเลือกไม่ใช้เกณฑ์ เมื่อมีการใช้ตัวปรับราคาเสนอหลายรายการกับการแสดงผล ระบบจะคูณตัวปรับราคาเสนอเหล่านั้นเข้าด้วยกันเพื่อคํานวณการปรับราคาเสนอสุดท้าย โปรดดูเอกสารอ้างอิง CampaignBidModifier และ AdGroupBidModifier สําหรับช่วง ค่าที่ถูกต้อง

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทํางานของการเสนอราคาและวิธีตั้งค่าตัวปรับราคาเสนอได้ใน ภาพรวมการเสนอราคาและคู่มือการจัดการตัวปรับราคาเสนอ

ตัวปรับราคาเสนอแคมเปญ

คุณระบุตัวปรับราคาเสนอที่ระดับแคมเปญสําหรับเกณฑ์ประเภทต่อไปนี้ได้โดยใช้ CampaignBidModifierService

InteractionTypeInfo
กําหนดเกณฑ์ InteractionTypeInfo โดยใช้ Enum ที่กําหนดไว้ล่วงหน้า InteractionType CALL เป็นค่า Enum ที่รองรับสําหรับตัวปรับราคาเสนอแคมเปญเท่านั้น การระบุค่าอื่นๆ จะแสดงผล CriterionError

ตัวปรับราคาเสนอระดับกลุ่มโฆษณา

คุณระบุตัวปรับราคาเสนอที่ระดับกลุ่มโฆษณาสําหรับประเภทเกณฑ์ต่อไปนี้ได้โดยใช้ AdGroupBidModifierService

DeviceInfo
กําหนดเกณฑ์ DeviceInfo โดยใช้ Enum ที่กําหนดไว้ล่วงหน้า Device
เกณฑ์การเดินทางต่างๆ
ใน v26 ขึ้นไป ให้ตั้งค่าตัวปรับสําหรับเกณฑ์แผนการเดินทางโดยใช้ เกณฑ์ที่ไม่ขึ้นอยู่กับแนวตั้ง ได้แก่ UserSetDatesInfo, AdvanceBookingWindowInfo, LengthOfBookingInfo, StartDayOfWeekInfo และ StartDateRangeInfo ใน v25 ลงไป ให้ตั้งค่า ตัวปรับเฉพาะโรงแรมสําหรับ HotelDateSelectionTypeInfo, HotelAdvanceBookingWindowInfo, HotelLengthOfStayInfo, HotelCheckInDayInfo และ HotelCheckInDateRangeInfo ดูรายละเอียดได้ใน คู่มือตัวปรับราคาเสนอโฆษณาโรงแรม

ตัวปรับราคาเสนอระดับเกณฑ์

นอกเหนือจากบริการตัวปรับราคาเสนอเฉพาะแล้ว เกณฑ์บางอย่างที่ตั้งค่าไว้ใน CampaignCriterion หรือ AdGroupCriterion ทรัพยากรยังรองรับการตั้งค่าช่อง bid_modifier โดยตรง (CampaignCriterion.bid_modifier หรือ AdGroupCriterion.bid_modifier เช่น เกณฑ์สถานที่ตั้ง การตั้งเวลาโฆษณา หรือข้อมูลประชากร)

ตัวอย่างโค้ด

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มตัวปรับราคาเสนอสําหรับอุปกรณ์เคลื่อนที่ระดับกลุ่มโฆษณา

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());
    }
  }
}
      

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;
    }
}
      

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;
        }
    }
      

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],
        )
    )
      

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
      

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;
}
      

curl