Tworzenie listy użytkowników

List 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ą tagu flexible_rule_user_list mogą zawierać wiele reguł. Każda reguła jest reprezentowana przez komunikat UserListRuleInfo, który zawiera rule_type określający sposób łączenia elementów reguł w grupach elementów reguł.

Jeśli wartość rule_type to OR_OF_ANDS (wartość domyślna), Google Ads będzie AND wszystkie elementy reguły w grupie elementów reguły. Oznacza to, że w przypadku danej reguły każdy element regułyco najmniej 1 grupie elementów reguły musi być zgodny, aby reguła została spełniona. Jest to tzw. „alternatywna postać normalna”.

Jeśli ustawisz wartość rule_type na AND_OF_ORS, co najmniej 1 element regułykaż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ć powyższe 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::V22::Common::FlexibleRuleUserListInfo->new({
    inclusiveRuleOperator => AND,
    inclusiveOperands     => [
      Google::Ads::GoogleAds::V22::Common::FlexibleRuleOperandInfo->new({
          rule => Google::Ads::GoogleAds::V22::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 => []});
      

Dodawanie użytkowników, którzy korzystali z usługi w przeszłości, do listy opartej na regułach

Możesz też uwzględnić na liście użytkowników opartej na regułach użytkowników z przeszłości, ustawiając wartość prepopulation_status listy użytkowników na REQUESTED i monitorując postępy asynchronicznego procesu wstępnego wypełniania, okresowo sprawdzając stan tego pola.

Spowoduje to dodanie tylko użytkowników z ostatnich 30 dni, w zależności od czasu trwania członkostwa na liście i daty dodania tagu remarketingowego. Gdy prośba zostanie przetworzona, stan zmieni się na FINISHED, a jeśli się nie uda – na FAILED.