カスタムデータを管理する

このページでは、キャンペーンやセグメントにカスタムデータを事前入力する方法、カスタムイベントと属性およびそのプロパティを管理する方法、データタイプを設定する方法について説明します。カスタムデータのブロックリスト登録と削除については、カスタムデータのブロックリスト登録を参照してください。

特にカスタム属性の管理方法（説明の追加、タグの追加、属性のPIIマーキングなど）については、カスタム属性の管理を参照してください。

カスタムデータの事前入力

開発チームがカスタムデータを統合する前に、そのカスタムデータを使用してキャンペーンやセグメントを設定したい場合があります。Brazeでは、データのトラッキングが始まる前に、ダッシュボード上でカスタムイベントとカスタム属性を事前に入力できます。これにより、これらのイベントや属性をドロップダウンで選択したり、キャンペーン作成プロセスで使用したりできるようになります。

カスタムイベントとカスタム属性を事前に入力するには、次の手順を実行します。

1. データ設定 > カスタムイベント、カスタム属性、または製品に移動します。製品ページの詳しい手順については、製品を参照してください。

2. カスタム属性、イベント、または製品を追加するには、それぞれのページに移動し、カスタム属性を追加、カスタムイベントを追加、または製品を追加を選択します。
   
   カスタム属性の場合は、その属性のデータ型(ブール値や文字列など)を選択します。属性のデータ型によって、その属性で使用できるセグメンテーションフィルターが決まります。
   
   
3. 保存を選択します。

カスタムイベントとカスタム属性の命名

カスタムイベントとカスタム属性では、大文字と小文字が区別されます。後で開発チームがこれらのカスタムイベントや属性を統合する際には、この点に注意してください。ここで指定した名前とまったく同じ名前でカスタムイベントや属性を指定する必要があります。そうしないと、Brazeは別のカスタムイベントや属性を生成します。

プロパティの管理

カスタムイベントまたは商品を作成したら、そのイベントまたは商品のプロパティを管理を選択します。ここでは、新しいプロパティの追加、既存プロパティのブロックリストへの登録、およびこのプロパティをトリガーイベントで使用しているキャンペーンやキャンバスの確認ができます。

イベントまたは商品のプロパティをブロックリストに登録するには、プロパティページのアクションメニューを使用します。カスタム属性、イベント、または商品全体をブロックリストに登録する方法については、カスタムデータのブロックリストを参照してください。

追加したカスタム属性、イベント、商品、またはイベントプロパティを追跡可能にするには、開発チームに依頼して、先ほど追加したときとまったく同じ名前でSDKに作成してもらう必要があります。または、Braze APIを使用して、その属性のデータをインポートすることもできます。その後、カスタム属性やイベントなどがアクション可能になり、ユーザーに適用されます。

Note:

All user profile data (custom events, custom attributes, custom data) is stored as long as those profiles are active.

環境間でのデータ型の検出

Brazeは、カスタム属性が最初に受け取った値に基づいて、そのデータ型を自動的に検出します。開発環境が最初に 100 のような数値を送信した場合、その属性は数値として保存されます。本番環境の最初の値が文字列 (引用符で囲まれた "100" など) として届いた場合、その属性は文字列として保存されます。

これを防ぐには、すべての環境で一貫したデータ型が送信されるように統合を設定してください。誤ったデータ型がすでに設定されている場合は、データ設定 > カスタム属性でデータ型ドロップダウンを使用して、正しいデータ型を強制的に適用できます。

データタイプの比較の強制

Brazeは、受信した属性データのデータタイプを自動的に認識します。しかし、1つの属性に複数のデータタイプが適用されている場合、任意の属性にデータタイプを強制することで、その属性の実体をBrazeに知らせることができます。データタイプ列のドロップダウンから選択してください。

注

2026年3月30日以降、自動検出は初回取り込み時にのみデータタイプを設定します。初回取り込み後にデータタイプを変更するには、以下の手順で手動で更新してください。

注

データタイプの強制は、イベントプロパティや購入プロパティには適用されません。

警告

属性のデータタイプを強制することを選択した場合、指定された型ではないデータがその型に強制的に変換されます。そのような変換が不可能な場合（例えば、文字を含む文字列を数値に変換する場合）、データは無視されます。型の変更前に取り込まれたデータは、古い型として引き続き保存され（したがって、セグメント化できない場合があります）、影響を受けるユーザーのプロファイルの属性の横に警告が表示されます。

タイプ変更後の既存データ

データタイプの強制変更は、Brazeに新しく入ってくるデータにのみ影響します。タイプ変更前に取り込まれたデータは、古い型として引き続き保存され、新しい型のフィルターではセグメント化できない場合があります。影響を受けるユーザーのプロファイルに警告が表示されます。新しく入ってくるデータについては、値が強制された型と一致しない場合、Brazeはその値を強制された型に変換する場合があります（例えば、文字列"100"を数値100に変換）。変換できない値は無視され、属性は更新されません。

既存のすべてのユーザーデータを新しい型に一致させる必要がある場合は、SDK、API、またはCSVインポートを通じて、それらのユーザーの属性値を再送信する必要があります。既存データの自動一括変換はありません。

データタイプの強制変換

異なるデータタイプの比較によって表示される特定のフィルターオプションの詳細については、レポートの設定を参照してください。また、利用可能なデータタイプの詳細については、データタイプを参照してください。

注

Brazeに送信されたデータは不変であり、Brazeが受信した後に削除または変更することはできません。ただし、ダッシュボードでトラッキングしている内容をコントロールするために、前のセクションに挙げたステップのいずれかを使用できます。カスタムデータのブロックリスト登録や削除については、カスタムデータのブロックリスト登録を参照してください。