Puoi utilizzare gli elenchi di utenti nelle tue campagne di remarketing per coinvolgere nuovamente gli utenti che hanno eseguito azioni specifiche sul tuo sito web o nella tua app. L'API Google Ads supporta diversi tipi di elenchi di utenti. Questa guida si concentra sulla creazione di elenchi di utenti basati su regole utilizzando i gruppi di articoli delle regole definiti in Crea gruppi di articoli delle regole.
Elenchi di utenti basati su regole
Gli elenchi di utenti basati su regole creati con flexible_rule_user_list possono contenere più regole (inclusive_rule e exclusive_rule, unite da inclusive_rule_operator). Ogni regola è rappresentata da un messaggio UserListRuleInfo, che contiene un campo rule_type che determina il modo in cui vengono combinati gli elementi delle regole all'interno dei gruppi di articoli delle regole.
Sebbene UserListRuleTypeEnum definisca sia
OR_OF_ANDS (forma normale disgiuntiva) sia
AND_OF_ORS (forma normale congiuntiva), OR_OF_ANDS è l'unico
rule_type supportato per FlexibleRuleUserListInfo
(l'impostazione AND_OF_ORS restituisce
UserListError.RULE_TYPE_IS_NOT_SUPPORTED). Con
OR_OF_ANDS, Google Ads AND tutti gli elementi regola in un gruppo di elementi regola, il che
significa che per una determinata regola, ogni elemento regola in almeno un gruppo di elementi regola deve corrispondere affinché la regola sia soddisfatta.
Dopo aver definito i due oggetti UserListRuleItemGroupInfo in Crea gruppi di elementi delle regole, combinali in un nuovo elenco di utenti.
L'esempio di codice seguente lascia invariato il tipo di regola OR_OF_ANDS predefinito, aggiunge entrambi i gruppi di articoli della regola a un FlexibleRuleOperandInfo su FlexibleRuleUserListInfo e modifica l'elenco di utenti:
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
Includi gli utenti precedenti in un elenco basato su regole
Puoi anche includere i visitatori del sito web o gli utenti dell'app precedenti in un elenco di utenti basato su regole (supportato solo sulla Rete Display) impostando prepopulation_status dell'elenco di utenti su REQUESTED e monitorare l'avanzamento del processo di precompilazione asincrona controllando periodicamente lo stato di questo campo.
Il pre-popolamento aggiunge solo gli utenti degli ultimi 30 giorni, a seconda della membership_life_span dell'elenco (da 1 a 540 giorni) e della data in cui è stato aggiunto il tag di remarketing. Lo stato viene aggiornato a
FINISHED una volta elaborata la richiesta o a
FAILED se la richiesta non va a buon fine.
Scegli come target l'elenco utenti e aggiusta le offerte
Dopo aver creato UserList, associa il nome della risorsa a un
AdGroupCriterion o
CampaignCriterion e imposta bid_modifier (ad esempio,
1.25 per un aumento dell'offerta del 25%). Per esempi di codice che mostrano come scegliere come target un elenco di utenti e modificare le offerte, consulta Scegliere l'elenco come target.