Sintaxe
Java
NewRelic.setUserId(string $userId)Kotlin [#kotlin]
NewRelic.setUserId(userId: String?)Descrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Este método define um valor de identificador de usuário personalizado para associar todos os eventos da sessão de um usuário móvel a um ID de usuário específico. Este método pode ser chamado a qualquer momento após o agente Android do New Relic ser iniciado.
Um identificador de usuário é útil por vários motivos. Usando a interface de análise de falhas, você pode:
- Encontre falhas específicas de um usuário. Concentrar-se em uma falha específica de um usuário geralmente é suficiente para resolver o problema rapidamente.
- Filtre todos os travamentos para mostrar as ocorrências de um usuário (ou grupo de usuários) para cada tipo de travamento; inversamente, filtre a lista de falhas para mostrar os usuários afetados por cada tipo de falha. Se o ID do usuário for representado como um endereço de e-mail, será fácil entrar em contato e informá-los quando houver uma solução disponível que resolva essas falhas.
Se você não deseja identificar explicitamente o usuário devido às regras de privacidade, este método ainda é útil ao rastrear segmentos de usuário, como usuário final pago versus gratuito ou usuário registrado versus não registrado. Isso permite que você filtre ou analise o número e os tipos de falhas sofridas por cada segmento e faça divulgação com base nesse segmento.
Para mais contexto sobre como usar esta API, consulte Enviar atributo personalizado e evento.
Importante
As seguintes melhorias foram adicionadas ao agente Android v7.4.0:
- Quando
setUserId(value: string|null)é chamado, seuserIDera anteriormente nulo e o novo valor não é nulo, a sessão atual continua e um novouserIDserá definido. - Quando
setUserId(value: string|null)for chamado, seuserIDanteriormente não era nulo e o novouserIDfor diferente (incluindonull), a sessão atual será encerrada e uma colheita será executada. Uma nova sessão será criada com o novouserID.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. Define o ID do usuário. |
Valores de retorno [#return-values]
Retorna true se for bem-sucedido ou false se não.
Exemplo [#example]
Aqui está um exemplo para definir um identificador de usuário para associar a sessão do usuário a evento e atributo:
Java [#java]
boolean userIdWasSet = NewRelic.setUserId("SampleUserName");Kotlin [#kotlin]
val userIdWasSet = NewRelic.setUserId("SampleUserName")Sintaxe
Objetivo-c
+ (BOOL) setUserId:(NSString*)userId;Swift [#swift]
NewRelic.setUserId(userId: String!) -> BoolDescrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Este método define um valor de identificador de usuário personalizado para associar todos os eventos da sessão de um usuário móvel a um ID de usuário específico. Este método pode ser chamado a qualquer momento após o agente iOS da New Relic ser iniciado.
Um identificador de usuário é útil por vários motivos. Usando a interface de análise de falhas, você pode:
- Encontre falhas específicas de um usuário. Concentrar-se em uma falha específica de um usuário geralmente é suficiente para resolver o problema rapidamente.
- Filtre todos os travamentos para mostrar as ocorrências de um usuário (ou grupo de usuários) para cada tipo de travamento; ou filtre a lista de falhas para mostrar os usuários afetados por cada tipo de falha. Se o ID do usuário for representado como um endereço de e-mail, será fácil entrar em contato e informá-los quando houver uma solução disponível que resolva essas falhas.
Se você não deseja identificar explicitamente o usuário devido às regras de privacidade, este método ainda é útil ao rastrear segmentos de usuário, como usuário final pago versus gratuito ou usuário registrado versus não registrado. Isso permite que você filtre ou analise o número e os tipos de falhas sofridas por cada segmento e faça divulgação com base nesse segmento.
Importante
As seguintes melhorias foram adicionadas ao agente iOS v7.5.0:
Quando
setUserId(value: string|null)é chamado, seuserIdera anteriormente nulo e o novo valor não é nulo, a sessão atual continua e um novouserIdserá definido.Quando
setUserId(value: string|null)é chamado, seuserIdanteriormente não era nulo e o novouserIdé diferente (incluindonull), a sessão atual será encerrada e uma colheita será executada. Uma nova sessão será criada com o novouserId.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Valores de retorno [#return-values]
Retorna true se for bem-sucedido ou false se não.
Exemplo [#example]
Objective-C [#obj-c]
BOOL userIdWasSet = [NewRelic setUserId:@"SampleUserName"];Swift [#swift]
let userIdWasSet = NewRelic.setUserId("SampleUserName")Sintaxe
setUserId(options: { userId: string; }) => voidDescrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. Um objeto que contém o ID do usuário. |
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Exemplo [#example]
NewRelicCapacitorPlugin.setUserId({ userId: "CapacitorUserId" });Sintaxe
setUserId(userId: string): void;Descrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Exemplo [#example]
NewRelic.setUserId("CORDOVA12934");Sintaxe
SetUserId(string userId): bool;Descrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Exemplo [#example]
CrossNewRelic.Current.SetUserId("User123");Sintaxe
setUserId(String userId): void;Descrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Exemplo [#example]
NewrelicMobile.instance.setUserId("RN12934");Sintaxe
setUserId(userId: string): void;Descrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Exemplo [#example]
NewRelic.setUserId("RN12934");Sintaxe
SetUserId(string userId): bool;Descrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Exemplo [#example]
NewRelicAgent.SetUserId("User123");Sintaxe
setUserId(FString userId): void;Descrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Exemplo [#example]
#include "NewRelicBPLibrary.h"
UNewRelicBPLibrary::setUserId("Unreal12934");Sintaxe
SetUserId(string userId): bool;Descrição [#description]
Defina um valor de identificador de usuário personalizado para associar sessões de usuário a evento analítico e atributo.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. O ID do usuário a ser associado à sessão atual. |
Exemplo [#example]
CrossNewRelicClient.Current.SetUserId("User123");