Creare un elenco di utenti

Puoi utilizzare gli elenchi di utenti nelle 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.

Elenchi di utenti basati su regole

Gli elenchi di utenti basati su regole create con flexible_rule_user_list possono contenere più regole. Ogni regola è rappresentata da un messaggio UserListRuleInfo, che ha un rule_type che determina la modalità di combinazione degli elementi delle regole all'interno dei gruppi di elementi delle regole.

Se rule_type è OR_OF_ANDS (impostazione predefinita), Google Ads AND tutti gli elementi regola in un gruppo di elementi regola. Ciò significa che, per una determinata regola, ogni elemento della regola in almeno un gruppo di elementi della regola deve corrispondere affinché la regola sia soddisfatta. Questa forma è chiamata "forma normale disgiuntiva".

In alternativa, se imposti rule_type su AND_OF_ORS, almeno un elemento della regola in ogni gruppo di elementi della regola deve corrispondere affinché la regola sia soddisfatta. Questa forma è chiamata "forma normale congiuntiva".

Non ti resta che combinare i gruppi di elementi delle regole precedenti in un nuovo elenco di utenti. In questo caso, lasceremo in vigore la funzionalità OR_OF_ANDS predefinita, poiché è per questo che abbiamo creato queste regole.

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();
SetUpAdvancedRemarketing.java

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);
SetUpAdvancedRemarketing.cs

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' => []
]);
SetUpAdvancedRemarketing.php

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)
set_up_advanced_remarketing.py

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
set_up_advanced_remarketing.rb

Perl

my $flexible_rule_user_list_info =
  Google::Ads::GoogleAds::V22::Common::FlexibleRuleUserListInfo->new({
    inclusiveRuleOperator => AND,
    inclusiveOperands     => [
      Google::Ads::GoogleAds::V22::Common::FlexibleRuleOperandInfo->new({
          rule => Google::Ads::GoogleAds::V22::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 => []});
set_up_advanced_remarketing.pl

Includere utenti passati in un elenco basato su regole

Puoi anche includere gli utenti passati in un elenco utenti basato su regole impostando il prepopulation_status dell'elenco utenti su REQUESTED e monitorando l'avanzamento del processo di precompilazione asincrona controllando periodicamente lo stato di questo campo.

Verranno aggiunti solo gli utenti passati degli ultimi 30 giorni, a seconda della durata dell'iscrizione all'elenco e della data in cui viene aggiunto il tag di remarketing. Lo stato verrà aggiornato a FINISHED una volta elaborata la richiesta oppure a FAILED se la richiesta non va a buon fine.

Indietro
Creazione dei gruppi di elementi della regola