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日間のY中のX）を含む）は、各プロファイルがアクティブ である限り、無期限に保持されます。

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

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

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

  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は、カスタムイベントが発生した回数と、各ユーザーが最後にそのイベントを実行した時刻を記録し、セグメンテーションに使用します。これらの分析を表示するには、Analytics > カスタムイベントレポートに移動します。

ダッシュボードのカスタムイベントレポートページでは、各カスタムイベントがどのくらいの頻度で発生しているかを集計して表示できます。時系列に重ねて表示されるグレーの線は、最後にキャンペーンが送信された時刻を示しており、キャンペーンがカスタムイベントのアクティビティにどのような影響を与えたかを確認するのに役立ちます。

ダッシュボードのカスタムイベントページにあるカスタムイベント数グラフ。カスタムイベントのトレンドが表示されています

また、フィルターを使用して、カスタムイベントを時間別、月間アクティブユーザー数（MAU）別、セグメント別、またはKPI計算式別に分類することもできます。

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

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

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

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

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

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