Ставки

В AdWords существует несколько способов назначения ставок. Выбор оптимальной стратегии зависит от специфики и целей вашего бизнеса.

В AdWords API управление всеми параметрами назначения ставок осуществляется с помощью следующих двух объектов:

В обоих этих объектах можно указать тип назначения ставок, используя поля biddingStrategyType и biddingScheme. Поле biddingScheme позволяет определить дополнительные параметры для типа назначения ставок. Если заданы оба поля, их типы должны совпадать.

Типы стратегий

В приведенной ниже таблице в столбце Допустимые контексты указано, можно ли использовать этот вариант назначения ставок (BiddingStrategyType) и тип схемы (BiddingScheme) в упомянутых выше контекстах:

  • Стандартная стратегия с объектом BiddingStrategyConfiguration.
  • Пакетная стратегия с объектом SharedBiddingStrategy.
BiddingStrategyType BiddingScheme Описательное название Допустимые контексты
BUDGET_OPTIMIZER

В версии 201702 и выше недоступен. Вместо него используйте TARGET_SPEND.

BudgetOptimizerBiddingScheme Оптимизатор бюджета Стандартная
CONVERSION_OPTIMIZER

В версии 201702 и выше недоступен. Вместо него используйте TARGET_CPA.

ConversionOptimizerBiddingScheme Плата за конверсии – использовать цену за конверсию Стандартная
ENHANCED_CPC EnhancedCpcBiddingScheme Оптимизатор цены за конверсию Пакетная
MANUAL_CPC ManualCpcBiddingScheme Плата за клики – использовать максимальные цены за клик Стандартная
MANUAL_CPM ManualCpmBiddingScheme Цена за тысячу показов в видимой области экрана

Предназначен для кампаний типа "Только контекстно-медийная сеть"

Стандартная
PAGE_ONE_PROMOTED PageOnePromotedBiddingScheme Целевое положение на странице поиска Пакетная
TARGET_CPA TargetCpaBiddingScheme Целевая цена за конверсию – необходимо соблюдение определенных требований Пакетная
Стандартная
TARGET_OUTRANK_SHARE TargetOutrankShareBiddingScheme Целевой процент выигрышей Пакетная
TARGET_ROAS TargetRoasBiddingScheme Целевая рентабельность инвестиций в рекламу – необходимо соблюдение определенных требований Пакетная
TARGET_SPEND

Параметр enhancedCpcEnabled можно задать только в стандартной стратегии.

TargetSpendBiddingScheme Максимальное количество кликов Пакетная
Стандартная
NONE Специальный тип стратегии назначения ставок. Используется для сброса стратегии назначения ставок на уровне AdGroup и AdGroupCriterion. Пакетная
Стандартная

При попытке использовать BiddingStrategyType или BiddingScheme в неправильном контексте вы получите следующие ошибки:

  • Использование только пакетного типа или схемы в контексте стандартной стратегии: ошибка BiddingErrors с причиной INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE.
  • Использование только стандартного типа или схемы в контексте пакетной стратегии: ошибка BiddingErrors с причиной BIDDING_STRATEGY_NOT_SUPPORTED.

Переопределение стандартных стратегий назначения ставок, назначенных на более высоких уровнях

В AdWords API версии 201705 и выше переопределять стратегии назначения ставок нельзя. Можно только задавать их на уровне кампании.

Стратегии на низком и высоком уровнях не могут различаться. Если на уровне групп объявлений вы зададите стратегию MANUAL_CPM, а на уровне кампаний – MANUAL_CPC, это приведет к ошибке.

Если на высоком уровне задана стратегия MANUAL_CPC, можно задать ещё одну стратегию MANUAL_CPC на более низком уровне, однако в таком случае лучше назначить ставки напрямую.

Переопределение целевой рентабельности инвестиций в рекламу на уровне группы объявлений

Если на уровне кампаний задана стратегия TargetRoasBiddingScheme, на уровне группы объявлений ее можно переопределить, установив параметр targetRoasOverride конфигурации назначения ставок. Другие поля переопределять нельзя.

Назначение ставок

Ставки можно назначать на уровне группы объявлений и критерия группы объявлений. Ставка для критерия переопределяет значение для группы объявлений.

В рамках одной стратегии можно одновременно назначить несколько ставок разного типа (например, CpcBid и CpmBid), но использоваться будет только та из них, которая соответствует выбранному варианту biddingStrategyType.

В отчетах тоже будет отображаться только активная в настоящий момент ставка. Она будет меняться при переходе на новый тип назначения.

