モバイル:User Attributes(ユーザー属性)の追加方法
ユーザー属性を作成するには、Mobile Console(モバイルコンソール)にユーザー属性を追加するとともに、開発者がWalkMe Mobile SDK APIを使用してアプリにユーザー属性を設定する必要があります。
Mobile Consoleでユーザー属性を追加します
この手順はすべてのユーザー属性で必須です。 セグメントやルールベースのゴールで属性を使用するために、コンソールに属性リファレンスを追加します。
- Mobile Consoleで、[Settings(設定)]、>[App Settings(アプリの設定)]、>[USER ATTRIBUTES(ユーザー属性)]をクリックします。
- [NEW ATTRIBUTE(新しい属性)]をクリックします。
- 属性名とプライバシーレベルを設定します。
-
- コードレスのユーザー属性の場合 - 設定した名前がアプリのストレージ上のキーと一致していることを確認してください(以下を参照)
- APIユーザー属性の場合 - 開発者がAPI呼び出しで一致するものを構成できるように、属性名とタイプを必ず提供してください。
プライベート属性
エンドユーザーのプライバシーとアプリの機密データを保護するために、ユーザー属性をプライベートに設定することができます。 この設定により、WalkMeは機密性の高いユーザー属性データを保存することはできません。WalkMe Mobile AIがエンドユーザーの行動に関する予測を提供する際に、このデータが考慮されることはなく、分析目的で保存されることもありません。
コードレスのユーザー属性
バージョン1.18.0から、WalkMe SDKはデバイスのSharedPreferences(Android)またはUserDefaults(iOS)からデータを取得し、ユーザー属性に保存することができるようになりました。
これによりWalkMe SDK APIを呼び出すことなく、これらのユーザー属性をより迅速かつスムーズに設定することができます。 必要なのは、使用したい値がSharedPreferences / UserDefaultsにすでに存在しているかどうかを開発者に確認することだけです。
iOSでのコードレス属性
iOSでは、WalkMeはUserDefaultsに設定された任意のキーに簡単にアクセスできます。 コンソールでは、UserDefaultsキーと同じ名前の属性を設定するだけです。
Androidでのコードレス属性
Androidでは、SharedPreferencesは1つの変数のプールではなく、さまざまなセクションに分かれています(各セクションはSharedPreferencesと呼ばれます)。
コンソールでは、SharedPreferencesキーの1つでユーザー属性を設定するには、この規則に従って参照する必要があります。 [SharePreferences セクション名] . [キー名] 、 例えば: telcosp 。 ユーザー名 。
WalkMe Mobile SDKでユーザー属性を追加する手順
iOS
開発者は以下のコードを実装する必要があります:
/** Regular User Attributes **/ +(void)setUserAttributeWithKey:(NSString *)key andValue:(id)value; +(void)setUserAttributes:(NSDictionary<NSString*,id> *)attributes; /** Private User Attributes **/ +(void)setPrivateUserAttributeWithKey:(NSString *)key andValue:(id)value; +(void)setPrivateUserAttributes:(NSDictionary<NSString*,id> *)attributes; /** Clearing Private User Attributes (if needed) **/ +(void)clearPrivateUserAttributes;
Android
開発者は以下のコードを実装する必要があります:
/** Regular (non private) User Attributes **/ public static void setUserAttribute(String key, Object value) public static void setUserAttributes(Map<String,Object> attributes) /** Private User Attributes **/ public static void setPrivateUserAttribute(String key, Object value) public static void setPrivateUserAttributes(Map<String,Object> attributes) /** Clearing Private User Attributes (if needed) **/ public static void clearPrivateUserAttributes()
複数値を持つユーザー属性
単一の値のユーザー属性を設定するために使用される同じAPIは、配列を表すユーザー属性を設定するためにも使用できます。
iOSの複数値を持つユーザー属性の例
[ABBI setUserAttributeWithKey:@"numbers" andValue:@[@"1", @"2"]];
Androidの複数値を持つユーザー属性の例
ABBI.setUserAttribute("numbers", new ArrayList<>(Arrays.asList("1", "2", "3")));
ユーザー属性を確認します
ユーザー属性が正常に追加されたことを確認するには、Power Modeのアプリ情報画面にある「ユーザー属性」セクションに表示されることで確認することができます。