Creare un elenco di utenti

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 elementi delle regole definiti in Creare gruppi di elementi delle regole.

Elenchi di utenti basati su regole

Gli elenchi 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 ha un campo rule_type che determina la modalità di combinazione degli elementi delle regole all'interno dei gruppi di elementi 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 utenti. L'esempio di codice seguente lascia invariato il tipo di regola OR_OF_ANDS predefinito, aggiunge entrambi i gruppi di elementi della regola a un FlexibleRuleOperandInfo su FlexibleRuleUserListInfo e modifica l'elenco 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::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

Includere gli utenti passati in un elenco basato su regole

Puoi anche includere i visitatori del sito web o gli utenti dell'app passati in un elenco utenti basato su regole (supportato solo sulla Rete Display) impostando il valore prepopulation_status dell'elenco utenti su REQUESTED e monitorando l'avanzamento del processo di precompilazione asincrona controllando periodicamente lo stato di questo campo.

La precompilazione aggiunge solo gli utenti passati degli ultimi 30 giorni, a seconda del 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 oppure a FAILED se la richiesta non va a buon fine.

Targeting dell'elenco utenti e aggiustamento delle offerte

Una volta creato UserList, collega il relativo nome 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, vedi Scegliere come target l'elenco.

Indietro
Creazione dei gruppi di elementi della regola