В следующем примере используется вызов mutate, чтобы добавить цену за клик на уровне группы объявлений.

// Create ad group bid.
BiddingStrategyConfiguration biddingStrategyConfiguration =
    new BiddingStrategyConfiguration();
CpcBid bid = new CpcBid();
bid.setBid(new Money(null, 10000000L));

// You can optionally provide this field.
bid.setContentBid(new Money(null, 20000000L));

biddingStrategyConfiguration.setBids(new Bids[] {bid});
adGroup.setBiddingStrategyConfiguration(biddingStrategyConfiguration);

// Create operation.
AdGroupOperation operation = new AdGroupOperation();
operation.setOperand(adGroup);
operation.setOperator(Operator.SET);
AdGroupOperation[] operations = new AdGroupOperation[] {operation};

// Update ad group.
AdGroupReturnValue result = adGroupService.mutate(operations);

Удаление ставок

Чтобы удалить ставку из BiddingStrategyConfiguration, обновите поле bid, указав объект Money со значением 0 для microAmount.

Изменение стратегии назначения ставок

Чтобы изменить стратегию назначения ставок, создайте вызов mutate() соответствующей службы с обновленными полями стратегии. Ниже показано, как скорректировать тип назначения ставок в кампании, задав другое значение для biddingScheme.

// Create a new local Campaign object.
Campaign campaign = new Campaign();
campaign.setId(campaignId);

// Create a new biddingStrategyConfiguration.
BiddingStrategyConfiguration biddingStrategyConfiguration =
    new BiddingStrategyConfiguration();

// You can specify either type or scheme, or both.
biddingStrategyConfiguration.setBiddingScheme(new ManualCpcBiddingScheme());
campaign.setBiddingStrategyConfiguration(biddingStrategyConfiguration);

// Create SET operation.
CampaignOperation operation = new CampaignOperation();
operation.setOperand(campaign);
operation.setOperator(Operator.SET);
CampaignOperation[] operations = new CampaignOperation[] {operation};

// Update the campaign.
CampaignReturnValue result = campaignService.mutate(operations);

Пакетные стратегии назначения ставок

Вы можете использовать пакетные стратегии назначения ставок для своих кампаний, групп объявлений и ключевых слов. Стратегии более низкого уровня переопределяют стратегии более высокого, то есть стратегии на уровне ключевых слов переопределяют стратегии на уровне кампании и группы объявлений. В AdWords API версии 201705 и выше переопределять тип стратегии назначения ставок нельзя. При этом сами ставки переопределять можно.

Чтобы создать объект SharedBiddingStrategy и настроить его параметры, используйте службу BiddingStrategyService. Например, если вы хотите применить существующую пакетную стратегию назначения ставок, укажите ее идентификатор в объекте biddingStrategyConfiguration кампании:

BiddingStrategyConfiguration biddingStrategyConfiguration = new BiddingStrategyConfiguration();
biddingStrategyConfiguration.setBiddingStrategyId(strategyId);

campaign.setBiddingStrategyConfiguration(biddingStrategyConfiguration);

Параметры критериев для контекстно-медийной сети

У объявлений в контекстно-медийной сети имеется большое число параметров, по которым можно назначать ставку для группы объявлений. Если в разных параметрах заданы разные ставки, в поле contentBidCriterionTypeGroup можно указать параметр, который должен применяться для абсолютных ставок. Для объявлений, которые показываются в поисковой сети, всегда будет использоваться цена за клик для ключевого слова.

Также можно настроить корректировку ставок. Она применяется, когда критерий не относится к параметру назначения абсолютных ставок. Получить ее можно с помощью поля bidModifier объекта BiddableAdGroupCriterion.

Модификаторы ставок

Корректировки ставок на уровне кампании и группы объявлений позволяют повышать или понижать ставки для определенных критериев.

В AdWords API для доступа к корректировкам на уровне кампании можно использовать службы CampaignCriterionService и CampaignBidModifierService, а на уровне группы объявлений – AdGroupBidModifierService.

Получение корректировок

Чтобы получить корректировки ставок, используйте метод get() или query() службы CampaignCriterionService, AdGroupBidModifierService или CampaignBidModifierService. Как и в случае с другими службами, в методе get() используется стандартный селектор, который позволяет выбирать поля запроса и фильтровать результаты.

Приведенный ниже код извлекает первые 10 существующих критериев платформы на уровне кампании из всех кампаний.

// Get the CampaignCriterionService.
CampaignCriterionServiceInterface campaignCriterionService =
    adWordsServices.get(session, CampaignCriterionServiceInterface.class);

