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

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

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

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

Как создать правила

Чтобы начать использовать правила ценности конверсий, создайте хотя бы одно ConversionValueRule, которое состоит из следующих элементов:

• условия, определяющие, когда применяется правило;
• Действие, которое нужно выполнить при применении правила.

Примечание. Пока ConversionValueRule не будет добавлен в ConversionValueRuleSet, вы не сможете увидеть его в интерфейсе Google Рекламы.

Например, следующий код JSON для ConversionValueRuleService.MutateConversionValueRules создает правило, которое умножает ценность конверсий на 1.5 для показов на мобильных устройствах:

{
  "operations": [
    {
      "create": {
        "action": {
          "operation": "MULTIPLY",
          "value": 1.5
        },
        "deviceCondition": {
          "deviceTypes": ["MOBILE"]
        }
      }
    }
  ]
}

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

Задайте условия для 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. Инструкции по получению названий ресурсов местоположений приведены в руководстве по геотаргетингу.

itinerary_condition

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

Важно! Правила ценности конверсий на основе программы пребывания доступны только для аккаунтов, добавленных в белый список. Если вам нужен доступ к этой функции, обратитесь к представителю Google.

Для каждого элемента ConversionValueRule можно указать не более двух значений из следующих: audience_condition, device_condition, geo_location_condition или itinerary_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, а поля условий правила не заданы.

Важно! Каждое правило ценности конверсии можно включить только в один набор правил. Если conversion_value_rules содержит название ресурса правила, которое находится в conversion_value_rules другого набора правил с status, равным ENABLED или PAUSED, операция завершится ошибкой DATA_CONSTRAINT_VIOLATION.

dimensions

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

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

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

Если в списке есть запись NO_CONDITION, то:

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

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 Реклама выбирает и применяет к каждой конверсии не более одного правила, используя следующую логику: Дополнительную информацию об этих правилах можно найти в Справочном центре Google Рекламы:

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

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

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

4. Если условиям соответствуют несколько местоположений, применяется наиболее точное местоположение. Например, если показ соответствует условиям таргетинга и на США, и на Калифорнию, то будет применено условие таргетинга на Калифорнию, поскольку оно более точное.

5. Если условиям соответствуют несколько аудиторий, будет применена существующая иерархия атрибуции аудиторий. Если два правила имеют одинаковый приоритет, предпочтение отдается тому, где используется умножение, а не сложение. Если умножение используется в обоих правилах, выбирается правило с более высоким коэффициентом корректировки.

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

7. Для условий, связанных с маршрутом, применяется наиболее конкретное правило. Это означает, что если конверсия соответствует нескольким правилам, то будет применено правило с наибольшим количеством заданных параметров маршрута, таких как "Срок предварительного бронирования" или "Длительность путешествия".

Показатели

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

NO_RULE_APPLIED

Ценность конверсий, к которым не применялись правила.

ORIGINAL

Исходная ценность конверсий, к которым было применено правило.

GEO_LOCATION, DEVICE, AUDIENCE и NO_CONDITION

Ценность конверсий после применения правила, сгруппированная по первому элементу в коллекции dimensions набора правил.