Cette traduction automatique est fournie pour votre commodité.
En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.
Rapport monitoring des applications mobiles événement personnalisé et attribut
Par défaut, New Relic collecte certaines données d'événements de votre application mobile vers New Relic, telles que les interactions, les sessions, les plantages et les erreurs de demande. Cependant, vous pouvez également créer vos propres attributs personnalisés et événements pour des requêtes et des analyses plus détaillées.
Créer un attribut personnalisé et événement
Vous pouvez créer un attribut de niveau de session personnalisé pour l'événement par défaut à l'aide du SDK mobile de l'agent. Par exemple, pour enregistrer un attribut username pour une partie de votre application iOS ou Android, vous utiliseriez l' APIsetAttribute. Ces attributs sont des informations liées à la session et sont partagés par plusieurs types d'événements mobiles.
Vous pouvez également créer des types d'événements personnalisés entièrement nouveaux et leur attribuer leur propre attribut personnalisé, en utilisant l' APIrecordCustomEvent.
Pour faciliter l'analyse des plantages, vous pouvez utiliser le SDK pour créer les événements MobileBreadcrumb et MobileHandledException . Ces événements sont disponibles pour l'interrogation et également affichés dans l' UIdu crash suivi des événements.
Pour en savoir plus sur la création d'attributs personnalisés et d'événements personnalisés, voir :
Exemples de requêtes d'événements et d'attributs mobiles
Voici quelques exemples d'utilisation de NRQL pour interroger l'événement et l'attribut de votre application mobile :
Pour suivre les achats dans votre application, utilisez recordCustomEvent pour créer un type d'événement (tel que « UserAction ») et associer un attribut tel que « nom » (avec la valeur « Achat »), le prix, la quantité et le SKU.
Conseil
Pour des raisons de performances, vous devriez limiter le nombre total de types d'événements à un ou deux. Le paramètre recordCustomEventeventType est destiné à être utilisé pour les catégories de haut niveau. Par exemple, vous pouvez créer un type d'événementGestures, puis créer de nombreux noms d'événement personnalisés différents sous le type d'événement Gesture .
New Relic signale un événement personnalisé de type UserAction et de nom Purchase, qui vous permet d'interroger tous les achats effectués dans votre application au cours du dernier jour :
SELECT*FROM UserAction WHERE name ='Purchase' SINCE 1day ago
Replace deprecated recordEvent method:
À partir de la version 5.12.0 de l'agentAndroid et de la version 5.12.0 de l'agent iOS, utilisez la méthode recordCustomEvent pour créer ces événements personnalisés. Si vous avez remplacé la méthode recordEvent obsolète pour votre événement personnalisé, assurez-vous de remplacer également sa requête NRQL correspondante par le nouveau format.
Recherchez la requête utilisée avec la méthode recordEvent, telle que :
SELECT*FROM Mobile WHERE category ='Custom'AND name ='Purchase' SINCE 1day ago
Remplacez-les par le format de requête utilisé avec recordCustomEvent:
SELECT*FROM UserAction WHERE name ='Purchase' SINCE 1day ago
Vous pouvez créer un attribut personnalisé pour suivre un identifiant utilisateur personnalisé tout au long de la session, puis requêter toutes les interactions de cet utilisateur. Pour ajouter un attribut pour userId, appelez la méthode setUserId :
Avec cet attribut, vous pouvez utiliser une clause WHERE pour voir toutes les actions effectuées par ce username au cours du dernier jour :
SELECT*FROM Mobile WHERE userId ='jsmith' SINCE 1day ago
Vous pouvez créer un attribut personnalisé pour suivre l'identifiant d'un magasin tout au long de la session, puis interroger toutes les interactions de ce magasin. Pour ajouter un attribut pour storeId, appelez la méthode setAttribute :
Avec cet attribut, vous pouvez utiliser une clause WHERE pour voir toutes les actions effectuées par ce storeId au cours du dernier jour :
SELECT*FROM Mobile WHERE storeId ='NY0531' SINCE 1day ago
Vous pouvez utiliser un attribut personnalisé pour suivre le nombre de fois qu'une action spécifique se produit dans votre application. Par exemple, vous pouvez suivre le nombre de fois où un bouton a été cliqué ou le nombre de fois où un niveau a été terminé dans un jeu.
Pour suivre l'achèvement d'un niveau de jeu, appelez incrementAttribute sans valeur spécifiée. Cela crée un attribut avec une valeur par défaut de 1:
Lors de la requête, utilisez cet attribut level pour filtrer vos données. Par exemple, si vous avez un attribut username et level, utilisez la fonction max() pour trouver le niveau le plus élevé atteint par l'utilisateur :
SELECTmax(level)FROM Mobile WHERE username ='jsmith'
Par défaut, New Relic transmet les données d’événement dans l’une des situations suivantes :
Une session dure depuis 600 secondes.
La session de l'application se termine par une mise en arrière-plan.
L'application plante.
Si l'application plante, New Relic collecte l'attribut et l'événement de cette session. (Sur iOS, cela se produit lors du prochain lancement de l'application). Vous pouvez ensuite utiliser NRQL pour interroger et analyser les données d'événements et d'attributs.
Si vous souhaitez collecter des données personnelles via un attribut personnalisé, veuillez consulter vos équipes de confidentialité ou juridiques. Assurez-vous de respecter les obligations de votre organisation en matière de réglementation en matière de notification et de consentement.