Skip to content

カスタム属性の設定

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)
「このページはどの程度役に立ちましたか?」
New Stuff!