اصلاح کننده های پیشنهادی را مدیریت کنید

نکته کلیدی: «تغییرکننده پیشنهاد قیمت» و «تعدیل قیمت پیشنهادی» معنی یکسانی دارند و به جای یکدیگر در رابط‌های کاربری و APIهای Google Ads استفاده می‌شوند.

تنظیمات پیشنهادی در سطح کمپین و گروه تبلیغات به شما کنترل بیشتری بر قیمت‌های پیشنهادی خود در کمپین‌های Google Ads می‌دهد و گزینه‌ای برای افزایش یا کاهش قیمت پیشنهادی برای انواع مختلف معیارها فراهم می‌کند.

در Google Ads API، تنظیمات سطح کمپین با استفاده از CampaignBidModifierService و تنظیمات در سطح گروه تبلیغات با استفاده از AdGroupBidModifierService قابل دسترسی هستند.

توجه: تعدیل پیشنهاد می تواند با هدف گذاری همراه باشد، برای جزئیات بیشتر به راهنمای هدف گذاری مراجعه کنید.

افزودن، به‌روزرسانی و حذف تنظیمات پیشنهادی

از فیلدهای create ، update یا remove عملیات CampaignBidModifierOperation یا AdGroupBidModifierOperation برای افزودن، اصلاح یا حذف تنظیمات پیشنهادی استفاده کنید.

توجه: برای محدوده معتبر مقادیر bid_modifier به اسناد CampaignBidModifier و AdGroupBidModifier API مراجعه کنید.

این مثال نشان می‌دهد که چگونه می‌توان یک تنظیم پیشنهادی تلفن همراه در سطح گروه تبلیغات جدید اضافه کرد:

جاوا

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
      

سی شارپ

public void Run(GoogleAdsClient client, long customerId, long adGroupId,
    double bidModifierValue)
{
    // Get the AdGroupBidModifierService.
    AdGroupBidModifierServiceClient adGroupBidModifierService =
        client.GetService(Services.V17.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, customer_id, ad_group_id, bid_modifier_value):
    ad_group_service = client.get_service("AdGroupService")
    ad_group_bm_service = 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 = client.get_type(
        "AdGroupBidModifierOperation"
    )
    ad_group_bid_modifier = 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 = client.enums.DeviceEnum
    ad_group_bid_modifier.device.type_ = device_enum.MOBILE

    # Add the ad group bid modifier.
    ad_group_bm_response = 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::V17::Resources::AdGroupBidModifier->new({
      adGroup => Google::Ads::GoogleAds::V17::Utils::ResourceNames::ad_group(
        $customer_id, $ad_group_id
      ),
      bidModifier => $bid_modifier_value,
      device      => Google::Ads::GoogleAds::V17::Common::DeviceInfo->new({
          type => MOBILE
        })});

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

بازیابی تنظیمات پیشنهادی

می‌توانید با جستجوی تمام مقادیر campaign_bid_modifier ، تنظیمات پیشنهادی موجود در سطح کمپین را بازیابی کنید. در سطح گروه آگهی، ad_group_bid_modifier را جستجو کنید. در اینجا یک پرس و جوی GAQL وجود دارد که تمام اصلاح کننده های پیشنهادی حساب مربوط به یک گروه تبلیغاتی معین را بازیابی می کند:

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

توجه: با تنظیم عبارت WHERE در مثال بالا، می‌توانید اصلاح‌کننده‌های پیشنهاد قیمت را در سطوح مختلف در یک تماس API واکشی کنید. برای مثال، برای بازیابی همه اصلاح‌کننده‌های پیشنهاد قیمت در یک کمپین، به جای ad_group.id ، روی campaign.id فیلتر کنید. یا می‌توانید بند WHERE را به‌طور کامل حذف کنید تا همه اصلاح‌کننده‌های پیشنهاد در کل یک حساب را بازیابی کنید.