Nutzerliste erstellen

Mit Nutzerlisten in Ihren Remarketing-Kampagnen können Sie Nutzer noch einmal ansprechen, die bestimmte Aktionen auf Ihrer Website oder in Ihrer App ausgeführt haben. Die Google Ads API unterstützt verschiedene Arten von Nutzerlisten. In diesem Leitfaden geht es um das Erstellen regelbasierter Nutzerlisten.

Regelbasierte Nutzerlisten

Regelbasierten Nutzerlisten, die mit flexible_rule_user_list erstellt wurden, können mehrere Regeln enthalten. Jede Regel wird durch eine UserListRuleInfo-Nachricht dargestellt, die ein rule_type enthält, das festlegt, wie die Regelposten in Regelpostengruppen kombiniert werden.

Wenn rule_type auf OR_OF_ANDS (Standard) festgelegt ist, werden alle Regelposten in einer Regelpostengruppe AND. Das bedeutet, dass für eine bestimmte Regel jedes Regelelement in mindestens einer Regelelementgruppe übereinstimmen muss, damit die Regel erfüllt ist. Dies wird als „disjunktive Normalform“ bezeichnet.

Wenn Sie rule_type auf AND_OF_ORS festlegen, muss mindestens ein Regelposten in jeder Regelpostengruppe übereinstimmen, damit die Regel erfüllt ist. Das wird als „konjunktive Normalform“ bezeichnet.

Jetzt müssen nur noch die Regelelementgruppen von oben in einer neuen Nutzerliste kombiniert werden: In diesem Fall behalten wir die Standardfunktion OR_OF_ANDS bei, da wir die Regeln dafür entwickelt haben.

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

Bisherige Nutzer in eine regelbasierte Liste aufnehmen

Sie können auch frühere Nutzer in eine regelbasierte Nutzerliste aufnehmen, indem Sie prepopulation_status der Nutzerliste auf REQUESTED festlegen und den Fortschritt des asynchronen Vorabfüllungsprozesses regelmäßig prüfen.

So werden nur Nutzer aus den letzten 30 Tagen hinzugefügt, je nach Mitgliedschaftsdauer der Liste und dem Datum, an dem das Remarketing-Tag hinzugefügt wird. Der Status wird auf FINISHED aktualisiert, sobald die Anfrage verarbeitet wurde, oder auf FAILED, wenn die Anfrage fehlschlägt.