Résolution des problèmes

Contrôles de base

Mon message in-app ne s’est pas affiché pour un utilisateur

1. L’utilisateur était-il dans le segment au début de la session, lorsque le SDK demande de nouveaux messages in-app ?
2. L’utilisateur était-il éligible ou rééligible pour recevoir le message in-app conformément aux règles de ciblage de la campagne ?
3. L’utilisateur a-t-il été affecté par une limite de fréquence ?
4. L’utilisateur faisait-il partie d’un groupe de contrôle ? Vérifiez si votre campagne est configurée pour les tests A/B.
5. Un message in-app différent et plus prioritaire s’est-il affiché à la place du message attendu ?
6. Mon appareil était-il dans l’orientation correcte spécifiée par la campagne ?
7. Mon message a-t-il été supprimé par l’intervalle de temps minimum de 30 secondes par défaut entre les déclencheurs, imposé par le SDK ?

Mon message in-app ne s’est pas affiché pour tous les utilisateurs sur cette plateforme

1. Votre campagne est-elle configurée pour cibler les applications mobiles ou les navigateurs web, selon le cas ? Par exemple, si votre campagne ne cible que les navigateurs web, elle ne sera pas envoyée aux appareils Android.
2. Avez-vous mis en place une interface utilisateur personnalisée et fonctionne-t-elle comme prévu ? Y a-t-il d’autres traitements ou suppressions personnalisés côté application qui pourraient interférer avec l’affichage ?
3. Cette plateforme et cette version de l’application en particulier ont-elles déjà affiché avec succès des messages in-app ?
4. Le déclencheur a-t-il eu lieu localement sur l’appareil ? Notez qu’un appel REST ne peut pas être utilisé pour déclencher un message in-app dans le SDK.

Mon message in-app ne s’est pas affiché pour tous les utilisateurs

1. L’action de déclenchement a-t-elle été configurée correctement dans le tableau de bord, ainsi que dans l’intégration de l’application ?
2. Un message in-app différent et plus prioritaire s’est-il affiché à la place du message attendu ?
3. Utilisez-vous une version récente du SDK ? Certains types de messages in-app exigent une version spécifique du SDK.
4. Les sessions ont-elles été intégrées correctement dans votre intégration ? L’analytique des sessions fonctionne-t-elle pour cette application ?
5. Utilisez-vous une bibliothèque de composants personnalisée qui pourrait interférer avec l’affichage des messages in-app ?

Mon message in-app a mis beaucoup de temps à s’afficher

1. Si vous diffusez des images ou des vidéos volumineuses à partir de votre réseau de diffusion de contenu dans un message in-app basé sur HTML, vérifiez que vos fichiers sont optimisés pour être aussi légers que possible et que votre réseau de diffusion de contenu est performant.

2. Vérifiez si vous avez configuré un delay pour votre message in-app sur le tableau de bord.

3. Selon les circonstances, les messages in-app téléchargeront ou chargeront les images pertinentes à partir du disque avant de les afficher. Si vous disposez d’une connexion réseau lente ou d’appareils très peu performants, ce processus peut prendre du temps. Veillez à ce que vos images soient optimisées pour être aussi légères que possible.

Pour une discussion plus approfondie de ces scénarios, consultez la section sur la résolution avancée des problèmes.

Problèmes d’analytique des impressions et des clics

Les impressions et les clics ne sont pas enregistrés

Si vous avez défini un délégué de message in-app pour gérer manuellement l’affichage du message ou les actions de clic, vous devez consigner manuellement les clics et les impressions sur le message in-app.

Les impressions sont supérieures aux impressions uniques

Ce comportement est attendu et peut se produire dans les cas suivants :

• Même si la rééligibilité est désactivée, les utilisateurs ayant reçu la campagne peuvent posséder plusieurs appareils. Le déclencheur de la campagne se met à jour au prochain démarrage de session, de sorte qu’un appareil ne saura pas si un autre appareil a déjà déclenché la campagne tant que l’utilisateur n’aura pas démarré une nouvelle session.
• Si votre message in-app comporte un délai planifié de quelques minutes après l’événement déclencheur, les utilisateurs peuvent avoir reçu le message plus d’une fois.

Pour plus d’informations sur la rééligibilité, consultez Rééligibilité pour les campagnes et Canvas.

Les impressions sont inférieures à la valeur attendue

