Résolution des problèmes liés aux segments

Identifiez votre symptôme dans la liste ci-dessous pour accéder à la section appropriée. Cette page couvre les erreurs de lancement, l’éligibilité des utilisateurs, les problèmes de filtres et les incohérences d’analyse. Pour les définitions des filtres, consultez Filtres de segmentation. Pour les estimations de taille de segment, les comptages exacts et les graphiques d’historique d’appartenance, consultez Mesurer la taille d’un segment.

Commencez ici : identifiez votre symptôme

Parcours d’investigation standard

Utilisez ce flux de travail lorsqu’un utilisateur devrait se trouver dans un Segment mais n’y figure pas, ou lorsque le nombre d’un Segment semble incorrect.

1. Lancement bloqué : si vous voyez une erreur de complexité d’audience ou de filtre de 10 000 octets sur une Campaign ou un Canvas, commencez par Erreurs (solution de contournement CSV, simplification des filtres).
2. Aperçu utilisateur ou recherche d’utilisateur : testez un utilisateur spécifique par rapport aux filtres de votre Segment. Lorsqu’un utilisateur ne correspond pas à une partie ou à la totalité des critères, les critères manquants sont répertoriés pour la résolution des problèmes. Pour les étapes, consultez Tester les Segments dans Créer un Segment.
3. Calculer les statistiques exactes : si l’estimation du Segment affiche 0 utilisateur ou semble incorrecte, sélectionnez Calculer les statistiques exactes dans le panneau Utilisateurs joignables. Enregistrez votre Segment avant de lancer le calcul. Si un calcul est déjà en cours, attendez qu’il se termine ; des chiffres obsolètes peuvent s’afficher jusqu’à ce que le nouveau calcul soit terminé. Pour plus de détails, consultez Calculer les statistiques exactes.
4. Vérifier les valeurs des filtres : recherchez les fautes de frappe, les incompatibilités de types de données, les références obsolètes aux étapes du Canvas et la logique filtre négatif + OU.
5. Vérifier la complexité : si le lancement est bloqué, consultez L’audience cible est trop complexe pour le lancement.
6. Contacter l’assistance : si vous êtes toujours bloqué, contactez l’Assistance Braze.

Le Segment affiche zéro utilisateur

La taille d’un Segment dans le tableau de bord est souvent une estimation basée sur un échantillon d’utilisateurs. Les Segments très petits peuvent afficher une plage estimée incluant 0, même lorsque des utilisateurs correspondent à vos filtres.

• Sélectionnez Calculate exact stats dans le panneau Reachable users pour obtenir un décompte précis. Enregistrez d’abord le Segment. Pour plus d’informations, consultez Considérations relatives aux estimations de décompte.
• Si User Preview renvoie zéro utilisateur pour un petit Segment, cela ne signifie pas nécessairement que le Segment est vide. Exécutez Calculate exact stats pour confirmer. Pour plus d’informations, consultez Aperçu des utilisateurs.

Appartenance rétroactive à un Segment

Braze ne stocke pas l’historique d’appartenance aux Segments par utilisateur. Vous ne pouvez pas vérifier si un utilisateur spécifique faisait partie d’un Segment à un moment d’envoi passé.

Pour capturer l’appartenance à un instant donné, exportez les utilisateurs du Segment dans le tableau de bord ou appelez l’endpoint /users/export/segment avant d’envoyer une Campaign ou un Canvas. Pour en savoir plus, consultez Filtres de segmentation (filtre d’appartenance au Segment) et Exporter les données d’un Segment au format CSV.

Erreurs

L’audience cible est trop complexe pour le lancement

Cette erreur rare se produit lorsque votre audience cible contient trop de valeurs regex, des valeurs regex excessivement longues, des filtres excessivement détaillés (comme « est l’un des 30 000 codes postaux ») ou trop de filtres. Cela inclut tous les filtres d’une audience de Campaign ou de Canvas, que les filtres se trouvent dans les Segments référencés ou qu’ils soient ajoutés en tant que filtres à l’étape Audience cible.