// Create a selector that limits to the first 10 platform criteria found.
Selector selector =
    new SelectorBuilder()
        .fields(
            CampaignCriterionField.CampaignId,
            CampaignCriterionField.Id,
            CampaignCriterionField.CriteriaType,
            CampaignCriterionField.BidModifier)
        .equals(CampaignCriterionField.CriteriaType, "PLATFORM")
        .equals(CampaignCriterionField.IsNegative, "false")
        .limit(10)
        .build();

// Make a 'get' request.
CampaignCriterionPage campaignCriterionPage = campaignCriterionService.get(selector);

// Display the results.
if (campaignCriterionPage.getEntries() != null) {
  for (CampaignCriterion campaignCriterion : campaignCriterionPage.getEntries()) {
    String value =
        campaignCriterion.getBidModifier() == null
            ? "unset"
            : String.format("%.2f", campaignCriterion.getBidModifier());
    System.out.printf(
        "Campaign ID %d, criterion ID %d has campaign level bid modifier %s.%n",
        campaignCriterion.getCampaignId(), campaignCriterion.getCriterion().getId(), value);
  }
} else {
  System.out.println("No campaign criteria found.");
}

Добавление, изменение и удаление корректировок

Чтобы добавить или изменить корректировку ставки, используйте метод mutate() службы CampaignCriterionService, AdGroupBidModifierService или CampaignBidModifierService.

  • Для добавления нового модификатора ставок используйте оператор ADD.
  • Изменить существующие корректировки ставок можно с помощью оператора SET.
  • Чтобы удалить переопределение модификатора ставок, используйте оператор REMOVE.
  • Если к существующим модификаторам CampaignBidModifier и AdGroupBidModifier или критерию AdGroupCriterion применить операцию ADD, она будет обработана как условие SET.

В этом примере показано, как добавить корректировку ставок для мобильных устройств на уровне кампании.

// Get the CampaignCriterionService.
CampaignCriterionServiceInterface campaignCriterionService =
    adWordsServices.get(session, CampaignCriterionServiceInterface.class);

// Create mobile platform. The ID can be found in the documentation.
// https://developers.google.com/adwords/api/docs/appendix/platforms
Platform mobile = new Platform();
mobile.setId(30001L);

// Create criterion with modified bid.
CampaignCriterion campaignCriterion = new CampaignCriterion();
campaignCriterion.setCampaignId(campaignId);
campaignCriterion.setCriterion(mobile);
campaignCriterion.setBidModifier(BID_MODIFIER);

// Create SET operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.setOperand(campaignCriterion);
operation.setOperator(Operator.SET);

// Update campaign criterion.
CampaignCriterionReturnValue result =
    campaignCriterionService.mutate(new CampaignCriterionOperation[] {operation});
for (CampaignCriterion campaignCriterionResult : result.getValue()) {
  System.out.printf("Campaign criterion with campaign ID %d, criterion ID %d, "
      + "and type '%s' was modified with bid %.4f.%n",
      campaignCriterionResult.getCampaignId(),
      campaignCriterionResult.getCriterion().getId(),
      campaignCriterionResult.getCriterion().getType(),
      campaignCriterionResult.getBidModifier());
}

Приведение кода в соответствие с новыми требованиями

Стратегии назначения ставок переопределяют нечасто, поэтому было решено их упростить. В AdWords API версии 201705 и выше стратегию назначения ставок нельзя переопределять на уровне групп объявлений и критериев ключевых слов. Это означает, что на этих уровнях нельзя назначать параметры biddingStrategyType, biddingStrategyId и biddingScheme. Стратегии назначения ставок можно устанавливать только на уровне кампаний. Исключение составляет параметр biddingStrategyType. На уровне групп объявлений и критериев ключевых слов для него можно устанавливать значение NONE.

Вот как привести код в соответствие с новыми требованиями:

  • Во всех версиях AdWords API есть возможность установить для параметра biddingStrategyType на уровне групп объявлений и критериев ключевых слов значение NONE. В таком случае на этих уровнях начнет действовать конфигурация стратегии, установленная на уровне кампании. Если для параметра biddingStrategyType будет указано значение NONE, все относящиеся к нему поля, например biddingStrategyId, будут очищены.
  • Если вам нужно установить для нескольких групп объявлений в рамках одной кампании разные стратегии назначения ставок, создайте кампанию для каждой из этих групп.

Оставить отзыв о...

Текущей странице
Нужна помощь? Обратитесь в службу поддержки.