カスタム属性の設定
Braze では、ユーザーに属性を割り当てるメソッドが提供されています。ダッシュボードでこれらの属性に基づき、ユーザーをフィルターおよびセグメント化できます。
実装前に、ベストプラクティス記事のカスタムイベント、ユーザー属性、および購入イベントで提供されるセグメンテーションオプションの例を確認してください。また、イベントの命名規則についてもよく理解しておくことをお勧めします。
デフォルトユーザー属性の割り当て
ユーザー属性は、現在のアクティブユーザーに割り当てられます。以下のデフォルトフィールドを設定できます。
FirstName
LastName
Email
Gender
DateOfBirth
Country
Language
HomeCity
PhoneNumber
実装例
名を設定するコードは以下のようになります。
1
m.Braze.setFirstName("User's First Name")
カスタムユーザー属性の割り当て
Braze では、デフォルトユーザー属性以外にも、複数の異なるデータタイプを使用してカスタム属性を定義できます。
カスタム属性値の設定
1
m.Braze.setCustomAttribute("boolAttribute", true)
1
m.Braze.setCustomAttribute("intAttribute", 5)
1
m.Braze.setCustomAttribute("floatAttribute", 3.5)
Braze では、FLOAT 値と DOUBLE 値がデータベースでまったく同じく処理されます。
1
m.Braze.setCustomAttribute("stringAttribute", "stringValue")
1
2
3
dateAttribute = CreateObject("roDateTime")
dateAttribute.fromISO8601String("1992-11-29 00:00:00.000")
m.Braze.setCustomAttribute("dateAttribute", dateAttribute)
1
2
3
4
5
stringArray = createObject("roArray", 3, true)
stringArray.Push("string1")
stringArray.Push("string2")
stringArray.Push("string3")
m.Braze.setCustomAttribute("arrayAttribute", stringArray)
カスタム属性のインクリメント / デクリメント
このコードは、インクリメントカスタム属性の例です。カスタム属性の値は、正または負の整数値でインクリメントできます。
1
m.Braze.incrementCustomUserAttribute("intAttribute", 3)
カスタム属性の設定解除
カスタム属性は、次のメソッドを使用して設定を解除することもできます。
1
m.Braze.unsetCustomAttribute("attributeName")
REST API によるカスタム属性の設定
REST API を使用してユーザー属性を設定することもできます。詳細については、ユーザー API のドキュメントを参照してください。
カスタム属性値の制限
カスタム属性値の最大長は255文字です。
メールのサブスクリプションステータスの管理
SDK から、ユーザーに対して以下のメールのサブスクリプションステータスをプログラムで設定できます。
サブスクリプションのステータス | 定義 |
---|---|
OptedIn |
配信登録済み、かつ明示的にオプトイン済み |
Subscribed |
購読済み、ただし明示的に選択されていない |
UnSubscribed |
配信停止済みまたは明示的にオプトアウト済み、あるいはその両方 |
これらの型は
BrazeConstants().SUBSCRIPTION_STATES
に属します
メールのサブスクリプションステータスを設定するメソッドは setEmailSubscriptionState()
です。ユーザーは、有効なメールアドレスを取得すると自動的に Subscribed
に設定されます 。ただし、明示的なオプトインのプロセスを確立し、ユーザーから明示的な同意を得た時点でこの値を OptedIn
に設定することをお勧めします。詳細については、「ユーザーサブスクリプションの管理」を参照してください。
使用例:
1
m.Braze.setEmailSubscriptionState(BrazeConstants().SUBSCRIPTION_STATES.OPTED_IN)