ユーザーの更新

ユーザー更新コンポーネントでは、ユーザーの属性、イベント、購入履歴をJSONエディタで更新できる。そのため、API キーのような機密情報を記載する必要はない。

このコンポーネントの仕組み

キャンバスでこのコンポーネントを使用する場合、更新は 1 分あたり/users/track 件のリクエストのレート制限にはカウントされません。代わりに、Braze ではこれらの更新がバッチ処理されるので、Braze-to-Braze の Webhook よりも効率的に処理することができます。このコンポーネントは、課金対象外のデータポイント（サブスクリプショングループなど）を更新する際に使用される場合、データポイントをログに記録しないことに注意せよ。

ユーザーがユーザー更新ステップに入り、処理が完了すると、次のステップに進む。これは、これらのユーザー更新に依存する後続のメッセージングは、次のステップが実行される時点で最新の状態であることを意味する。

ユーザーアップデートを作成する

サイドバーからコンポーネントをドラッグ＆ドロップするか、バリアントまたはステップの下部にあるプラスボタンを選択し、「ユーザー更新」を選ぶ。

既存のユーザープロファイル情報を更新する、新しい情報を追加する、あるいはユーザープロファイル情報を削除する、という三つの選択肢がある。ワークスペース内のユーザー更新ステップをすべて組み合わせると、1 分あたり最大 200,000 のユーザープロファイルを更新できます。

カスタム属性を更新する

カスタム属性を更新または削除するには、属性リストから属性名を選択し、値を入力する。

カスタム属性を削除する

カスタム属性を削除するには、ドロップダウンを使用して属性名を選択します。詳細な編集を行うには、高度なJSONエディタに切り替えることができる。

増加値と減少値

ユーザー更新ステップでは、属性値を増減させることができる。属性を選択し、[増分] または [減分] を選択して数値を入力します。

週次の進捗状況を追跡する

イベントを追跡するカスタム属性をインクリメントすることで、ユーザーが1週間に受講したクラス数を追跡することができる。このコンポーネントを使用すると、クラスカウントを週の始めにリセットして、再びトラッキングを開始できます。

オブジェクトの配列を更新する

オブジェクトの配列は、ユーザープロファイルに保存されるデータ豊富なカスタム属性である。これを使って、ユーザーが自社ブランドと行ったやり取りの履歴を作成できる。また、購入履歴や生涯価値総額といった計算フィールドに基づいてセグメントを作成することも可能だ。

高度なJSONエディタオプションを使用すれば、このオブジェクト配列に項目を追加したり削除したりするためにJSONを挿入できる。

ユースケース:ユーザーのウィッシュリストを更新する

ユーザーのウィッシュリストをトラッキングし、保存されたアイテムに基づいてセグメンテーションやパーソナライゼーションを行う。

1. オブジェクトの配列であるカスタム属性を生成する。例えばwishlist。各オブジェクトは、フィールドやフィールドproduct_nameproduct_idなどを含むadded_atことができる。
2. ユーザー更新ステップで、高度なJSONエディターを選択する。次に、コンポーズセクションで、演算$add子 append を使って項目を追加するか、演算$remove子 `remove` を使って値で項目を削除する。

以下はウィッシュリストにアイテムを追加する例だ：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "attributes": [
    {
      "wishlist": {
        "$add": [
          {
            "product_id": "SKU-123",
            "product_name": "Wireless Headphones",
            "added_at": "{{$isoTimestamp}}"
          }
        ]
      }
    }
  ]
}

アイテムを削除するには、同じオブジェクト構造で "wishlist": { "$remove": [ { "product_id": "SKU-123", ... } ] }を使用する。そうすればBrazeが一致させて削除できる。

ユースケース:ショッピングカートの合計を計算する

ユーザーがいつショッピングカートに商品を入れたか、いつ新しい商品を入れたか、いつ商品を削除したか、ショッピングカートの合計金額はいくらかなどを追跡する。

1. オブジェクトの配列をカスタムで作成するshopping_cart。次の例は、この属性がどのように見えるかを示している。各項目には固有の識別子product_idがあり、その識別子には独自のオブジェクトのネストされた配列に追加データが含まれている。これにはprice…も含まれる。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "attributes": [
    {
      "shopping_cart": [
       {
         "total_cart_value": number,
         "shipping": number,
         "items_in_cart": number,
         "product_id": array,
         "gift": boolean,
         "discount_code": "enum",
         "timestamp": {"$time" : "{{$isoTimestamp}}"},
       }
      ]
    }
  ]
}

