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

Cette page couvre les problèmes courants et les questions qui peuvent survenir lors de la création et de la gestion des segments dans Braze.

Erreurs

L’audience cible est trop complexe pour être lancée

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 campagne 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 Target Audience.

Lorsque vous ajoutez des filtres de segment à une campagne 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 campagne ou un Canvas, une requête est exécutée pour combiner 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 campagne 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 campagne, 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 du 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’ID utilisateur ou d’e-mails (qui utilisent souvent un filtre regex) peuvent être convertis en import CSV et simplifiés en un seul filtre CSV.
• Si vous utilisez CDI, vous pourrez peut-être 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.

X campagnes 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 campagnes ou de Canvas chaque fois que des campagnes 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 et n’afficher que les campagnes ou Canvas dépassant le seuil, puis suivez les étapes de résolution des problèmes dans L’audience cible est trop complexe pour être lancée.

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 apparaît 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 campagne 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’ID 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’ID Braze, soit de l’ID 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 CSV, très efficace.

Comportement des utilisateurs

Un utilisateur n’est plus dans 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 campagnes et Canvas avec lesquels il a interagi précédemment. Si la rééligibilité est activée, son profil utilisateur affichera les données les plus récentes de la campagne reçue.

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

Les utilisateurs peuvent avoir plusieurs applications, donc sélectionner une application spécifique dans la section Applications utilisées de la page de segmentation donnera des résultats pour les utilisateurs qui ont au moins cette application. Le filtre ne donne pas de résultats uniquement pour les utilisateurs qui ont 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 rejettera les données envoyées à Braze dans un format différent.

Analyse et reporting

Messages envoyés ou Destinataires uniques dans l’analyse de campagne ne correspond pas au nombre du segment

Si le nombre dans l’analyse de votre campagne pour Messages envoyés ou Destinataires uniques ne correspond pas au nombre d’utilisateurs dans le filtre de segment A reçu un message de la campagne X, il peut y avoir trois raisons possibles.

1. Des utilisateurs peuvent avoir été archivés, orphelins ou supprimés depuis le lancement de la campagne
   
   Par exemple, supposons que 1 000 utilisateurs reçoivent une campagne et que vous effectuez un export CSV le même jour. Vous verrez 1 000 utilisateurs rapporté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 rapportés tandis que le nombre de Destinataires uniques dans Analyse de campagne est toujours de 1 000.
   
   En d’autres termes, l’indicateur Destinataires uniques est un compteur incrémenté, tandis que le segmenteur et l’export CSV fournissent un décompte des utilisateurs actuellement existants.
   
   

2. La campagne a la rééligibilité activée, ce qui permet aux utilisateurs de réintégrer la campagne plusieurs fois
   
   Par exemple, supposons qu’une campagne e-mail a la rééligibilité définie à zéro minute (les utilisateurs peuvent réintégrer la campagne tant qu’ils remplissent les conditions du segment d’audience), et que la campagne est en cours depuis plus d’un mois. Le nombre de Messages envoyés dans Analyse de campagne ne correspondrait pas au nombre dans le segment car ce champ inclurait les messages envoyés à des utilisateurs en double.
   
   En effet, Braze compte les utilisateurs uniques comme Destinataires quotidiens uniques, soit le nombre d’utilisateurs qui ont reçu un message particulier dans 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 « unique » ne dure qu’une journée. Cela peut entraîner un nombre de Destinataires quotidiens uniques supérieur au nombre de profils utilisateur dans l’export CSV. Les profils utilisateur dans le fichier CSV sont véritablement uniques.
   
   

3. Des utilisateurs partageant un identifiant de canal correspondent au filtre
   
   Le filtre A reçu un message de la campagne X (et d’autres filtres « reçu ») peut correspondre à des utilisateurs qui partagent un identifiant de canal avec quelqu’un qui a reçu, ouvert ou cliqué le message.

Un utilisateur est affecté à 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 être affecté à cette application ; cependant, il existe deux scénarios dans lesquels un utilisateur peut tout de même être affecté à une application spécifique sans avoir enregistré de session dans celle-ci.

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}"}
      ]
  }
]
}