Lorsque vous ajoutez des filtres de Segment à une Campaign ou un Canvas, ces filtres sont traduits en requêtes dans Braze (le nombre de caractères de ces requêtes n’est pas en correspondance 1:1 avec le nombre de caractères qu’un utilisateur du tableau de bord voit). Lorsque Braze envoie une Campaign ou un Canvas, une requête est exécutée qui combine tous les filtres de l’audience ciblée. Un seuil est appliqué pour limiter le nombre de caractères dans la requête résultante pour une audience cible. Pour une Campaign ou un Canvas donné, le nombre de caractères est additionné pour tous les Segments référencés, y compris tous les filtres supplémentaires. Pour un Segment donné, le nombre de caractères est additionné pour tous les filtres et valeurs de filtre.

Votre tableau de bord affichera une erreur lorsqu’une Campaign, un Canvas ou un Segment dépasse le seuil et ne peut pas être lancé. Si vous recevez cette erreur, simplifiez votre audience cible avant de relancer, notamment :

• Si votre audience référence plusieurs Segments, assurez-vous que les Segments ne comportent pas de redondances, comme les mêmes filtres apparaissant dans plusieurs Segments.
• Assurez-vous de ne pas référencer des données obsolètes dans les filtres de Segment. Par exemple, un filtre obsolète pourrait rechercher des utilisateurs qui n’ont pas reçu une certaine étape de Canvas au cours de la semaine passée, alors que le Canvas est arrêté depuis des mois.
• Les Segments qui sont simplement des listes d’identifiants utilisateur ou d’e-mails (qui utilisent souvent un filtre regex) peuvent être convertis en un import CSV et simplifiés en un seul filtre basé sur un CSV.
• Si vous utilisez CDI, vous pouvez éventuellement créer un Segment CDI qui extrait le groupe directement depuis votre entrepôt de données.

Vous pouvez également contacter l’assistance pour obtenir de l’aide supplémentaire sur l’optimisation des filtres.

Remarque

La limitation du nombre de caractères a été mise en place en avril 2025. Les Campaigns et Canvas lancés avant avril 2025 étaient exemptés, ce qui signifie qu’ils peuvent continuer à dépasser la limite, tandis que les Campaigns et Canvas nouvellement créés ne peuvent pas dépasser la limite. Si vous modifiez ou clonez une Campaign ou un Canvas exempté, vous ne pouvez pas le lancer tant que l’audience n’a pas été mise à jour pour être en dessous de la limite.

X Campaigns ou Canvas actifs ou arrêtés dépassent le seuil de complexité de l’audience

Ce bandeau s’affiche en haut d’une liste de Campaigns ou de Canvas chaque fois que des Campaigns ou Canvas actifs ou arrêtés ont des audiences qui dépassent le seuil de complexité de l’audience. Sélectionnez le bandeau pour filtrer la liste afin de n’afficher que les Campaigns ou Canvas dépassant le seuil, puis suivez les étapes de résolution des problèmes dans L’audience cible est trop complexe pour le lancement.

Le filtre dépasse 10 000 octets ou est trop long pour être enregistré

Braze limite les filtres de Segment individuels à un maximum de 10 000 octets, ce qui équivaut à 10 000 caractères anglais ou 3 333 caractères japonais. Un avertissement s’affiche chaque fois qu’un filtre individuel dépasse 10 000 octets, que le filtre se trouve dans un Segment ou qu’il soit ajouté directement à une Campaign ou un Canvas.

Cette erreur se produit très rarement, mais lorsqu’elle survient, c’est généralement avec des filtres regex qui ciblent une liste d’identifiants utilisateur ou d’adresses e-mail. Dans ce cas, vous pouvez suivre ces étapes pour convertir les filtres en CSV :

