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 dieser Anleitung geht es um das Erstellen regelbasierter Nutzerlisten mit den in Artikelgruppengruppen erstellen definierten Artikelgruppengruppen.

Regelbasierte Nutzerlisten

Regelbasierte Nutzerlisten, die mit flexible_rule_user_list erstellt wurden, können mehrere Regeln (inclusive_rule und exclusive_rule, verknüpft durch inclusive_rule_operator) enthalten. Jede Regel wird durch eine UserListRuleInfo-Nachricht dargestellt, die ein rule_type-Feld enthält, das bestimmt, wie Regelposten in Artikelgruppen kombiniert werden.

In UserListRuleTypeEnum sind sowohl OR_OF_ANDS (disjunktive Normalform) als auch AND_OF_ORS (konjunktive Normalform) definiert. OR_OF_ANDS ist jedoch der einzige unterstützte rule_type für FlexibleRuleUserListInfo (wenn Sie AND_OF_ORS festlegen, wird UserListError.RULE_TYPE_IS_NOT_SUPPORTED zurückgegeben). Mit OR_OF_ANDS werden alle Regelposten in einer Regelpostengruppe in Google Ads mit AND verknüpft. Das bedeutet, dass für eine bestimmte Regel jeder Regelposten in mindestens einer Regelposten gruppe übereinstimmen muss, damit die Regel erfüllt ist.

Nachdem Sie die beiden UserListRuleItemGroupInfo Objekte in Regelpostengruppen erstellen definiert haben, können Sie sie zu einer neuen Nutzerliste kombinieren. Im folgenden Codebeispiel wird der Standardregeltyp OR_OF_ANDS beibehalten, beide Artikelgruppen werden einem FlexibleRuleOperandInfo in FlexibleRuleUserListInfo hinzugefügt und die Nutzerliste wird geändert:

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::V26::Common::FlexibleRuleUserListInfo->new({
    inclusiveRuleOperator => AND,
    inclusiveOperands     => [
      Google::Ads::GoogleAds::V26::Common::FlexibleRuleOperandInfo->new({
          rule => Google::Ads::GoogleAds::V26::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

Frühere Nutzer in eine regelbasierte Liste aufnehmen

Sie können auch frühere Websitebesucher oder App-Nutzer in eine regelbasierte Nutzer liste aufnehmen (nur im Displaynetzwerk). Dazu legen Sie für die Nutzerliste prepopulation_status auf REQUESTED fest und prüfen regelmäßig den Status dieses Felds, um den Fortschritt des asynchronen Prozesses zur Vorabfüllung zu verfolgen.

Bei der Vorabfüllung werden nur frühere Nutzer aus den letzten 30 Tagen hinzugefügt. Dies hängt von der membership_life_span der Liste (1 bis 540 Tage) und dem Datum ab, 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.

Nutzerliste ausrichten und Gebote anpassen

Nachdem Sie die UserList erstellt haben, fügen Sie den Ressourcennamen an ein AdGroupCriterion oder CampaignCriterion an und legen bid_modifier fest (z. B. 1.25 für eine Gebotsanpassung von 25% nach oben). Codebeispiele zum Ausrichten einer Nutzerliste und zum Anpassen von Geboten finden Sie unter Liste ausrichten.