Nutzerliste erstellen

Sie können Nutzerlisten in Ihren Remarketing-Kampagnen verwenden, um Nutzer noch einmal anzusprechen, 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

Regelbasierte 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-Element enthält, das bestimmt, wie Regelelemente in Regelelementgruppen kombiniert werden.

Wenn rule_type auf OR_OF_ANDS (Standard) festgelegt ist, werden alle Regelelemente in einer Regelelement gruppe mit AND verknüpft. 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_ORSfestlegen, muss mindestens ein Regelelement in jeder Regelelementgruppe übereinstimmen, damit die Regel erfüllt ist. Dies 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 diese Regeln dafür erstellt 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::V24::Common::FlexibleRuleUserListInfo->new({
    inclusiveRuleOperator => AND,
    inclusiveOperands     => [
      Google::Ads::GoogleAds::V24::Common::FlexibleRuleOperandInfo->new({
          rule => Google::Ads::GoogleAds::V24::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

Vergangene Nutzer in eine regelbasierte Liste aufnehmen

Sie können auch vergangene Nutzer in eine regelbasierte Nutzerliste aufnehmen. Dazu legen Sie den prepopulation_status der Nutzerliste auf REQUESTED fest und prüfen regelmäßig den Status dieses Felds, um den Fortschritt des asynchronen Vorabfüllprozesses zu verfolgen.

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