Создать список пользователей

В своих ремаркетинговых кампаниях вы можете использовать списки пользователей для повторного взаимодействия с пользователями, которые совершили определенные действия на вашем веб-сайте или в приложении. API Google Ads поддерживает несколько типов списков пользователей. В этом руководстве основное внимание уделяется созданию списков пользователей на основе правил с использованием групп элементов правил, определенных в разделе «Создание групп элементов правил» .

Списки пользователей на основе правил

Списки пользователей, созданные на основе правил с использованием flexible_rule_user_list могут содержать несколько правил ( inclusive_rule и exclusive_rule , объединенные оператором inclusive_rule_operator ). Каждое правило представлено сообщением UserListRuleInfo , которое имеет поле rule_type , определяющее, как объединяются элементы правил внутри групп элементов правил.

Although UserListRuleTypeEnum defines both OR_OF_ANDS (disjunctive normal form) and AND_OF_ORS (conjunctive normal form), OR_OF_ANDS is the only supported rule_type for FlexibleRuleUserListInfo (setting AND_OF_ORS returns UserListError.RULE_TYPE_IS_NOT_SUPPORTED ). With OR_OF_ANDS , Google Ads AND s together all rule items in a rule item group, which means that for a given rule, every rule item in at least one rule item group must match for the rule to be satisfied.

После определения двух объектов UserListRuleItemGroupInfo в разделе «Создание групп элементов правил» , объедините их в новый список пользователей. В следующем примере кода тип правила OR_OF_ANDS остается неизменным, обе группы элементов правил добавляются в объект FlexibleRuleOperandInfo на основе FlexibleRuleUserListInfo , и список пользователей изменяется:

Java 

FlexibleRuleUserListInfo flexibleRuleUserListInfo =
    FlexibleRuleUserListInfo.newBuilder()
        .setInclusiveRuleOperator(UserListFlexibleRuleOperator.AND)
        .addInclusiveOperands(
            FlexibleRuleOperandInfo.newBuilder()
                .setRule(
                    // The default rule_type for a UserListRuleInfo object is OR of ANDs
                    // (disjunctive normal form). That is, rule items will be ANDed together
                    // within rule item groups and the groups themselves will be ORed together.
                    UserListRuleInfo.newBuilder()
                        .addRuleItemGroups(checkoutDateRuleGroup)
                        .addRuleItemGroups(checkoutAndCartSizeRuleGroup))
                // Optional: includes a lookback window for this rule, in days.
                .setLookbackWindowDays(7L))
        .build();

C# 

FlexibleRuleUserListInfo flexibleRuleUserListInfo = new FlexibleRuleUserListInfo();
FlexibleRuleOperandInfo flexibleRuleOperandInfo = new FlexibleRuleOperandInfo() {
    Rule = new UserListRuleInfo()
};
flexibleRuleOperandInfo.Rule.RuleItemGroups.Add(checkoutAndCartSizeRuleGroup);
flexibleRuleOperandInfo.Rule.RuleItemGroups.Add(checkoutDateRuleGroup);
flexibleRuleUserListInfo.InclusiveOperands.Add(flexibleRuleOperandInfo);

PHP 

$flexibleRuleUserListInfo = new FlexibleRuleUserListInfo(
    [
    'inclusive_rule_operator' => UserListFlexibleRuleOperator::PBAND,
    'inclusive_operands' => [
        new FlexibleRuleOperandInfo(
            [
            'rule' => new UserListRuleInfo(
                [
                // The default rule_type for a UserListRuleInfo object is OR of ANDs
                // (disjunctive normal form). That is, rule items will be ANDed together
                // within rule item groups and the groups themselves will be ORed together.
                'rule_item_groups' => [
                    $checkoutAndCartSizeRuleGroup,
                    $checkoutDateRuleGroup
                ]
                ]
            ),
            // Optionally add a lookback window for this rule, in days.
            'lookback_window_days' => 7
            ]
        )
    ],
    'exclusive_operands' => []
    ]
);

Python 

# Create a FlexibleRuleUserListInfo object, or a flexible rule
# representation of visitors with one or multiple actions.
# FlexibleRuleUserListInfo wraps UserListRuleInfo in a
# FlexibleRuleOperandInfo object that represents which user lists to
# include or exclude.
flexible_rule_user_list_info: FlexibleRuleUserListInfo = (
    rule_based_user_list_info.flexible_rule_user_list
)
flexible_rule_user_list_info.inclusive_rule_operator = (
    client.enums.UserListFlexibleRuleOperatorEnum.AND
)
# The default rule_type for a UserListRuleInfo object is OR of
# ANDs (disjunctive normal form). That is, rule items will be
# ANDed together within rule item groups and the groups
# themselves will be ORed together.
rule_operand: FlexibleRuleOperandInfo = client.get_type(
    "FlexibleRuleOperandInfo"
)
rule_operand.rule.rule_item_groups.extend(
    [
        checkout_and_cart_size_rule_group,
        checkout_date_rule_group,
    ]
)
rule_operand.lookback_window_days = 7
flexible_rule_user_list_info.inclusive_operands.append(rule_operand)

Руби 

r.flexible_rule_user_list = client.resource.flexible_rule_user_list_info do |frul|
  frul.inclusive_rule_operator = :AND
  frul.inclusive_operands << client.resource.flexible_rule_operand_info do |froi|
    froi.rule = client.resource.user_list_rule_info do |info|
      info.rule_item_groups += [checkout_date_rule_group, checkout_and_cart_size_rule_group]
    end
    # Optionally include a lookback window for this rule, in days.
    froi.lookback_window_days = 7
  end
end

Perl 

my $flexible_rule_user_list_info =
  Google::Ads::GoogleAds::V25::Common::FlexibleRuleUserListInfo->new({
    inclusiveRuleOperator => AND,
    inclusiveOperands     => [
      Google::Ads::GoogleAds::V25::Common::FlexibleRuleOperandInfo->new({
          rule => Google::Ads::GoogleAds::V25::Common::UserListRuleInfo->new({
              # The default rule_type for a UserListRuleInfo object is OR of
              # ANDs (disjunctive normal form). That is, rule items will be
              # ANDed together within rule item groups and the groups
              # themselves will be ORed together.
              ruleItemGroups => [
                $checkout_date_rule_group, $checkout_and_cart_size_rule_group
              ]}
          ),
          # Optionally include a lookback window for this rule, in days.
          lookback_window_days => 7
        })
    ],
    exclusiveOperands => []});

локон

Включить бывших пользователей в список, созданный на основе правил.

Вы также можете включить бывших посетителей веб-сайта или пользователей приложения в список пользователей на основе правил (поддерживается только в контекстно-медийной сети ), установив для поля prepopulation_status списка пользователей значение REQUESTED , и отслеживать ход асинхронного процесса предварительного заполнения, периодически проверяя статус этого поля.

Функция предварительного заполнения добавляет только пользователей, которые были зарегистрированы в течение последних 30 дней, в зависимости от membership_life_span списка (от 1 до 540 дней) и даты добавления тега ремаркетинга. Статус обновляется на FINISHED после обработки запроса или FAILED , если запрос не выполнен.

Нацельтесь на список пользователей и скорректируйте ставки.

После создания UserList ) привяжите его имя ресурса к AdGroupCriterion ) или CampaignCriterion и установите bid_modifier (например, 1.25 для увеличения ставки на 25%). Примеры кода, демонстрирующие, как нацелиться на список пользователей и изменить ставки, см. в разделе «Нацеливание на список» .

Назад
Создание групп элементов правил