カスタムイベント
この記事では、カスタムイベントとプロパティ、ユーザープロファイルのイベント履歴、関連するセグメンテーションフィルター、キャンバスエントリプロパティ、関連する分析などについて説明します。Brazeのイベント全般については、イベントを参照してください。
カスタムイベントとは、ユーザーが実行したアクション、またはユーザーに関する更新です。カスタムイベントが記録されると、任意の数と種類のフォローアップキャンペーンをトリガーできます。その後、セグメンテーションフィルターを使用して、カスタムイベントの発生の新しさや頻度に基づいてユーザーをセグメント化できます。そのため、カスタムイベントはアプリケーション内での価値の高いユーザーインタラクションのトラッキングに最適です。
ユースケース
カスタムイベントの一般的なユースケースには、次のようなものがあります。
- アクションベースの配信を使用して、カスタムイベントに基づいてキャンペーンやキャンバスをトリガーする
- カスタムイベントの実行回数、最後にイベントが発生した日時などでユーザーをセグメント化する
- ダッシュボードのカスタムイベント分析を使用して、各イベントの発生頻度の集計を表示する
- ファネルレポートやリテンションレポートを使用して追加の分析を行う
- 永続的なエントリプロパティを活用して、顧客イベントのメタデータをキャンバスステップでのパーソナライゼーションに使用する
- Currentsを使用してより高度な分析を生成する
- 終了条件を設定して、ユーザーがキャンバスを終了するタイミングを定義する
トラッキングすべき推奨イベント
カスタムイベント戦略を計画する際は、エンゲージメントを促進し、ユーザージャーニーの理解に役立つ、以下のような種類のイベントのトラッキングを検討してください。
マーケティングアトリビューション
マーケティングキャンペーンの詳細を取得するカスタムイベントを記録して、ユーザーがアプリや Web サイトをどのように見つけたかをトラッキングします。ユーザーがメールキャンペーン、有料広告、ソーシャルメディアから訪れた場合は、UTM パラメーターをイベントプロパティとして取得します。
- イベント名:
campaign_visitまたはmarketing_click - トラッキングするプロパティ:
utm_source(facebookやnewsletterなど、トラフィックの発生元)、utm_medium(emailやpaid_socialなど、チャネルの種類)、utm_campaign(特定のキャンペーン識別子)、utm_content(特定のリンクまたはクリエイティブ)、utm_term(有料検索キーワード)
これにより、獲得チャネル別にユーザーをセグメント化し、キャンペーンのパフォーマンスを測定し、どのキャンペーンがコンバージョンにつながったかに基づいて、ターゲットを絞ったフォローアップメッセージングをトリガーできます。
検索行動
ユーザーがアプリや Web サイト内で検索したタイミングをトラッキングして、ユーザーが何を探しているかを把握し、コンテンツの不足を特定します。
- イベント名:
search_submitted - トラッキングするプロパティ:
search_query(入力された検索語)、results_count(返された結果の数)、selected_result(ユーザーがクリックした結果がある場合はその結果)
このデータを使用して、特定のトピックに関心のあるユーザーのセグメントを作成したり、パーソナライズされたレコメンデーションをトリガーしたり、結果がほとんど返されない人気の検索を特定したりできます。
機能エンゲージメント
主要な機能の使用状況をトラッキングして、どの機能が価値を生み出しているかを把握します。
- チュートリアルまたはオンボーディングのステップ: 各ステップの完了を記録して、ユーザーが離脱する箇所を特定します
- 機能の発見: ユーザーが重要な機能を初めて使用したタイミングをトラッキングします
- コンテンツとのインタラクション: ユーザーがコンテンツを保存、共有、ブックマークしたタイミングを記録します
- ユーザー生成コンテンツ: ユーザーがコンテンツを作成、編集、公開したタイミングをトラッキングします
コンバージョンのマイルストーン
購入そのものだけでなく、収益につながるマイクロコンバージョンもトラッキングします。
- ウィッシュリストまたはお気に入りへの追加: ユーザーが検討している商品を特定します
- 商品の比較: ユーザーがどの商品を並べて比較しているかをトラッキングします
- フォームの開始と完了: 複数ステップのフローにおける離脱を測定します
- 予約や予約申し込み: スケジュール設定の行動をトラッキングします
ベストプラクティス
カスタムイベントを実装する際は、次の点に注意してください。
- 一貫した命名を使用する: 命名規則(
snake_caseやcamelCaseなど)を決め、すべてのイベントで統一して使用します - ユーザーのアクションに注目する: システムが裏側で行う処理ではなく、ユーザーが行うことをトラッキングします
- イベントプロパティをフラットに保つ: イベントプロパティで深く階層化されたオブジェクトを避けます
- 意味のある名前を使用する:
vid_endではなくvideo_completedのように、アクションを明確に表すイベント名を選択します
構築済みの e コマースイベントスキーマについては、e コマースの推奨イベントを参照してください。
カスタムイベントの管理
ダッシュボードでデータ設定 > カスタムイベントに移動すると、カスタムイベントを管理、作成、またはブロックリストに登録できます。
重複したカスタム属性またはイベントのトラブルシューティング
同じ表示名を持つカスタムデータエントリが2つ表示される場合、一方のエントリに見えない先頭または末尾のスペースが含まれている可能性があります。
トラブルシューティングと修正方法:
- データ設定 > カスタム属性またはカスタムイベントに移動し、同じ名前に見える2つのエントリを見つけます。
- いずれかの名前に非表示の空白が含まれているかどうかを確認します。
- 各名前を右クリックし、検証を選択します。
- ブラウザの開発者ツールでHTMLテキスト値を確認します。
- 値を比較します(例:
emailと ` email`)。 - 必要に応じて、Chrome DevTools でページとスタイルを検証・編集するを参照してください。
- 正規キーとして残す名前を決定し、その正確なスペルと大文字小文字に統一します。
- 一方のエントリに先頭または末尾のスペースが含まれており、ダッシュボードで直接作成されたものである場合は、そのエントリの使用を停止し、正規キーに移行します。
- ダッシュボードのワークフロー、CSVインポート、内部ランブックを正規キーを使用するように更新します。
- 廃止する準備ができたら、不正なエントリのカスタムデータをブロックリストに追加します。
- データ取り込みパスを確認します。
- APIおよびSDKペイロードは、先頭と末尾のスペースを自動的に除去します。
- ダッシュボードで作成された名前は自動トリミングされないため、手動入力とガバナンスが必要です。
カスタムイベントの横にあるメニューを選択すると、次のアクションを実行できます。
ブロックリスト
アクションメニューからカスタムイベントを個別にブロックリストに登録できるほか、最大100件のイベントを選択して一括でブロックリストに登録することもできます。
カスタムイベントをブロックすると、次のようになります。
- そのイベントの今後のデータは収集されません。
- そのイベントのブロックが解除されない限り、既存のデータは利用できません。
- そのイベントはフィルターやグラフに表示されません。
また、ブロックしたカスタムイベントが Braze の他の領域でフィルターやトリガーとして参照されている場合は、警告モーダルが表示されます。このモーダルでは、そのイベントを参照しているフィルターやトリガーのすべてのインスタンスが削除され、アーカイブされることが説明されます。
カスタムデータのブロックリスト登録と削除の詳細については、カスタムデータのブロックリストを参照してください。
説明の追加
Manage Events, Attributes, Purchases のユーザー権限があれば、カスタムイベントの作成後に説明を追加できます。カスタムイベントの説明を編集を選択し、チーム向けのメモなど、任意の内容を入力します。
タグの追加
「Manage Events, Attributes, Purchases」のユーザー権限があれば、カスタムイベントの作成後にタグを追加できます。追加したタグは、イベントリストのフィルタリングに使用できます。
データのエクスポート
カスタムイベントのリストを CSVファイルとしてエクスポートするには、ページ上部のすべてエクスポートを選択します。CSVファイルが生成され、ダウンロードリンクがメールで送信されます。

