Tworzenie listy użytkowników

Listy użytkowników możesz wykorzystywać w kampaniach remarketingowych, aby ponownie angażować użytkowników, którzy wykonali określone działania w Twojej witrynie lub aplikacji. Interfejs Google Ads API obsługuje kilka typów list użytkowników. Ten przewodnik skupia się na tworzeniu list użytkowników opartych na regułach.

Listy użytkowników oparte na regułach

Listy użytkowników oparte na regułach utworzone za pomocą flexible_rule_user_list mogą zawierać wiele reguł. Każda reguła jest reprezentowana przez komunikat UserListRuleInfo, który ma pole rule_type określające sposób łączenia elementów reguły w grupach elementów reguły.

Jeśli rule_type ma wartość OR_OF_ANDS (domyślną), Google Ads połączy wszystkie elementy reguły w grupie elementów reguły za pomocą operatora AND. Oznacza to, że w przypadku danej reguły każdy element reguły w co najmniej 1 grupie elementów reguły musi pasować, aby reguła została spełniona. Jest to tzw. „alternatywna postać normalna”.

Jeśli ustawisz rule_type na AND_OF_ORS, to co najmniej 1 element reguły w każdej grupie elementów reguły musi pasować, aby reguła została spełniona. Jest to tzw. „koniunkcyjna postać normalna”.

Pozostało tylko połączyć grupy elementów reguły w nową listę użytkowników. W tym przypadku pozostawimy domyślną funkcję OR_OF_ANDS, ponieważ do tego celu zostały utworzone te reguły.

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)

Ruby

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 => []});

curl

Uwzględnianie poprzednich użytkowników na liście opartej na regułach

Możesz też uwzględnić poprzednich użytkowników na liście użytkowników opartej na regułach, ustawiając prepopulation_status listy użytkowników na REQUESTED, a postęp asynchronicznego procesu wstępnego wypełniania możesz śledzić, okresowo sprawdzając stan tego pola.

Spowoduje to dodanie tylko poprzednich użytkowników z ostatnich 30 dni, w zależności od okresu członkostwa na liście i daty dodania tagu remarketingowego. Gdy żądanie zostanie przetworzone, stan zmieni się na FINISHED , a jeśli żądanie się nie powiedzie, na FAILED.

Wstecz
Tworzenie grup elementów reguły