Créer une liste d'utilisateurs

Vous pouvez utiliser des listes d'utilisateurs dans vos campagnes de remarketing pour réengager les utilisateurs ayant effectué des actions spécifiques sur votre site Web ou dans votre application. L'API Google Ads est compatible avec plusieurs types de listes d'utilisateurs. Ce guide se concentre sur la création de listes d'utilisateurs basées sur des règles.

Listes d'utilisateurs basées sur des règles

Les listes d'utilisateurs basées sur des règles créées avec flexible_rule_user_list peuvent contenir plusieurs règles. Chaque règle est représentée par un message UserListRuleInfo, qui comporte un rule_type qui détermine la façon dont les éléments de règle des groupes d'éléments de règle sont combinés.

Si rule_type est défini sur OR_OF_ANDS (valeur par défaut), Google Ads AND tous les éléments de règle d'un groupe d'éléments de règle. Cela signifie que, pour une règle donnée, chaque élément de règle d'au moins un groupe d'éléments de règle doit correspondre pour que la règle soit respectée. C'est ce qu'on appelle la "forme normale disjonctive".

Si vous définissez rule_type sur AND_OF_ORS, au moins un élément de règle dans chaque groupe d'éléments de règle doit correspondre pour que la règle soit respectée. C'est ce qu'on appelle la "forme normale conjonctive".

Il ne vous reste plus qu'à combiner les groupes d'éléments de règle ci-dessus dans une nouvelle liste d'utilisateurs. Dans ce cas, nous allons laisser la fonctionnalité OR_OF_ANDS par défaut en place, car c'est pour cela que nous avons créé ces règles.

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

Inclure les anciens utilisateurs dans une liste basée sur des règles

Vous pouvez également inclure d'anciens utilisateurs dans une liste d'utilisateurs basée sur des règles en définissant prepopulation_status sur REQUESTED et en surveillant la progression du processus de préremplissage asynchrone en vérifiant régulièrement l'état de ce champ.

Cela n'ajoutera que les anciens utilisateurs des 30 derniers jours, en fonction de la durée de validité de la liste et de la date à laquelle la balise de remarketing a été ajoutée. L'état passera à FINISHED une fois la demande traitée, ou à FAILED si elle échoue.

Précédent
Créer les groupes d'éléments de règle