Skip to content

Braze Learning コースカスタムイベント

この記事では、カスタムイベントとプロパティ、ユーザープロファイルのイベント履歴、関連するセグメンテーションフィルター、キャンバスエントリプロパティ、関連する分析などについて説明します。Brazeのイベント全般については、イベントを参照してください。

カスタムイベントとは、ユーザーによって実行されたアクションまたはユーザーに関する更新です。カスタムイベントが記録されると、任意の数とタイプのフォローアップキャンペーンをトリガーできます。その後、セグメンテーションフィルターを使用して、カスタムイベントの発生頻度や最終発生日時に基づいてユーザーをセグメント化できます。これにより、カスタムイベントは、アプリケーション内の高価値のユーザーインタラクションの追跡に最適です。

ユースケース

カスタムイベントの一般的なユースケースには、以下のようなものがあります。

  • アクションベースの配信を使用して、カスタムイベントに基づいてキャンペーンやキャンバスをトリガーする
  • カスタムイベントの実行回数、最後にイベントが発生した日時などでユーザーをセグメント化する
  • ダッシュボードのカスタムイベント分析を使用して、各イベントの発生頻度の集計を表示する
  • ファネルレポートやリテンションレポートを使用して追加の分析を行う
  • 永続的なエントリプロパティを活用して、顧客イベントのメタデータをキャンバスステップでのパーソナライゼーションに使用する
  • Currentsを使用してより高度な分析を生成する
  • 終了条件を設定して、ユーザーがキャンバスを終了するタイミングを定義する

カスタムイベントの管理

ダッシュボードでデータ設定 > カスタムイベントに移動して、カスタムイベントの管理、作成、またはブロックリスト登録を行うことができます。

重複するカスタム属性またはイベントのトラブルシューティング

同じ表示名を持つカスタムデータエントリが2つ表示される場合、一方のエントリに見えない先頭または末尾のスペースが含まれている可能性があります。

トラブルシューティングと修正方法：

  1. データ設定 > カスタム属性またはカスタムイベントに移動し、同じ名前に見える2つのエントリを見つけます。
  2. いずれかの名前に非表示の空白が含まれているかどうかを確認します。
    1. 各名前を右クリックし、検証を選択します。
    2. ブラウザの開発者ツールでHTMLテキスト値を確認します。
    3. 値を比較します（例：email と ` email`）。
    4. 必要に応じて、Chrome DevTools でページとスタイルを検証・編集するを参照してください。
  3. 正規キーとして残す名前を決定し、その正確なスペルと大文字小文字に統一します。
  4. 一方のエントリに先頭または末尾のスペースが含まれており、ダッシュボードで直接作成されたものである場合は、そのエントリの使用を停止し、正規キーに移行します。
    • ダッシュボードのワークフロー、CSVインポート、内部ランブックを正規キーを使用するように更新します。
    • 廃止する準備ができたら、不正なエントリのカスタムデータをブロックリストに追加します。
  5. データ取り込みパスを確認します。
    • APIおよびSDKペイロードは、先頭と末尾のスペースを自動的に除去します。
    • ダッシュボードで作成された名前は自動トリミングされないため、手動入力とガバナンスが必要です。

カスタムイベントの横にあるメニューを選択すると、以下のアクションを実行できます。

ブロックリスト登録

アクションメニューから個々のカスタムイベントをブロックリストに登録したり、最大100件のイベントを一括で選択してブロックリストに登録したりできます。

カスタムイベントをブロックすると、以下のようになります。

  • そのイベントの今後のデータは収集されません。
  • そのイベントのブロックが解除されない限り、既存のデータは利用できません。
  • そのイベントはフィルターやグラフに表示されません。

さらに、ブロックされたカスタムイベントがBrazeの他の領域でフィルターやトリガーによって現在参照されている場合、そのフィルターやトリガーのすべてのインスタンスが削除およびアーカイブされることを説明する警告モーダルが表示されます。