プロファイルに定義または保存できる個別のカスタムイベントやカスタム属性の数について、ダッシュボード上の固定の上限はありません。実際の上限は、データの構造、取り込み量、ワークスペースのパフォーマンスによって異なります。非常に多くのイベントや属性をトラッキングする予定がある場合は、データモデリングとデータの整理(たとえば、使用していないデータのブロックリスト登録)について、Braze のアカウントチームにご相談ください。
使用状況レポートの表示
使用状況レポートには、特定のカスタムイベントを使用しているすべてのキャンバス、キャンペーン、セグメントが一覧表示されます。このリストには、Liquidでの使用は含まれません。
各カスタムイベントの横にあるチェックボックスを選択してから使用状況レポートを表示を選択すると、一度に最大100件の使用状況レポートを表示できます。
カスタムイベントのログ記録
カスタムイベントには追加の設定が必要です。カスタムイベントのログ記録に使用するメソッドと、カスタムイベントにプロパティや数量を追加する方法については、以下の各プラットフォームのドキュメントを参照してください。
展開してプラットフォーム別のドキュメントを表示
カスタムイベントのストレージ
ユーザープロファイルに保存されているすべてのデータ(カスタムイベントのメタデータ(初回または最終発生日時、合計回数、30日間のY日中X日)を含む)は、各プロファイルがアクティブ である限り、無期限に保持されます。
ユーザーのイベント履歴を表示する
ユーザープロファイルのイベント履歴タブでは、そのユーザーの最近のカスタムイベントと購入を確認できます。インテグレーションがイベントを正しく記録しているかを確認したり、ユーザー単位の問題をダッシュボード上で直接トラブルシューティングしたりできます。
ユーザーのイベント履歴を表示するには、次の手順に従います。
- オーディエンス > ユーザー検索に移動し、ユーザーを選択してプロファイルを開きます。
- イベント履歴タブを選択します。
このタブには、過去30日間のユーザーのカスタムイベントと購入が、最新のものから順に最大100件まで表示されます。
各イベントには以下が含まれます。
- イベントタイプ: イベントがカスタムイベントか購入か。
- イベント名: 記録されたときのイベント名。
- 時刻: イベントが発生した日時。
- プロパティ: そのイベント発生時のすべてのイベントプロパティ (JSON形式で表示)。
主なユースケースは次のとおりです。
- 開発中やリリース後に、SDKまたはAPIのインテグレーションが想定どおりにイベントを送信しているかを確認する。
- イベントトリガー型のキャンペーンやキャンバスにユーザーがエントリした (またはしなかった) 理由をトラブルシューティングする。
- データエクスポートを設定せずに、特定のユーザーに関するサポート案件を調査する。

