カスタム属性の設定

Braze では、ユーザーに属性を割り当てるメソッドが提供されています。ダッシュボードでこれらの属性に基づき、ユーザーをフィルターおよびセグメント化できます。

実施にあたっては、まずカスタムイベントs、カスタム属性s、購買イベントが提供するセグメンテーション選択肢の事例をベストプラクティスで検討すること。

デフォルトユーザー属性の割り当て

ユーザー属性を割り当てるには、共有 BrazeBinding オブジェクトで適切なメソッドを呼び出す必要があります。以下は、このメソッドを使用して呼び出すことができる組み込み属性s の一覧です。

名

AppboyBinding.SetUserFirstName("first name");

姓

AppboyBinding.SetUserLastName("last name");

ユーザーのメールアドレス

AppboyBinding.SetUserEmail("[email protected]");

Braze 経由でメールを送信していない場合でも、メールアドレスを設定しておくと便利です。電子メールを使用すると、個々のユーザープロファイルの検索や問題の発生時のトラブルシューティングが容易になります。

性別

AppboyBinding.SetUserGender(Appboy.Models.Gender);

生年月日

AppboyBinding.SetUserDateOfBirth("year(int)", "month(int)", "day(int)");

ユーザー国

AppboyBinding.SetUserCountry("country name");

ユーザーの市区町村

AppboyBinding.SetUserHomeCity("city name");

ユーザーのメールサブスクリプション

AppboyBinding.SetUserEmailNotificationSubscriptionType(AppboyNotificationSubscriptionType);

ユーザプッシュサブスクリプション

AppboyBinding.SetUserPushNotificationSubscriptionType(AppboyNotificationSubscriptionType);

ユーザーの電話番号

AppboyBinding.SetUserPhoneNumber("phone number");

カスタムユーザー属性の割り当て

Braze では、デフォルトユーザー属性以外にも、複数の異なるデータ型を使用してカスタム属性を定義できます。 これらの各属性で使用できるセグメンテーションオプションの詳細については、このセクション内の「ベストプラクティス」ドキュメントを参照してください。

カスタム属性値を設定する

• ブール値
• 整数
• double
• string
• 日付
• 配列

1
AppboyBinding.SetCustomUserAttribute("custom boolean attribute key", 'boolean value');

1
2
3
4
// Set Integer Attribute
AppboyBinding.SetCustomUserAttribute("custom int attribute key", 'integer value');
// Increment Integer Attribute
AppboyBinding.IncrementCustomUserAttribute("key", increment(int))

1
AppboyBinding.SetCustomUserAttribute("custom double attribute key", 'double value');

1
AppboyBinding.SetCustomUserAttribute("custom string attribute key", "string custom attribute");

1
AppboyBinding.SetCustomUserAttributeToNow("custom date attribute key");

1
AppboyBinding.SetCustomUserAttributeToSecondsFromEpoch("custom date attribute key", 'integer value');

1
2
3
4
5
6
// Setting An Array
AppboyBinding.SetCustomUserAttributeArray("key", array(List), sizeOfTheArray(int))
// Adding to an Array
AppboyBinding.AddToCustomUserAttributeArray("key", "Attribute")
// Removing an item from an Array
AppboyBinding.RemoveFromCustomUserAttributeArray("key", "Attribute")

カスタム属性の設定解除

カスタム属性は、次のメソッドを使用して設定を解除することもできます。

1
AppboyBinding.UnsetCustomUserAttribute("custom attribute key");

REST API によるカスタム属性の設定

REST API を使用してユーザー属性を設定することもできます。そのためには、 ユーザー API ドキュメント を参照してください。

カスタム属性値の制限

カスタム属性値の最大長は 255 文字です。これより長い値は切り捨てられます。

ユーザーサブスクリプションの設定

ユーザーのサブスクリプション (メールまたはプッシュ) を設定するには、以下の関数を呼び出します。
それぞれ AppboyBinding.SetUserEmailNotificationSubscriptionType() またはAppboyBinding.SetPushNotificationSubscriptionType()。これらの関数はどちらも引数としてパラメータAppboy.Models.AppboyNotificationSubscriptionType を取ります。この型には、次の 3 つの状態があります。

Windows では、ユーザーにプッシュ通知を送る際に明示的なオプトインは必要ありません。ユーザーがプッシュ登録されると、デフォルトで OPTED_IN ではなく SUBSCRIBED に設定されます。詳細については、 サブスクリプションs と明示的なopt-ins の実装に関するドキュメントを参照してください。

• EmailNotificationSubscriptionType
  • 有効なメールアドレスを受信すると、ユーザは自動的にSUBSCRIBED に設定されます。ただし、明示的なオプトインプロセスを確立し、ユーザーから明示的な同意を受け取ったときにこの値をOPTED_IN に設定することをお勧めします。詳細については、ユーザーサブスクリプションの変更のドキュメントを参照してください。
• PushNotificationSubscriptionType
  • ユーザは、有効なプッシュ登録時に自動的にSUBSCRIBED に設定されます。ただし、明示的なオプトインプロセスを確立し、ユーザーから明示的な同意を受け取ったときにこの値をOPTED_IN に設定することをお勧めします。詳細については、ユーザーサブスクリプションの変更のドキュメントを参照してください。

これらのタイプは Appboy.Models.AppboyNotificationSubscriptionType に属します

サンプルコード

メールサブスクリプション:

1
AppboyBinding.SetUserEmailNotificationSubscriptionType(AppboyNotificationSubscriptionType.OPTED_IN);

プッシュ通知 サブスクリプション:

1
AppboyBinding.SetUserPushNotificationSubscriptionType(AppboyNotificationSubscriptionType.OPTED_IN);