1. Exportez les utilisateurs du Segment concerné ou du filtre regex spécifique.
2. Nettoyez le CSV si nécessaire. Vous avez besoin soit de l’identifiant Braze, soit de l’identifiant Appboy, mais vous pouvez supprimer toutes les autres colonnes si elles ne sont pas nécessaires. Nous recommandons également de vérifier vos données pour confirmer qu’elles sont récentes (par exemple, supprimez les utilisateurs que vous ne cherchez plus à cibler).
3. Importez à nouveau le fichier CSV, ce qui regroupe automatiquement les utilisateurs dans un seul filtre basé sur un CSV, très efficace.

Comportement des utilisateurs

L’utilisateur ne fait plus partie d’un Segment

Si un utilisateur n’est pas disponible lors de la création d’un Segment, ses données utilisateur qui déterminent son éligibilité au Segment peuvent avoir changé en raison de sa propre activité ou d’autres Campaigns et Canvas avec lesquels il a interagi précédemment. Si la rééligibilité est activée, son profil utilisateur affiche les données les plus récentes de la Campaign reçue.

Pour vérifier si un utilisateur spécifique correspond à votre Segment aujourd’hui, utilisez l’aperçu utilisateur ou la recherche d’utilisateur.

Des informations s’affichent pour des utilisateurs d’autres applications lorsque je filtre par application spécifique

Les utilisateurs peuvent avoir plusieurs applications. Sélectionner une application spécifique dans la section Applications utilisées de la page de segmentation renverra des résultats pour les utilisateurs qui possèdent au moins cette application. Le filtre ne renvoie pas de résultats uniquement pour les utilisateurs qui possèdent exclusivement cette application.

Filtrage

Les options de filtre ont changé

Vos options de filtre sont liées au format (type de données) que vous transmettez à Braze pour votre attribut personnalisé. Pour vérifier le type de données que Braze reconnaît pour vos attributs personnalisés, accédez à Paramètres des données > Attributs personnalisés.

Si vos options de filtre ont changé, cela indique que vos données sont transmises à Braze dans un format (type de données) différent de celui utilisé précédemment. Pour des descriptions détaillées des différents types de données et de leurs options de filtrage, consultez Types de données des attributs personnalisés.

Gardez à l’esprit que modifier le type de données d’un attribut personnalisé dans le tableau de bord entraîne le rejet des données envoyées à Braze dans un format différent. Vous ne pouvez pas modifier le type de données d’un attribut personnalisé tant que cet attribut est référencé dans des Campaigns, des Canvas ou des Segments actifs ; le tableau de bord affiche une erreur et bloque la modification.

L’onglet Valeurs d’un attribut personnalisé affiche les résultats d’un échantillon d’environ 250 000 utilisateurs. N’utilisez pas l’onglet Valeurs pour confirmer l’existence d’une valeur d’attribut spécifique à des fins de résolution des problèmes. Pour plus d’informations, consultez Onglet Valeurs.

L’attribut personnalisé imbriqué n’est pas disponible comme option de filtre

Si votre attribut personnalisé imbriqué n’apparaît pas comme option de filtre lors de la création d’un Segment, générez d’abord son schéma. Accédez à Paramètres des données > Attributs personnalisés, trouvez l’attribut et sélectionnez Générer le schéma. Une fois généré, l’attribut devient disponible dans le menu déroulant des filtres de Segment. Pour plus d’informations, consultez Générer un schéma à l’aide de l’explorateur d’objets imbriqués.

Le Segment est beaucoup plus grand que prévu

Si votre Segment semble beaucoup plus grand que prévu malgré des filtres apparemment restrictifs, vérifiez si vous utilisez des filtres négatifs (is not, does not equal, does not match regex ou not included) avec l’opérateur OR sur le même attribut plus d’une fois. Cette combinaison peut cibler des utilisateurs avec toutes les valeurs possibles pour cet attribut.

Pour savoir quand utiliser AND au lieu de OR, consultez Quand éviter l’opérateur OR dans Créer un Segment.

Analyse et reporting

Le nombre de Messages envoyés ou de Destinataires uniques dans l’analyse de Campaign ne correspond pas au nombre du Segment