カスタムデータのブロックリスト登録と削除の詳細については、カスタムデータのブロックリストを参照してください。

説明の追加

Manage Events, Attributes, Purchases ユーザー権限を持っている場合、カスタムイベントの作成後に説明を追加できます。カスタムイベントの説明を編集を選択し、チームへのメモなど、任意の内容を入力してください。

タグの追加

「Manage Events, Attributes, Purchases」ユーザー権限を持っている場合、カスタムイベントの作成後にタグを追加できます。タグはイベントリストのフィルタリングに使用できます。

データのエクスポート

カスタムイベントのリストをCSVファイルとしてエクスポートするには、ページ上部のすべてエクスポートを選択します。CSVファイルが生成され、ダウンロードリンクがメールで送信されます。

使用状況レポートの表示

使用状況レポートには、特定のカスタムイベントを使用しているすべてのキャンバス、キャンペーン、およびセグメントが一覧表示されます。このリストにはLiquidの使用は含まれません。

それぞれのカスタムイベントの横にあるチェックボックスを選択し、使用状況レポートを表示を選択することで、一度に最大100件の使用状況レポートを表示できます。

カスタムイベントのログ記録

カスタムイベントには追加の設定が必要です。カスタムイベントのログ記録に使用するメソッドや、プロパティや数量をカスタムイベントに追加する方法については、以下のプラットフォームドキュメントを参照してください。

プラットフォーム別のドキュメントを展開

カスタムイベントストレージ

ユーザープロファイルに保存されるすべてのデータ（カスタムイベントメタデータ（最初または最後の発生、合計カウント、30日間のX in Y）を含む）は、各プロファイルがアクティブ である限り、無期限に保持されます。

ユーザーのイベント履歴を表示する

ユーザープロファイルのイベント履歴タブを使用して、そのユーザーの最近のカスタムイベントと購入を表示できます。これにより、インテグレーションがイベントを正しく記録しているかどうかを確認し、ユーザーレベルの問題をダッシュボードで直接トラブルシューティングできます。

ユーザーのイベント履歴を表示するには:

  1. オーディエンス > ユーザー検索に移動し、ユーザーを選択してプロファイルを開きます。
  2. イベント履歴タブを選択します。

このタブには、過去30日間のユーザーのカスタムイベントと購入が、最新のものから古いものの順に最大100件まで表示されます。

各イベントには以下の情報が含まれます:

  • イベントタイプ: イベントがカスタムイベントか購入かを示します。
  • イベント名: 記録されたイベント名です。
  • 時刻: イベントが発生した日時です。
  • プロパティ: その発生に関する完全なイベントプロパティがJSONとして表示されます。

一般的なユースケースには以下が含まれます:

  • 開発中またはリリース後に、SDKまたはAPIインテグレーションが期待どおりにイベントを送信しているかどうかを検証する。
  • ユーザーがイベントトリガーのキャンペーンやキャンバスにエントリしたかどうか、またはしなかった理由をトラブルシューティングする。
  • データエクスポートを設定せずに、特定のユーザーのサポート問題を調査する。

セグメンテーションフィルター

以下の表は、カスタムイベントによるユーザーのセグメンテーションに使用できるフィルターを示しています。

セグメンテーションオプション ドロップダウンフィルター 入力オプション
カスタムイベントが 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計算式別に分類することもできます。

カスタムイベントグラフのフィルター

カスタムイベント分析が表示されない理由

カスタムイベントデータを使用して作成されたセグメントでは、作成前の過去の履歴データを表示することはできません。

カスタムイベントプロパティ

カスタムイベントプロパティは、イベントの特定の発生を記述するカスタムイベントのメタデータまたは属性です。これらのプロパティは、トリガー条件のさらなる絞り込み、メッセージングにおけるパーソナライゼーションの向上、コンバージョンのトラッキング、および生データエクスポートによるより高度な分析の生成に使用できます。

詳細については、カスタムイベントプロパティを参照してください。
New Stuff!