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 darum, regelbasierte Nutzerlisten mit den in Regelpostengruppen erstellen definierten Regelpostengruppen zu erstellen.

Regelbasierte Nutzerlisten

Regelbasierten Nutzerlisten, die mit flexible_rule_user_list erstellt wurden, können mehrere Regeln (inclusive_rule und exclusive_rule, verbunden durch inclusive_rule_operator) enthalten. Jede Regel wird durch eine UserListRuleInfo-Nachricht dargestellt, die ein rule_type-Feld hat, das bestimmt, wie Regelposten in Regelpostengruppen kombiniert werden.

Obwohl UserListRuleTypeEnum sowohl OR_OF_ANDS (disjunktive Normalform) als auch AND_OF_ORS (konjunktive Normalform) definiert, ist OR_OF_ANDS die einzige unterstützte rule_type für FlexibleRuleUserListInfo (wenn AND_OF_ORS festgelegt ist, wird UserListError.RULE_TYPE_IS_NOT_SUPPORTED zurückgegeben). Bei OR_OF_ANDS werden alle Regelposten in einer Regelpostengruppe in Google Ads AND, d. h., für eine bestimmte Regel muss jeder Regelposten in mindestens einer Regelpostengruppe übereinstimmen, damit die Regel erfüllt wird.

Nachdem Sie die beiden UserListRuleItemGroupInfo-Objekte in Regelpostengruppen erstellen definiert haben, können Sie sie in einer neuen Nutzerliste kombinieren. Im folgenden Codebeispiel wird der Standardregeltyp OR_OF_ANDS beibehalten, beide Regelpostengruppen werden einem FlexibleRuleOperandInfo für 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::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

Bisherige Nutzer in eine regelbasierte Liste aufnehmen

Sie können auch frühere Websitebesucher oder App-Nutzer in eine regelbasierte Nutzerliste aufnehmen (Nur Displaynetzwerk unterstützt), indem Sie die prepopulation_status der Nutzerliste auf REQUESTED festlegen. Den Fortschritt des asynchronen Vorabfüllvorgangs können Sie im Blick behalten, indem Sie den Status dieses Felds regelmäßig prüfen.

Beim Vorabausfüllen werden nur Nutzer aus den letzten 30 Tagen hinzugefügt, je nach membership_life_span der Liste (1 bis 540 Tage) 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.

Nutzerliste als Zielgruppe festlegen und Gebote anpassen

Nachdem Sie die UserList erstellt haben, hängen Sie den zugehörigen Ressourcennamen an eine AdGroupCriterion oder CampaignCriterion an und legen Sie bid_modifier fest (z. B. 1.25 für eine Gebotssteigerung von 25 %). Codebeispiele zum Ausrichten auf eine Nutzerliste und zum Ändern von Geboten finden Sie unter Auf die Liste ausrichten.

Zurück
Regelpostengruppen erstellen