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

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

ユーザー属性の設定

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

let builder = AdaptyProfileParameters.Builder()
    .with(email: "email@email.com")
    .with(phoneNumber: "+18888888888")
    .with(firstName: "John")
    .with(lastName: "Appleseed")
    .with(gender: .other)
    .with(birthday: Date())
    
do {
    try await Adapty.updateProfile(params: builder.build())
} catch {
    // handle the error
}

let builder = AdaptyProfileParameters.Builder()
    .with(email: "email@email.com")
    .with(phoneNumber: "+18888888888")
    .with(firstName: "John")
    .with(lastName: "Appleseed")
    .with(gender: .other)
    .with(birthday: Date())
    
Adapty.updateProfile(params: builder.build()) { error in
    if error != nil {
        // handle the error                        
    }
}

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

Tip

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

カスタムユーザー属性

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

do {
     builder = try builder.with(customAttribute: "value1", forKey: "key1")
} catch {
     // handle key/value validation error
}

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

do {
     builder = try builder.withRemoved(customAttributeForKey: "key2")
} catch {
     // handle error
}

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

Warning

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

制限事項

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