構文
Java
NewRelic.setUserId(string $userId)
コトリン [#kotlin]
NewRelic.setUserId(userId: String?)
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
このメソッドは、カスタム ユーザー識別子の値を設定して、モバイル ユーザーのセッションからのすべてのイベントを特定のユーザー ID に関連付けます。このメソッドは、New Relic Android エージェントの起動後いつでも呼び出すことができます。
ユーザー識別子はいくつかの理由で役に立ちます。 衝突分析UI を使うと、以下のことができます。
- あるユーザーに特有のクラッシュを見つける。一人のユーザーの特定のクラッシュに焦点を当てることで、問題を素早く解決できることが多いです。
- すべてのクラッシュをフィルタリングして、各クラッシュタイプのユーザー(またはユーザーグループ)の発生状況を表示します。逆に、クラッシュリストをフィルタリングして、各クラッシュタイプの影響を受けたユーザーを表示します。ユーザーIDが電子メールアドレスとして表されている場合、それらのクラッシュに対応するソリューションが利用可能になったときに、簡単に連絡して知らせることができます。
個人情報保護の観点からユーザーを明示的に特定したくない場合でも、有料エンドユーザーと無料エンドユーザー、登録ユーザーと未登録ユーザーなどのユーザーセグメントを追跡する際には、この方法が有効です。これにより、各セグメントで経験したクラッシュの数や種類に基づいてフィルタリングやファセットを行い、そのセグメントに基づいてアウトリーチを行うことができます。
この API の使用方法の詳細については、 「カスタム属性とイベントを送信する」を参照してください。
重要
Android エージェント v7.4.0 では次の機能強化が追加されました。
setUserId(value: string|null)
が呼び出されたときに、userID
が以前は null で、新しい値が null でない場合、現在のセッションは継続され、新しいuserID
が設定されます。setUserId(value: string|null)
が呼び出されると、userID
が以前は null でなく、新しいuserID
が異なる場合 (null
を含む)、現在のセッションが終了し、収集が実行されます。 新しいuserID
を使用して新しいセッションが作成されます。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。ユーザーIDを設定します。 |
戻り値 [#return-values]
成功した場合はtrue
を返し、失敗した場合はfalse
を返します。
例 [#example]
ユーザー識別子を設定してユーザー セッションをイベントおよび属性に関連付ける例を次に示します。
Java [#java]
boolean userIdWasSet = NewRelic.setUserId("SampleUserName");
コトリン [#kotlin]
val userIdWasSet = NewRelic.setUserId("SampleUserName")
構文
目的-c
+ (BOOL) setUserId:(NSString*)userId;
迅速 [#swift]
NewRelic.setUserId(userId: String!) -> Bool
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
このメソッドは、カスタム ユーザー識別子の値を設定して、モバイル ユーザーのセッションからのすべてのイベントを特定のユーザー ID に関連付けます。このメソッドは、New Relic iOS エージェントの起動後いつでも呼び出すことができます。
ユーザー識別子はいくつかの理由で役に立ちます。 衝突分析UI を使うと、以下のことができます。
- あるユーザーに特有のクラッシュを見つける。一人のユーザーの特定のクラッシュに焦点を当てることで、問題を素早く解決できることがよくあります。
- すべてのクラッシュをフィルタリングして、各クラッシュタイプのユーザー(またはユーザーグループ)の発生状況を表示したり、クラッシュリストをフィルタリングして、各クラッシュタイプの影響を受けたユーザーを表示したりすることができます。ユーザーIDがメールアドレスとして表されていれば、それらのクラッシュに対応するソリューションが利用可能になったときに、簡単に連絡を取ることができます。
個人情報保護の観点からユーザーを明示的に特定したくない場合でも、有料エンドユーザーと無料エンドユーザー、登録ユーザーと未登録ユーザーなどのユーザーセグメントを追跡する際には、この方法が有効です。これにより、各セグメントで経験したクラッシュの数や種類に基づいてフィルタリングやファセットを行い、そのセグメントに基づいてアウトリーチを行うことができます。
重要
iOS エージェント v7.5.0 では次の機能強化が追加されました。
setUserId(value: string|null)
が呼び出されたときに、userId
が以前は null で、新しい値が null でない場合、現在のセッションは継続され、新しいuserId
が設定されます。setUserId(value: string|null)
が呼び出されたときに、userId
が以前は null でなく、新しいuserId
が異なる場合 (null
を含む)、現在のセッションが終了し、収集が実行されます。 新しいuserId
を使用して新しいセッションが作成されます。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
戻り値 [#return-values]
成功した場合はtrue
を返し、失敗した場合はfalse
を返します。
例 [#example]
Objective-C [#obj-c]
BOOL userIdWasSet = [NewRelic setUserId:@"SampleUserName"];
迅速 [#swift]
let userIdWasSet = NewRelic.setUserId("SampleUserName")
構文
setUserId(options: { userId: string; }) => void
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。ユーザー ID を含むオブジェクト。 |
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
例 [#example]
NewRelicCapacitorPlugin.setUserId({ userId: "CapacitorUserId" });
構文
setUserId(userId: string): void;
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
例 [#example]
NewRelic.setUserId("CORDOVA12934");
構文
SetUserId(string userId): bool;
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
例 [#example]
CrossNewRelic.Current.SetUserId("User123");
構文
setUserId(String userId): void;
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
例 [#example]
NewrelicMobile.instance.setUserId("RN12934");
構文
setUserId(userId: string): void;
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
例 [#example]
NewRelic.setUserId("RN12934");
構文
SetUserId(string userId): bool;
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
例 [#example]
NewRelicAgent.SetUserId("User123");
構文
setUserId(FString userId): void;
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
例 [#example]
#include "NewRelicBPLibrary.h"
UNewRelicBPLibrary::setUserId("Unreal12934");
構文
SetUserId(string userId): bool;
説明 [#description]
ユーザーセッションをAnalyticsのイベントや属性と関連付けるために、カスタムユーザー識別子の値を設定します。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必要。現在のセッションに関連付けられるユーザー ID。 |
例 [#example]
CrossNewRelicClient.Current.SetUserId("User123");