Sintaxis
Java
NewRelic.setUserId(string $userId)Kotlin [#kotlin]
NewRelic.setUserId(userId: String?)Descripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Este método establece un valor de identificador de usuario personalizado para asociar todos los eventos de la sesión de un usuario móvil con una ID de usuario específica. Este método se puede llamar en cualquier momento después de que se inicie el agente de Android New Relic.
Un identificador de usuario es útil por varias razones. Con la UI de análisis de fallos, puede:
- Encuentre fallas específicas de un usuario. Centrarse en un fallo concreto de un usuario suele ser suficiente para resolver rápidamente el problema.
- Filtrar todos los fallos para mostrar las ocurrencias de un usuario (o grupo de usuarios) para cada tipo de fallo; a la inversa, filtre la lista de fallos para mostrar los usuarios afectados por cada tipo de fallo. Si el ID de usuario se representa como una dirección de correo electrónico, es fácil comunicarse con ellos e informarles cuando haya una solución disponible que solucione esos fallos.
Si no desea identificar explícitamente al usuario debido a las reglas de privacidad, este método sigue siendo útil al realizar un seguimiento de segmentos de usuarios, como usuarios finales pagados versus gratuitos, o usuarios registrados versus no registrados. Esto le permite filtrar o facetar la cantidad y los tipos de accidentes experimentados por cada segmento y realizar actividades de divulgación en función de ese segmento.
Para obtener más contexto sobre cómo utilizar esta API, consulte Enviar atributo personalizado y evento.
Importante
Se agregaron las siguientes mejoras en el agente Android v7.4.0:
- Cuando se llama a
setUserId(value: string|null), siuserIDera previamente nulo y el nuevo valor no es nulo, la sesión actual continúa y se establecerá un nuevouserID. - Cuando se llama a
setUserId(value: string|null), siuserIDanteriormente no era nulo y el nuevouserIDes diferente (incluidonull), la sesión actual finalizará y se realizará una recolección. Se creará una nueva sesión con el nuevouserID.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. Establece la ID de usuario. |
Valores de retorno [#return-values]
Devuelve true si tiene éxito o false si no.
Ejemplo [#example]
Aquí hay un ejemplo para configurar un identificador de usuario para asociar la sesión del usuario con un evento y atributo:
Java [#java]
boolean userIdWasSet = NewRelic.setUserId("SampleUserName");Kotlin [#kotlin]
val userIdWasSet = NewRelic.setUserId("SampleUserName")Sintaxis
C objetivo
+ (BOOL) setUserId:(NSString*)userId;Swift [#swift]
NewRelic.setUserId(userId: String!) -> BoolDescripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Este método establece un valor de identificador de usuario personalizado para asociar todos los eventos de la sesión de un usuario móvil con una ID de usuario específica. Este método se puede llamar en cualquier momento después de que se inicie el agente iOS de New Relic.
Un identificador de usuario es útil por varias razones. Con la UI de análisis de fallos, puede:
- Encuentre fallas específicas de un usuario. Centrarse en un fallo concreto de un usuario suele ser suficiente para resolver rápidamente el problema.
- Filtrar todos los fallos para mostrar las ocurrencias de un usuario (o grupo de usuarios) para cada tipo de fallo; o filtrar la lista de fallos para mostrar los usuarios afectados por cada tipo de fallo. Si el ID de usuario se representa como una dirección de correo electrónico, es fácil comunicarse con ellos e informarles cuando haya una solución disponible que solucione esos fallos.
Si no desea identificar explícitamente al usuario debido a las reglas de privacidad, este método sigue siendo útil al realizar un seguimiento de segmentos de usuarios, como usuarios finales pagados versus gratuitos, o usuarios registrados versus no registrados. Esto le permite filtrar o facetar la cantidad y los tipos de accidentes experimentados por cada segmento y realizar actividades de divulgación en función de ese segmento.
Importante
Se agregaron las siguientes mejoras en el agente iOS v7.5.0:
Cuando se llama a
setUserId(value: string|null), siuserIdera previamente nulo y el nuevo valor no es nulo, la sesión actual continúa y se establecerá un nuevouserId.Cuando se llama a
setUserId(value: string|null), siuserIdanteriormente no era nulo y el nuevouserIdes diferente (incluidonull), la sesión actual finalizará y se realizará una recolección. Se creará una nueva sesión con el nuevouserId.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Valores de retorno [#return-values]
Devuelve true si tiene éxito o false si no.
Ejemplo [#example]
Objective-C [#obj-c]
BOOL userIdWasSet = [NewRelic setUserId:@"SampleUserName"];Swift [#swift]
let userIdWasSet = NewRelic.setUserId("SampleUserName")Sintaxis
setUserId(options: { userId: string; }) => voidDescripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. Un objeto que contiene el ID de usuario. |
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Ejemplo [#example]
NewRelicCapacitorPlugin.setUserId({ userId: "CapacitorUserId" });Sintaxis
setUserId(userId: string): void;Descripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Ejemplo [#example]
NewRelic.setUserId("CORDOVA12934");Sintaxis
SetUserId(string userId): bool;Descripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Ejemplo [#example]
CrossNewRelic.Current.SetUserId("User123");Sintaxis
setUserId(String userId): void;Descripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Ejemplo [#example]
NewrelicMobile.instance.setUserId("RN12934");Sintaxis
setUserId(userId: string): void;Descripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Ejemplo [#example]
NewRelic.setUserId("RN12934");Sintaxis
SetUserId(string userId): bool;Descripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Ejemplo [#example]
NewRelicAgent.SetUserId("User123");Sintaxis
setUserId(FString userId): void;Descripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Ejemplo [#example]
#include "NewRelicBPLibrary.h"
UNewRelicBPLibrary::setUserId("Unreal12934");Sintaxis
SetUserId(string userId): bool;Descripción [#description]
Establezca un valor de identificador de usuario personalizado para asociar sesiones de usuario con eventos y atributos de análisis.
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El ID de usuario que se asociará con la sesión actual. |
Ejemplo [#example]
CrossNewRelicClient.Current.SetUserId("User123");