1. Les déclencheurs mettent du temps à se synchroniser avec l’appareil au démarrage de la session. Il peut donc y avoir une condition de concurrence si les utilisateurs enregistrent un événement ou un achat juste après avoir démarré une session. Une solution possible serait de modifier la campagne pour qu’elle se déclenche au démarrage de la session, puis de segmenter en fonction de l’événement ou de l’achat souhaité. Notez que cela enverrait le message in-app au prochain démarrage de session après que l’événement se soit produit.

2. Si la campagne est déclenchée par un début de session ou un événement personnalisé, vous devez vous assurer que cet événement ou cette session se produit suffisamment fréquemment pour déclencher le message. Vérifiez ces données sur les pages Aperçu (pour les données de session) ou Événements personnalisés :

Autres raisons possibles :

• Les utilisateurs n’ont pas consulté le message in-app, les impressions ne sont donc pas enregistrées.
• Plusieurs messages in-app s’interceptent mutuellement (par exemple, plusieurs messages à haute priorité).
• Si le message se trouve dans un Canvas, les utilisateurs peuvent entrer dans une étape de délai plus longue que le délai d’expiration de session avant de recevoir le message in-app.

Les impressions sont plus faibles qu’auparavant

1. Assurez-vous que personne n’a modifié involontairement le segment ou la campagne depuis le lancement. Nos journaux des modifications des segments et des campagnes vous informeront sur les changements effectués, qui les a faits et quand.

2. Assurez-vous que vous n’avez pas réutilisé votre événement déclencheur dans une autre campagne de messages in-app ayant une priorité plus élevée.

Résolution avancée des problèmes

La plupart des problèmes de messages in-app peuvent être répartis en deux catégories principales : la distribution et l’affichage. Pour comprendre pourquoi un message in-app attendu ne s’est pas affiché sur votre appareil, confirmez que le message in-app a bien été distribué à l’appareil, puis résolvez le problème d’affichage du message.

Résolution des problèmes de distribution

Le SDK demande des messages in-app aux serveurs Braze au démarrage de la session. Pour vérifier si les messages in-app sont bien distribués à votre appareil, vous devez vous assurer qu’ils sont à la fois demandés par le SDK et renvoyés par les serveurs Braze.

Vérifier si les messages sont demandés et renvoyés

1. Ajoutez-vous en tant qu’utilisateur test sur le tableau de bord.
2. Configurez une campagne de messages in-app ciblée pour votre utilisateur.
3. Assurez-vous qu’une nouvelle session se produit dans votre application.
4. Utilisez le journal des événements utilisateurs pour vérifier que votre appareil demande des messages in-app au début de la session. Recherchez la requête SDK associée à l’événement de démarrage de session de votre utilisateur test.
   • Si votre application était censée demander des messages in-app déclenchés, vous devriez voir trigger dans le champ Réponses demandées sous Données de réponse.
   • Si votre application était censée demander des messages in-app originaux, vous devriez voir in_app dans le champ Réponses demandées sous Données de réponse.
5. Utilisez le journal des événements utilisateurs pour vérifier si les messages in-app appropriés sont renvoyés dans les données de réponse.
   

Résoudre les problèmes de messages non demandés

Si vos messages in-app ne sont pas demandés, il est possible que votre application ne suive pas correctement les sessions, car les messages in-app sont actualisés au démarrage de la session. Assurez-vous également que votre application démarre réellement une session en fonction de la sémantique du délai d’expiration de session de votre application :

Résoudre les problèmes de messages non renvoyés

Si les messages in-app ne sont pas renvoyés, vous rencontrez probablement un problème de ciblage de campagne :

1. Votre segment ne contient pas votre utilisateur.
   • Vérifiez l’onglet Engagement de votre utilisateur pour vous assurer que le segment approprié apparaît sous Segments.
2. Votre utilisateur a déjà reçu le message in-app et n’était pas rééligible pour le recevoir à nouveau.
   • Vérifiez les paramètres de rééligibilité de la campagne dans l’étape Réception/distribution du Compositeur de campagne et assurez-vous que les paramètres de rééligibilité correspondent à votre configuration de test.
3. Votre utilisateur a atteint la limite de fréquence pour la campagne.
   • Vérifiez les paramètres de limite de fréquence de la campagne et assurez-vous qu’ils correspondent à votre configuration de test.
