• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

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.

Créer un problème

Définir un identifiant utilisateur personnalisé pour les sessions

Syntaxe

Java 

NewRelic.setUserId(string $userId)

Kotlin [#kotlin]

NewRelic.setUserId(userId: String?)

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Cette méthode définit une valeur d'identifiant utilisateur personnalisée pour associer tous les événements de la session d'un utilisateur mobile à un identifiant utilisateur spécifique. Cette méthode peut être appelée à tout moment après le démarrage de l'agent Android New Relic.

Un identifiant utilisateur est utile pour plusieurs raisons. À l’aide de l’ UId’analyse des pannes, vous pouvez :

  • Rechercher des crashs spécifiques à un utilisateur. Se concentrer sur un crash particulier concernant un utilisateur suffit souvent à résoudre rapidement le problème.
  • Filtrez tous les crashs pour afficher les occurrences d'un utilisateur (ou d'un groupe d'utilisateurs) pour chaque type de crash ; inversement, filtrez la liste des crashs pour afficher les utilisateurs affectés par chaque type de crash. Si l'ID utilisateur est représenté sous la forme d'une adresse e-mail, il est alors facile de les contacter et de les informer lorsqu'une solution est disponible pour résoudre ces pannes.

Si vous ne souhaitez pas identifier explicitement l'utilisateur en raison des règles de confidentialité, cette méthode est toujours utile lors du suivi des segments d'utilisateurs, tels que les utilisateurs finaux payants et gratuits, ou les utilisateurs enregistrés et non enregistrés. Cela vous permet de filtrer ou d'analyser le nombre et les types de plantages rencontrés par chaque segment, et de mener des actions de sensibilisation en fonction de ce segment.

Pour plus de contexte sur la façon d'utiliser cette API, voir Envoyer un attribut personnalisé et événement.

Important

Les améliorations suivantes ont été ajoutées à l'agent Android v7.4.0 :

  • Lorsque setUserId(value: string|null) est appelé, si userID était précédemment nul et que la nouvelle valeur n'est pas nulle, la session en cours continue et un nouveau userID sera défini.
  • Lorsque setUserId(value: string|null) est appelé, si userID n'était pas précédemment nul et que le nouveau userID est différent (y compris null), la session en cours sera terminée et une récolte sera effectuée. Une nouvelle session sera créée avec le nouveau userID.

Paramètres [#parameters]

paramètres

Type

Description

$userID

string

Requis. Définit l'ID utilisateur.

Valeurs de retour [#return-values]

Renvoie true en cas de réussite, ou false en cas d'échec.

Exemple [#example]

Voici un exemple pour définir un identifiant utilisateur pour associer une session utilisateur à un événement et un attribut :

Java [#java]

boolean userIdWasSet = NewRelic.setUserId("SampleUserName");

Kotlin [#kotlin]

val userIdWasSet = NewRelic.setUserId("SampleUserName")

Syntaxe

Objectif-C

+ (BOOL) setUserId:(NSString*)userId;

Swift [#swift]

NewRelic.setUserId(userId: String!) -> Bool

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Cette méthode définit une valeur d'identifiant utilisateur personnalisée pour associer tous les événements de la session d'un utilisateur mobile à un identifiant utilisateur spécifique. Cette méthode peut être appelée à tout moment après le démarrage de l'agent New Relic iOS.

Un identifiant utilisateur est utile pour plusieurs raisons. À l’aide de l’ UId’analyse des pannes, vous pouvez :

  • Rechercher des crashs spécifiques à un utilisateur. Se concentrer sur un crash particulier concernant un utilisateur suffit souvent à résoudre rapidement le problème.
  • Filtrez tous les crashs pour afficher les occurrences d'un utilisateur (ou d'un groupe d'utilisateurs) pour chaque type de crash ; ou filtrez la liste des crashs pour afficher les utilisateurs affectés par chaque type de crash. Si l'ID utilisateur est représenté sous la forme d'une adresse e-mail, il est alors facile de les contacter et de les informer lorsqu'une solution est disponible pour résoudre ces plantages.

Si vous ne souhaitez pas identifier explicitement l'utilisateur en raison des règles de confidentialité, cette méthode est toujours utile lors du suivi des segments d'utilisateurs, tels que les utilisateurs finaux payants et gratuits, ou les utilisateurs enregistrés et non enregistrés. Cela vous permet de filtrer ou d'analyser le nombre et les types de plantages rencontrés par chaque segment, et de mener des actions de sensibilisation en fonction de ce segment.

Important

Les améliorations suivantes ont été ajoutées à l'agent iOS v7.5.0 :

  • Lorsque setUserId(value: string|null) est appelé, si userId était précédemment nul et que la nouvelle valeur n'est pas nulle, la session en cours continue et un nouveau userId sera défini.

  • Lorsque setUserId(value: string|null) est appelé, si userId n'était pas précédemment nul et que le nouveau userId est différent (y compris null), la session en cours sera terminée et une récolte sera effectuée. Une nouvelle session sera créée avec le nouveau userId.

Paramètres [#parameters]

paramètres

Type

Description

userID

NSString

Requis. L'ID utilisateur à associer à la session en cours.

Valeurs de retour [#return-values]

Renvoie true en cas de réussite, ou false en cas d'échec.

Exemple [#example]

Objective-C [#obj-c]

BOOL userIdWasSet = [NewRelic setUserId:@"SampleUserName"];

Swift [#swift]

let userIdWasSet = NewRelic.setUserId("SampleUserName")

Syntaxe 

setUserId(options: { userId: string; }) => void

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Paramètres [#parameters]

paramètres

Type

Description

options

{ userId: string; }

Requis. Un objet qui contient l'ID utilisateur.

userId

string

Requis. L'ID utilisateur à associer à la session en cours.

Exemple [#example]

NewRelicCapacitorPlugin.setUserId({ userId: "CapacitorUserId" });

Syntaxe 

setUserId(userId: string): void;

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Paramètres [#parameters]

paramètres

Type

Description

userID

string

Requis. L'ID utilisateur à associer à la session en cours.

Exemple [#example]

NewRelic.setUserId("CORDOVA12934");

Syntaxe 

SetUserId(string userId): bool;

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Paramètres [#parameters]

paramètres

Type

Description

userID

string

Requis. L'ID utilisateur à associer à la session en cours.

Exemple [#example]

CrossNewRelic.Current.SetUserId("User123");

Syntaxe 

setUserId(String userId): void;

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Paramètres [#parameters]

paramètres

Type

Description

userID

string

Requis. L'ID utilisateur à associer à la session en cours.

Exemple [#example]

NewrelicMobile.instance.setUserId("RN12934");

Syntaxe 

setUserId(userId: string): void;

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Paramètres [#parameters]

paramètres

Type

Description

userID

string

Requis. L'ID utilisateur à associer à la session en cours.

Exemple [#example]

Définir l'utilisateur

NewRelic.setUserId("RN12934");

Désactiver l'utilisateur

NewRelic.setUserId("");

Syntaxe 

SetUserId(string userId): bool;

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Paramètres [#parameters]

paramètres

Type

Description

userID

string

Requis. L'ID utilisateur à associer à la session en cours.

Exemple [#example]

NewRelicAgent.SetUserId("User123");

Syntaxe 

setUserId(FString userId): void;

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Paramètres [#parameters]

paramètres

Type

Description

userID

FString

Requis. L'ID utilisateur à associer à la session en cours.

Exemple [#example]

#include "NewRelicBPLibrary.h"


UNewRelicBPLibrary::setUserId("Unreal12934");

Syntaxe 

SetUserId(string userId): bool;

Description [#description]

Définissez une valeur d'identifiant utilisateur personnalisée pour associer les sessions utilisateur à l'événement et à l'attribut d'analyse.

Paramètres [#parameters]

paramètres

Type

Description

userID

string

Requis. L'ID utilisateur à associer à la session en cours.

Exemple [#example]

CrossNewRelicClient.Current.SetUserId("User123");
Droits d'auteur © 2025 New Relic Inc.
RecrutementConditions de servicePolitique DMCAAvis de confidentialitéCookiesLoi britannique sur l'esclavage

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.