ユーザーの更新

ユーザーの更新コンポーネントを使用すると、JSON エディターでユーザーの属性、イベント、購入を更新できるため、API キーなどの機密情報を含める必要がありません。

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

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

ユーザーがユーザー更新ステップに入り、処理が完了すると、次のステップに進みます。つまり、これらのユーザー更新に依存する後続のメッセージングは、次のステップが実行される時点で最新の状態になっています。

ユーザー更新の作成

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

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

ヒント

このコンポーネントで行った変更は、ユーザーを検索して変更を適用することでテストすることもできます。これによりユーザーが更新されます。

カスタム属性の更新

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

カスタム属性の削除

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

値の増減

ユーザー更新ステップでは、属性値を増減できます。属性を選択し、Increment By または Decrement By を選択して、数値を入力します。

週ごとの進捗をトラッキングする

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

オブジェクト配列の更新

オブジェクト配列は、ユーザーのプロファイルに保存されるデータが豊富なカスタム属性です。ユーザーとブランドとのインタラクション履歴を作成したり、購入履歴や生涯価値の合計などの計算フィールドに基づいてセグメントを作成したりできます。

Advanced JSON Editor オプションを使用すると、JSONを挿入してこのオブジェクト配列にアイテムを追加したり、アイテムを削除したりできます。

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

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

1. オブジェクト配列であるカスタム属性（例: wishlist）を作成します。各オブジェクトには、product_id、product_name、added_at などのフィールドを含めることができます。
2. ユーザー更新ステップで、Advanced JSON Editor を選択します。次に、Compose セクションで、$add オペレーションを使用してアイテムを追加するか、$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を保存し、リマーケティングキャンペーンに使用できます。パーソナライゼーション機能を使用して、キャンバスエントリプロパティを取得し、属性に保存します。

パーソナライゼーション

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

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

警告

ユーザー更新ステップでのConnected Content Liquidパーソナライゼーションの使用は慎重に行うことをお勧めします。このステップタイプには毎分200,000リクエストのレート制限があります。このレート制限はキャンバスのレート制限を上書きします。

高度なJSONエディター

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

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

考慮事項

JSONエディターの使用時に、APIキーなどの機密データを含める必要はありません。これはプラットフォームによって自動的に提供されます。以下のフィールドはJSONエディターに含めないでください:

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

重要

キャンバスプロパティ（canvas_id、canvas_name、canvas_variant_name Liquidタグなど）は、ユーザー更新ステップではサポートされていません。

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

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"
        }
      ]
    }
  ]
}