Flutter SDKでユーザー属性を設定する

メールアドレスや電話番号などのオプション属性をアプリのユーザーに設定できます。設定した属性は、ユーザーセグメントの作成やCRMでの閲覧に活用できます。

ユーザー属性の設定

ユーザー属性を設定するには、.updateProfile() メソッドを呼び出します。

final builder = AdaptyProfileParametersBuilder()
  ..setEmail("[email protected]")
  ..setPhoneNumber("+18888888888")
  ..setFirstName('John')
  ..setLastName('Appleseed')
  ..setGender(AdaptyProfileGender.other)
  ..setBirthday(DateTime(1970, 1, 3));

try {
  await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

updateProfile メソッドで以前に設定した属性はリセットされません。

Adapty SDK がモバイルアプリにどのように統合されているか、実際の例を見てみませんか？ペイウォールの表示、購入処理、その他の基本機能を含む完全なセットアップを実演しているサンプルアプリをご覧ください。

使用可能なキーの一覧

AdaptyProfileParameters.Builder で使用できるキー <Key> と値 <Value> の一覧は以下のとおりです。

キー値

キー	値
email phoneNumber firstName lastName	String
gender	列挙型。使用できる値: `female`、`male`、`other`
birthday	Date

phoneNumber

firstName

lastName

String

gender 列挙型。使用できる値: female、male、other

birthday Date

カスタムユーザー属性

独自のカスタム属性を設定できます。カスタム属性は通常、アプリの利用状況に関連するものです。たとえば、フィットネスアプリであれば週ごとのエクササイズ回数、語学学習アプリであればユーザーの習熟度レベルなどが考えられます。カスタム属性をセグメントに活用して、ターゲットを絞ったペイウォールやオファーを作成したり、アナリティクスでどのプロダクト指標が収益に最も影響するかを分析したりできます。

try {
  final builder = AdaptyProfileParametersBuilder()
      ..setCustomStringAttribute('value1', 'key1')
      ..setCustomDoubleAttribute(1.0, 'key2');

await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}

既存のキーを削除するには、.withRemoved(customAttributeForKey:) メソッドを使用します。

try {
  final builder = AdaptyProfileParametersBuilder()
    ..removeCustomAttribute('key1')
    ..removeCustomAttribute('key2');

await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}

すでに設定されているカスタム属性を確認したい場合は、AdaptyProfile オブジェクトの customAttributes フィールドを使用してください。

customAttributes の値は最新でない場合があります。ユーザー属性は異なるデバイスからいつでも送信できるため、最後の同期以降にサーバー上の属性が変更されている可能性があります。

制限事項

ユーザーあたり最大30件のカスタム属性
キー名は最大30文字。キー名には英数字と次の文字を使用できます: _ - .
値は50文字以内の文字列または浮動小数点数。