Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

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 explique comment créer des listes d'utilisateurs basées sur des règles à l'aide des groupes d'éléments de règle définis dans Créer des groupes d'éléments de règle.

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 (inclusive_rule et exclusive_rule, jointes par inclusive_rule_operator). Chaque règle est représentée par un message UserListRuleInfo, qui comporte un champ 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.

Bien que UserListRuleTypeEnum définisse à la fois OR_OF_ANDS (forme normale disjonctive) et AND_OF_ORS (forme normale conjonctive), OR_OF_ANDS est le seul rule_type compatible avec FlexibleRuleUserListInfo (la définition de AND_OF_ORS renvoie UserListError.RULE_TYPE_IS_NOT_SUPPORTED). Avec OR_OF_ANDS, 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.

Après avoir défini les deux objets UserListRuleItemGroupInfo dans Créer des groupes d'éléments de règle, combinez-les dans une nouvelle liste d'utilisateurs. L'exemple de code suivant laisse en place le type de règle OR_OF_ANDS par défaut, ajoute les deux groupes d'éléments de règle à un FlexibleRuleOperandInfo sur FlexibleRuleUserListInfo et modifie la liste des utilisateurs :

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

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 => []});set_up_advanced_remarketing.pl

curl

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

Vous pouvez également inclure les anciens visiteurs de votre site Web ou utilisateurs de votre application dans une liste d'utilisateurs basée sur des règles (disponible uniquement sur le Réseau Display) en définissant le prepopulation_status de la liste d'utilisateurs sur REQUESTED. Vous pouvez ensuite surveiller la progression du processus de préremplissage asynchrone en vérifiant régulièrement l'état de ce champ.

Le préremplissage n'ajoute que les anciens utilisateurs des 30 derniers jours, en fonction de la membership_life_span de la liste (de 1 à 540 jours) et de la date à laquelle la balise de remarketing a été ajoutée. L'état passe à FINISHED une fois la demande traitée, ou à FAILED si elle échoue.

Cibler la liste d'utilisateurs et ajuster les enchères

Une fois que vous avez créé votre UserList, associez son nom de ressource à un AdGroupCriterion ou un CampaignCriterion, puis définissez bid_modifier (par exemple, 1.25 pour une augmentation des enchères de 25 %). Pour obtenir des exemples de code montrant comment cibler une liste d'utilisateurs et modifier les enchères, consultez Cibler la liste.

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