2.ユーザーがバスケットに商品を追加したときに記録されるadd_item_to_cart というカスタムイベントを作成する。 3.このカスタムイベントを実行するユーザーを対象とするキャンバスを作成する。さて、ユーザーが商品をカートに入れると、このキャンバスがトリガーされる。その後、そのユーザーを直接ターゲットにしたメッセージングを行い、一定の支出額に達したとき、一定の期間カートを放棄したとき、あるいはその他のユースケースに一致したときに、クーポンコードを提供することができます。

shopping_cart 属性は、多くのカスタムイベントの合計を運ぶ：すべてのアイテムの合計金額、カート内のアイテムの合計数、ショッピングカートにギフトが含まれている場合など。例えば、次のようになります。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "attributes": [
    {
      "shopping_cart": [
       {
         "total_cart_value": 22.99,
         "shipping": 4.99,
         "items_in_cart": 2,
         "product_id": ["1001", "1002"],
         "gift": true,
         "discount_code": "flashsale1000",
         "timestamp": {"$time" : "{{$isoTimestamp}}"},
       }
      ]
    }
  ]
}

キャンバス・エントリーのプロパティを属性として設定する

ユーザーの更新ステップを使用して、canvas_entry_property を永続的に保存できます。例えば、アイテムがカートに追加されたときにトリガーされるイベントがあるとします。カートに追加された最新のアイテムの ID を保存し、それをリマーケッティングキャンペーンに使用できます。パーソナライゼーション機能を使用して、キャンバスのエントリプロパティを取得し、属性に保存します。

パーソナライゼーション

キャンバスのトリガーイベントのプロパティを属性として保存するには、パーソナライゼーションモーダルを使ってキャンバスのエントリプロパティを抽出し、保存します。ユーザーの更新では、次のパーソナライゼーション機能もサポートされています。

• コネクテッドコンテンツ
• コンテンツブロック
• エントリのプロパティ
• Liquid ロジック (メッセージの中止を含む)
• オブジェクトごとに複数の属性またはイベントを更新する

高度なJSONエディタ

JSONエディタに、最大65,536文字の属性、イベント、または購入JSONオブジェクトを追加する。ユーザーのグローバルサブスクリプションおよびサブスクリプショングループの状態も設定できます。

JSONエディタを使えば、プレビューとテストタブでユーザープロファイルが変更内容で更新されることをプレビューしテストすることもできる。ランダムなユーザーを選択するか、特定のユーザーを検索できます。次に、テストをユーザーに送信した後、生成されたリンクを使用してユーザープロファイルを表示します。

考慮事項

JSONエディタを使用する際、API キーのような機密データを含める必要はない。これはプラットフォームによって自動的に提供されるからだ。以下のフィールドはJSONエディタに含めるべきではない：

• 外部ユーザ ID
• APIキー
• BrazeクラスタURL
• プッシュトークンのインポートに関連するフィールド

カスタムイベントをログに記録する

JSONエディタを使えば、カスタムイベントも記録できる。注意せよ、これはISO形式のタイムスタンプを必要とする。したがって、最初にLiquidで日時を割り当てる必要がある。次の例は、イベントを時刻とともに記録します。

1
2
3
4
5
6
7
8
9
{% assign timestamp = 'now' | date: "%Y-%m-%dT%H:%M:%SZ" %}
{
  "events": [
    {
      "name": "logged_user_event",
      "time": "{{timestamp}}"
    }
  ]
}

次の例は、オプションのプロパティと app_id を持つカスタムイベントを使用して、イベントを特定のアプリにリンクします。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{% assign timestamp = 'now' | date: "%Y-%m-%dT%H:%M:%SZ" %}
{
  "events": [
    {
      "app_id": "insert_app_id",
      "name": "rented_movie",
      "time": "{{timestamp}}",
      "properties": {
        "release": {
          "studio": "FilmStudio",
          "year": "2022"
        },
        "cast": [
          {
            "name": "Actor1"
          },
          {
            "name": "Actor2"
          }
        ]
      }
    }
  ]
}

サブスクリプションの状態を編集する

JSONエディタ内では、ユーザーのサブスクリプション状態も編集できる。次の例は、ユーザーのサブスクリプション状態を opted_in に更新しています。

1
2
3
4
5
6
7
{
  "attributes": [
    {
      "email_subscribe": "opted_in"
    }
  ]
}

サブスクリプショングループを更新する

このキャンバスステップを使用して、サブスクリプショングループを更新することもできます。以下の例は、1つ以上のサブスクリプショングループを更新する方法を示す。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "attributes": [
    {
      "subscription_groups": [
        {
          "subscription_group_id": "subscription_group_identifier_1",
          "subscription_state": "subscribed"
        },
        {
          "subscription_group_id": "subscription_group_identifier_2",
          "subscription_state": "subscribed"
        },
        {
          "subscription_group_id": "subscription_group_identifier_3",
          "subscription_state": "subscribed"
        }
      ]
    }
  ]
}