Правила ценности конверсии

Правила ценности конверсии позволяют определять действия, которые изменят ценность конверсии на основе категории ConversionAction и следующих параметров показа:

  • Членство в аудитории
  • Физическое местоположение или интересующее место
  • Устройство

Вы можете использовать API Google Рекламы, чтобы определить правила ценности конверсии, объединить их в набор правил ценности конверсии, а затем применить этот набор правил ко всей учетной записи Google Рекламы или к определенной кампании. Сегменты в отчетах Google Ads API содержат разбивку, позволяющую сравнить исходную, нескорректированную и скорректированную часть ценности конверсий.

Создать правила

Первым шагом в использовании правил ценности конверсии является создание хотя бы одного ConversionValueRule , который состоит из:

  • Условия, определяющие применение правила
  • Действие, которое необходимо предпринять при применении правила

Условия правила

Определите условия ConversionValueRule с помощью следующих полей:

audience_condition
Применяет правило к показам, связанным с одной или несколькими аудиториями. Укажите имена ресурсов каждого списка пользователей или интересов пользователей с помощью полей user_lists или user_interests . Чтобы получить имена ресурсов доступных списков пользователей или интересов пользователей, выполните searchStream или search запрос GoogleAdsService , где предложение FROM запроса — user_list или user_interest соответственно.
Если audience_condition содержит несколько списков пользователей или интересов пользователей, показ будет соответствовать правилу, если показ связан с любым из списков пользователей или интересов пользователей.
device_condition
Применяет правило, если устройство показа соответствует любому из указанных device_types . Разрешены только типы устройств в ValueRuleDeviceType .
geo_location_condition
Применяет правило к показам, в которых информация о местоположении соответствует любой из указанных geo_target_constants для geo_match_type и не соответствует ни одной из excluded_geo_target_constants для excluded_geo_match_type . Обратитесь к руководству по геотаргетингу, чтобы узнать, как получить имена ресурсов местоположения.

Для каждого ConversionValueRule можно указать не более двух значений audience_condition , device_condition или geo_location_condition .

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

Действие правила

Правило должно иметь одно action , состоящее из operation и value . Действие определяет, как корректировать ценность конверсии, удовлетворяющей условиям правила. Доступны следующие операции.

ADD
Добавляет value к исходной ценности конверсии. value должно быть больше 0 .
MULTIPLY
Умножает исходное значение преобразования на указанное value . value должно быть больше или равно 0.5 и меньше или равно 10 .
SET

Устанавливает ценность преобразования в указанное value . value должно быть больше 0 .

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

Другие атрибуты правила

Помимо условий и действия, ConversionValueRule имеет следующие атрибуты.

owner_customer
Имя ресурса Customer , которому принадлежит правило. Используйте это, чтобы определить, определено ли правило в учетной записи или в одной из ее управляющих учетных записей.
status
Статус правила. Вы можете приостановить действие правила, установив для этого поля значение PAUSED , и включить приостановленное правило, установив для этого поля значение ENABLED .

Создание набора правил

Если у вас есть хотя бы один ConversionValueRule , вы можете создать ConversionValueRuleSet , который состоит из:

conversion_action_categories

Список категорий действий-конверсий, к которым применяется этот набор правил. Если список пуст, набор правил применяется ко всем категориям. Если список не пуст, он должен содержать одну запись STORE_VISIT или STORE_SALE .

Список категорий действий-конверсий можно задать только при создании набора правил.

conversion_value_rules

Имена ресурсов правил, которые необходимо включить в набор.

Этот список может содержать правило, использующее действие SET , только если выполнено любое из этих условий:

  • Ваша учетная запись внесена в белый список, а conversion_action_categories набора правил пусто.
  • conversion_action_categories набора содержит только одну запись STORE_VISIT или STORE_SALE , dimensions набора содержат только запись NO_CONDITION , и ни одно из полей условия правила не установлено.
dimensions

Список значений перечисления ValueRuleSetDimension , указывающий, какие условия могут использовать правила в наборе. Например, если dimensions содержат GEO_LOCATION и DEVICE , вы можете добавить в набор правила с geo_location_condition или device_condition , но вы не можете добавить правило с audience_condition .

Этот список не может быть пустым и может содержать не более двух записей.

Если этот список содержит запись для NO_CONDITION , то:

  • NO_CONDITION должен быть единственной записью в списке.
  • Список conversion_action_categories набора должен содержать только одну запись STORE_VISIT или STORE_SALE .
  • Список conversion_value_rules не может содержать ни одного правила, в котором заданы audience_condition , device_condition или geo_location_condition .

Первая запись в этом списке определяет, какое значение будет отображаться в отчетах для segments.conversion_value_rule_primary_dimension .

attachment_type

Установите для этого значения значение CUSTOMER , чтобы создать набор правил, применимый ко всей учетной записи, или CAMPAIGN , чтобы создать набор правил для конкретной кампании.

campaign

Если attachment_type набора правил — CAMPAIGN , задайте для него имя ресурса, к которому применяется набор правил.

Подобно правилам , набор правил также имеет owner_customer и status . Однако status набора правил доступен только для чтения и определяется его правилами следующим образом:

  • Если каждое правило, на которое ссылается conversion_value_rules имеет status PAUSED , то status набора правил ценности конверсии будет PAUSED .
  • В противном случае status набора правил ценности конверсии будет ENABLED .

Удаление правил и наборов правил

  • ConversionValueRuleSet должен иметь хотя бы одно правило ценности преобразования, которое имеет значение PAUSED или ENABLED .

  • Удаление ConversionValueRule , на которое есть ссылка в conversion_value_rules PAUSED или ENABLED ConversionValueRuleSet , завершится неудачно.

  • Удаление ConversionValueRuleSet не меняет status каждого ConversionValueRule , на который ссылается этот набор.

  • После удаления ConversionValueRuleSet запросы search и searchStream для ресурса conversion_value_rule_set больше не будут возвращать удаленный набор.

Приоритет правил и наборов правил

Google Реклама использует следующую логику для выбора и применения не более одного правила к каждой конверсии:

  1. Определите attachment_type наборов правил, которые следует учитывать. Если существуют какие-либо наборы правил с attachment_type = CAMPAIGN и campaign , заданной для кампании, связанной с показом, учитывайте только наборы правил на уровне кампании. В противном случае учитывайте только наборы правил на уровне клиента.

  2. Среди наборов правил, которые следует учитывать, выберите набор правил, в котором conversion_action_categories не пуста и содержит категорию действия-конверсии, если такой набор правил существует. В противном случае выберите набор правил, в котором conversion_action_categories пусты.

  3. Оцените правила в выбранном наборе правил в том порядке, в котором они указаны в conversion_value_rules , и выберите первое правило с условиями, соответствующими показу.

Составление отчетов

Поля metrics.conversions_value и metrics.all_conversions_value , а также поля, производные от этих показателей, отражают изменения, внесенные наборами правил ценности конверсии. Кроме того, вы можете включить segments.conversion_value_rule_primary_dimension в свой запрос, чтобы получить дополнительную информацию о том, как применялись правила. Возможные значения для этого сегмента следующие:

NO_RULE_APPLIED
Значения для конверсий, к которым не применялось правило.
ORIGINAL
Исходная ценность конверсий, к которым было применено правило.
GEO_LOCATION , DEVICE , AUDIENCE или NO_CONDITION .
Ценность конверсий после применения правила, сгруппированная по первой записи в коллекции dimensions набора правил.