Sie können Nutzerlisten in Ihren Remarketing-Kampagnen verwenden, um Nutzer, die bestimmte Aktionen auf Ihrer Website oder in Ihrer App ausgeführt haben, noch einmal anzusprechen. Die Google Ads API unterstützt verschiedene Arten von Nutzerlisten. In diesem Leitfaden geht es um das Erstellen regelbasierter Nutzerlisten mit den Artikelgruppen, die unter Artikelgruppen erstellen definiert sind.
Regelbasierte Nutzerlisten
Regelbasierte 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 enthält, das festlegt, wie Regelelemente innerhalb von Artikelgruppen kombiniert werden.
In UserListRuleTypeEnum sind zwar sowohl OR_OF_ANDS (disjunktive Normalform) als auch AND_OF_ORS (konjunktive Normalform) definiert, aber OR_OF_ANDS ist die einzige unterstützte rule_type für FlexibleRuleUserListInfo. Wenn Sie AND_OF_ORS festlegen, wird UserListError.RULE_TYPE_IS_NOT_SUPPORTED zurückgegeben. Bei OR_OF_ANDS werden in Google Ads alle Regelelemente in einer Regelelementgruppe 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.
Nachdem Sie die beiden UserListRuleItemGroupInfo-Objekte in Regel-Artikelgruppen erstellen definiert haben, kombinieren Sie sie zu einer neuen Nutzerliste.
Im folgenden Codebeispiel wird der Standardregeltyp OR_OF_ANDS beibehalten, beide Regel-Artikelgruppen 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::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
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). Legen Sie dazu die prepopulation_status der Nutzerliste auf REQUESTED fest und prüfen Sie regelmäßig den Status dieses Felds, um den Fortschritt des asynchronen Vorab-Befüllungsprozesses zu überwachen.
Beim Vorabausfüllen werden nur Nutzer aus den letzten 30 Tagen hinzugefügt. Das 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 in FINISHED geändert, sobald die Anfrage verarbeitet wurde, oder in FAILED, wenn die Anfrage fehlschlägt.
Targeting auf die Nutzerliste ausrichten und Gebote anpassen
Nachdem Sie die UserList erstellt haben, hängen Sie den Ressourcennamen an eine AdGroupCriterion oder CampaignCriterion an und legen Sie bid_modifier fest (z. B. 1.25 für eine Gebotserhöhung um 25 %). Codebeispiele, die zeigen, wie Sie eine Nutzerliste als Ziel festlegen und Gebote ändern, finden Sie unter Target the list.