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.