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 メソッドで以前に設定した属性はリセットされません。

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 フィールドを使用してください。

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

制限事項

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