Si le nombre de Messages envoyés ou de Destinataires uniques dans l’analyse de votre Campaign ne correspond pas au nombre d’utilisateurs dans le filtre de Segment Has received message from campaign X, il peut y avoir trois raisons possibles.

1. Des utilisateurs ont pu être archivés, orphelins ou supprimés depuis le lancement de la Campaign
   
   Par exemple, supposons que 1 000 utilisateurs reçoivent une Campaign et que vous effectuez un export CSV le même jour. Vous verrez 1 000 utilisateurs reportés. Au cours du mois suivant, 50 de ces 1 000 utilisateurs sont supprimés (par exemple, via l’endpoint users/delete). Lorsque vous effectuez un autre export CSV, vous verrez 950 utilisateurs reportés, tandis que le nombre de Destinataires uniques dans Campaign Analytics reste à 1 000.
   
   En d’autres termes, la métrique Destinataires uniques est un compteur incrémenté, tandis que le segmenteur et l’export CSV fournissent un décompte des utilisateurs existants à l’instant T.
   
   

2. La Campaign a la rééligibilité activée, ce qui permet aux utilisateurs de réintégrer la Campaign plusieurs fois
   
   Par exemple, supposons qu’une Campaign d’e-mail a la rééligibilité définie à zéro minute (les utilisateurs peuvent réintégrer la Campaign tant qu’ils remplissent les critères du Segment d’audience), et que la Campaign est en cours depuis plus d’un mois. Le nombre de Messages envoyés dans Campaign Analytics ne correspondrait pas au nombre dans le Segment, car ce champ inclurait les messages envoyés à des utilisateurs en doublon.
   
   En effet, Braze comptabilise les utilisateurs uniques en tant que Destinataires uniques quotidiens, c’est-à-dire le nombre d’utilisateurs ayant reçu un message particulier au cours d’une journée. Cela signifie que les utilisateurs rééligibles sont comptés plus d’une fois en tant que destinataire unique, car la fenêtre d’« unicité » ne dure qu’une journée. Il en résulte que le nombre de Destinataires uniques quotidiens peut être supérieur au nombre de profils utilisateurs dans l’export CSV. Les profils utilisateurs dans le fichier CSV sont véritablement uniques.
   
   

3. Des utilisateurs partageant un identifiant de canal ont correspondu au filtre
   
   Le filtre Has received message from campaign X (et les autres filtres « reçu ») peut correspondre à des utilisateurs qui partagent un identifiant de canal, tel que le même jeton push ou la même adresse e-mail, avec un autre profil utilisateur ayant reçu, ouvert ou cliqué le message.

Un utilisateur est assigné à deux applications alors qu’il n’a enregistré une session que dans une seule

Lors de la création d’un Segment, vous pouvez cibler les utilisateurs qui ont utilisé des applications spécifiques. Un utilisateur doit avoir eu une session dans une application spécifique pour y être assigné ; cependant, il existe deux scénarios dans lesquels un utilisateur peut tout de même être assigné à une application spécifique sans y avoir enregistré de session.

Le premier scénario est lorsque le champ app_id est renseigné lors de l’utilisation de l’endpoint /users/track, plus précisément lors de l’utilisation d’un objet événement ou d’un objet achat, comme dans cet exemple :

1
2
3
4
5
6
7
8
9
10
{
    "events": [
    {
      "external_id": "john_doe123",
      "app_id": "my_web_app_id",
      "name": "Custom Event",
      "time": "2025-08-17T19:20:30+1:00"
    }
  ]
}

Le second scénario est lorsque le champ app_id est renseigné lors de l’utilisation de l’endpoint /users/track pour migrer des jetons push, comme dans cet exemple :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"app_group_id": "{YOUR_APP_GROUP_ID}",
"attributes": [
{
      "push_token_import": false,
      "external_id": "external_id1",
      "country": "US",
      "language": "en",
      "{YOUR_CUSTOM_ATTRIBUTE}": "{YOUR_VALUE}",
      "push_tokens": [
        {"app_id": "{APP_ID_OF_OS}", "token": "{PUSH_TOKEN_STRING}"}
      ]
  }
]
}