イベントプロパティには個人データが含まれる可能性があるため、イベント履歴タブを表示するには、ユーザーの検索、PIIの表示、ユーザーイベントプロパティの表示のユーザー権限が必要です。詳細については、会社のユーザー権限を参照してください。
セグメンテーションフィルター
次の表は、カスタムイベントでユーザーをセグメント化する際に使用できるフィルターを示しています。
| セグメンテーションオプション | ドロップダウンフィルター | 入力オプション |
|---|---|---|
| カスタムイベントがX回より多く発生したかどうかを確認します | MORE THAN | NUMBER |
| カスタムイベントがX回より少なく発生したかどうかを確認します | LESS THAN | NUMBER |
| カスタムイベントがちょうどX回発生したかどうかを確認します | EXACTLY | NUMBER |
| カスタムイベントの最終発生がX日付より後かどうかを確認します | AFTER | TIME |
| カスタムイベントの最終発生がX日付より前かどうかを確認します | BEFORE | TIME |
| カスタムイベントの最終発生がX日より前かどうかを確認します | MORE THAN | NUMBER OF DAYS AGO(正の数) |
| カスタムイベントの最終発生がX日以内かどうかを確認します | LESS THAN | NUMBER OF DAYS AGO(正の数) |
| カスタムイベントがX回(最大50)より多く発生したかどうかを確認します | MORE THAN | 過去Y日間(Y = 1,3,7,14,21,30) |
| カスタムイベントがX回(最大50)より少なく発生したかどうかを確認します | LESS THAN | 過去Y日間(Y = 1,3,7,14,21,30) |
| カスタムイベントがちょうどX回(最大50)発生したかどうかを確認します | EXACTLY | 過去Y日間(Y = 1,3,7,14,21,30) |
分析
Brazeは、セグメンテーションのために、カスタムイベントの発生回数と各ユーザーが最後に実行した日時を記録します。レポートの設定、フィルター、エクスポートオプションについては、カスタムイベントレポートを参照してください。
カスタムイベントレポートページでは、各カスタムイベントの発生頻度を集計して確認できます。時系列グラフに重ねて表示される灰色の線は、キャンペーンが最後に送信された日時を示します。これにより、キャンペーンがカスタムイベントのアクティビティにどのような影響を与えたかを確認できます。

フィルターを使用して、カスタムイベントを時間別、月間平均ユーザー数 (MAU)、セグメント、またはKPI式で分類することもできます。


カスタム属性をインクリメントすると、カスタムイベントと同様にユーザーのアクションをカウントできます。ただし、カスタム属性のデータは時系列で表示できません。時系列で分析する必要のないユーザーアクションは、この方法で記録してください。
カスタムイベント分析が表示されない理由
カスタムイベントデータを使用して作成されたセグメントでは、作成前の履歴データは表示されません。
カスタムイベントプロパティ
カスタムイベントプロパティは、イベントの特定の発生を記述するカスタムイベントのメタデータまたは属性です。これらのプロパティは、トリガー条件のさらなる絞り込み、メッセージングにおけるパーソナライゼーションの向上、コンバージョンのトラッキング、および生データエクスポートによるより高度な分析の生成に使用できます。
詳しくは、カスタムイベントプロパティを参照してください。