4. Si un groupe de contrôle a été créé pour la campagne, votre utilisateur peut être tombé dans le groupe de contrôle.
   • Vous pouvez vérifier si cela s’est produit en créant un segment avec un filtre de variante de campagne reçue, où la variante de campagne est définie sur Contrôle, et en vérifiant si votre utilisateur fait partie de ce segment.
   • Lors de la création de campagnes à des fins de test d’intégration, veillez à désactiver l’ajout d’un groupe de contrôle.

Résolution des problèmes d’affichage

Si votre application demande et reçoit avec succès des messages in-app, mais qu’ils ne s’affichent pas, il se peut que la logique côté appareil empêche l’affichage :

1. L’événement déclencheur se déclenche-t-il comme prévu ? Pour le vérifier, essayez de configurer le message pour qu’il se déclenche à l’aide d’une action différente (comme le démarrage d’une session) et vérifiez s’il s’affiche.

2. Les messages in-app déclenchés sont limités en débit en fonction de l’intervalle de temps minimum entre les déclenchements, qui est de 30 secondes par défaut.

3. Les échecs de téléchargement d’images empêcheront l’affichage des messages in-app contenant des images. Vérifiez les journaux de votre appareil pour vous assurer que les téléchargements d’images n’échouent pas. Essayez de supprimer temporairement l’image de votre message pour voir si celui-ci s’affiche.

4. Si vous avez défini un délégué pour personnaliser la gestion des messages in-app, vérifiez votre délégué pour vous assurer qu’il n’affecte pas l’affichage du message in-app.

5. Si l’orientation de l’appareil ne correspond pas à l’orientation spécifiée par le message in-app, celui-ci ne s’affichera pas. Assurez-vous que votre appareil est dans la bonne orientation.

6. Si votre message in-app est déclenché par le démarrage de la session et que vous avez défini un délai d’expiration de session prolongé, cela aura une incidence sur la rapidité avec laquelle vous pouvez afficher les messages. Par exemple, si le délai d’expiration de votre session est fixé à 300 secondes, le fait de fermer et de rouvrir l’application en moins de temps n’actualisera pas la session, de sorte qu’un message in-app déclenché par le démarrage d’une session ne s’affichera pas.

Résolution des problèmes de chargement des ressources (NSURLError code -1008)

Lors de l’intégration de Braze avec des bibliothèques de journalisation réseau tierces, les développeurs peuvent fréquemment rencontrer une NSURLError avec le code de domaine -1008. Cette erreur indique que des ressources telles que des images et des polices n’ont pas pu être récupérées ou que leur mise en cache a échoué. Pour contourner ces cas, vous devrez enregistrer les URL de diffusion de contenu de Braze dans la liste des domaines qui doivent être ignorés par ces bibliothèques.

Domaines

La liste complète des domaines de diffusion de contenu est indiquée ci-dessous :

• "appboy-images.com"
• "braze-images.com"
• "cdn.braze.eu"
• "cdn.braze.com"

Exemples

Vous trouverez ci-dessous les bibliothèques connues pour être en conflit avec la mise en cache des ressources de Braze, ainsi qu’un exemple de code permettant de contourner le problème. Si votre projet utilise une bibliothèque qui provoque une erreur de ressource indisponible et qui n’est pas répertoriée ci-dessous, consultez la documentation de cette bibliothèque pour connaître les API d’utilisation similaires.

Netfox

• swift
• objective-c

1
NFX.sharedInstance().ignoreURLs(["https://cdn.braze.com"])

1
[NFX.sharedInstance ignoreURLs:@[@"https://cdn.braze.com"]];

NetGuard

• swift
• objective-c

1
NetGuard.blackListHosts.append(contentsOf: ["cdn.braze.com"])

1
2
3
NSMutableArray<NSString *> *blackListHosts = [NetGuard.blackListHosts mutableCopy];
[blackListHosts addObject:@"cdn.braze.com"];
NetGuard.blackListHosts = blackListHosts;

XNLogger

• swift
• objective-c

1
2
let brazeAssetsHostFilter = XNHostFilter(host: "https://cdn.braze.com")
XNLogger.shared.addFilters([brazeAssetsHostFilter])

1
2
XNHostFilter *brazeAssetsHostFilter = [[XNHostFilter alloc] initWithHost: @"https://cdn.braze.com"];
[XNLogger.shared addFilters:@[brazeAssetsHostFilter]];