Creare un elenco di utenti

Puoi utilizzare gli elenchi 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 utenti. Questa guida si concentra sulla creazione di elenchi utenti basati su regole utilizzando i gruppi di articoli di regole definiti in Creare gruppi di articoli di regole.

Elenchi 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 di regole all'interno dei gruppi di articoli.

Sebbene UserListRuleTypeEnum definisca sia OR_OF_ANDS (forma normale disgiuntiva) sia AND_OF_ORS (forma normale congiuntiva), OR_OF_ANDS è l'unico supportato rule_type per FlexibleRuleUserListInfo (l'impostazione di AND_OF_ORS restituisce UserListError.RULE_TYPE_IS_NOT_SUPPORTED). Con OR_OF_ANDS, Google Ads ANDs insieme tutti gli elementi di regole in un gruppo di elementi di regole, il che significa che, per una determinata regola, ogni elemento di regole in almeno un gruppo di elementi di regole deve corrispondere affinché la regola sia soddisfatta.

Dopo aver definito i due UserListRuleItemGroupInfo oggetti in Creare gruppi di articoli di regole, combinali in un nuovo elenco utenti. L'esempio di codice seguente lascia il tipo di regola predefinito OR_OF_ANDS, aggiunge entrambi i gruppi di articoli di regole 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::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

Includere gli utenti precedenti in un elenco basato su regole

Puoi anche includere i visitatori precedenti del sito web o gli utenti dell'app in un elenco utenti basato su regole (supportato solo nella Rete Display) impostandoprepopulation_status dell'elenco utenti suREQUESTED e monitorando l'avanzamento del processo di precompilazione asincrona controllando periodicamente lo stato di questo campo.

La precompilazione aggiunge solo gli utenti precedenti degli ultimi 30 giorni, a seconda di 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.

Targeting dell'elenco utenti e aggiustamento delle offerte

Dopo aver 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 targetizzare un elenco utenti e modificare le offerte, vedi Targetizzare l'elenco.