カスタムイベント

この記事では、カスタムイベントとプロパティ、セグメンテーション、使用法、キャンバスエントリのプロパティ、関連する分析が表示される場所などについて説明します。Braze のイベントの詳細については、「イベント」を参照してください。

概要

カスタムイベントとは、ユーザーによって実行されたアクションまたはユーザーに関する更新です。アプリケーション内での高価値のユーザーインタラクションの追跡に最適です。カスタムイベントをログに記録すると、任意の数およびタイプのフォローアップキャンペーンをトリガーでき、そのイベントの新近度と頻度についてリストされたセグメンテーションフィルターが有効になります。

ユースケース

一般的なカスタムイベントのユースケースをいくつか示します。

• アクションベースの配信を使用して、カスタムイベントに基づくキャンペーンまたはキャンバスをトリガーします。 - ユーザーがカスタムイベントを実行した回数、最後にイベントが発生した日時などでユーザーをセグメント化します。 - ダッシュボードのカスタムイベント分析を使用して、各イベントの発生回数の集計を表示します。 -目標到達プロセスレポートとリテンションレポートを使用して追加の分析を見つけ出します。
• 永続的なエントリプロパティを活用し、キャンバスステップで顧客イベントのメタデータをパーソナライゼーションに使用します。
• Currents を使用してより高度な分析を行います。 - キャンバスの例外イベントを設定して、ユーザーがキャンバスの次のステップに進んではならない状況を定義します。

カスタムイベントの管理

ダッシュボードでカスタムイベントの作成や管理を行うには、[データ設定] > [カスタムイベント] に移動します。

このページでは、既存のカスタムイベントの表示、管理、作成、または禁止リストへの追加ができます。

カスタムイベントは、アクションメニューから個別に禁止リストに追加することも、最大 10 件のイベントを選択して一括登録することもできます。あるカスタムイベントを禁止した場合、そのイベントに関するデータは収集されず、再アクティブ化しない限り既存のデータが利用できなくなります。また、禁止リストに追加されたイベントはフィルターやグラフに表示されません。さらに、イベントが現在 Braze ダッシュボードの他の領域にあるフィルターまたはトリガーから参照されている場合、それを参照しているフィルターまたはトリガーのすべてのインスタンスが削除されてアーカイブされることを説明する警告モーダルが表示されます。

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

カスタムイベントには追加の設定が必要です。以下に、さまざまなプラットフォームでカスタムイベントのログ記録に使用される方法を示します。これらのページには、カスタムイベントにプロパティと数量を追加する方法に関するドキュメントもあります。

Expand for documentation by platform

• Android と FireOS
• iOS
• Web
• React Native
• Unity
• Xamarin
• Roku

カスタムイベントの保存

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

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

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

セグメンテーションオプション	ドロップダウンフィルター	入力オプション
カスタムイベントの発生した回数が X より大きいかをチェックする	[超]	数値
カスタムイベントの発生した回数が X 未満かをチェックする	[未満]	数値
カスタムイベントの発生した回数が正確に X かをチェックする	[完全一致]	数値
カスタムイベントの最終発生時刻が日付 X より後かをチェックする	[後]	時刻
カスタムイベントの最終発生時刻が日付 X より前かをチェックする	[前]	時刻
カスタムイベントの最終発生時刻が過去 X 日間より前かをチェックする	[超]	過去の日数 (正の整数)
カスタムイベントの最終発生時刻が 過去 X 日間以内かをチェックする	[未満]	過去の日数 (正の整数)
カスタムイベントの発生回数が X 回より多い (X の最大値 = 50) かをチェックする	[超]	過去 Y 日間 (Y = 1,3,7,14,21,30)
カスタムイベントの発生回数が X 回未満 (X の最大値 = 50) かをチェックする	[未満]	過去 Y 日間 (Y = 1,3,7,14,21,30)
カスタムイベントの発生回数が正確に X 回 (X の最大値 = 50) かをチェックする	[完全一致]	過去 Y 日間 (Y = 1,3,7,14,21,30)

分析

Braze はセグメンテーション用として、これらのイベントが発生した回数と、各ユーザーの最終実行時刻を記録します。これらの分析は、[分析] > [カスタムイベントレポート] で確認できます。

ダッシュボードの [カスタムイベントレポート] ページでは、各カスタムイベントの発生頻度を集計したり、セグメント別に表示したりして、より詳細な分析ができます。キャンペーンがカスタムイベントのアクティビティにどのように影響したかを確認する場合に、Braze が時系列に重ねて表示するため、キャンペーンの最終送信時刻を示す灰色の線を調べると特に役立ちます。

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

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

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

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

カスタムイベントプロパティは、イベントの特定の発生を表すカスタムイベントのメタデータまたは属性です。したがって、これらのプロパティを使用して、トリガー条件の絞り込み、メッセージングのパーソナライゼーションの強化、コンバージョンの追跡、未加工データのエクスポートによるより高度な分析の生成ができます。

カスタムイベントプロパティは Braze のプロファイルに保存されないため、データポイントを消費しません (例外については以下の「データポイント」を参照)。

必要なフォーマット

プロパティ値は、キーがプロパティ名、値がプロパティ値であるオブジェクトでなければなりません。プロパティ名は、255 文字以下の空でない文字列でなければならず、先頭にドル記号 ($) は使用できません。

プロパティ値は、次のデータ型のいずれでもかまいません。

データ型	説明
数値	整数または浮動小数点数のいずれか
ブール型
日時	ISO-8601 形式または yyyy-MM-dd'T'HH:mm:ss:SSSZ 形式の文字列。配列内ではサポートされません。
文字列	255 文字以下。
配列	配列に日時を含めることはできません。
オブジェクト	オブジェクトは文字列として取り込まれます。
階層化オブジェクト	他のオブジェクト内にあるオブジェクト。詳細については、この記事の「階層化オブジェクト」のセクションを参照してください。

配列またはオブジェクト値を含むイベントプロパティオブジェクトには、最大 50 KB のイベントプロパティペイロードを設定できます。

カスタムイベントプロパティのデータ型は変更できますが、データの収集後にデータ型を変更した場合の影響に注意してください。

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

カスタムイベントプロパティを使用して、キャンペーントリガーの絞り込み、コンバージョンの追跡、メッセージングのパーソナライぜーションができます。

トリガーメッセージ

特定のキャンペーンまたはキャンバスのオーディエンスをさらに絞り込むには、カスタムイベントプロパティを使用します。例えば、e コマースアプリケーションがあり、ユーザーがカートを放棄したときにメッセージを送信する場合、カスタムイベントプロパティ cart value を追加することで、ターゲットオーディエンスをさらに絞り込んで、キャンペーンのパーソナライゼーションを向上できます。

階層化されたカスタムイベントプロパティはアクションベースの配信でもサポートされています。

メッセージのパーソナライゼーション

カスタムイベントプロパティは、メッセージングテンプレート内でパーソナライゼーションに使用することもできます。トリガーイベントでアクションベースの配信を使用するキャンペーンでは、そのイベントのカスタムイベントプロパティを使用してメッセージングのパーソナライゼーションができます。

例えば、ゲームアプリケーションで、あるレベルをクリアしたユーザーにメッセージを送信する場合、ユーザーがそのレベルを完了するまでに要した時間のプロパティを使用して、メッセージをさらにパーソナライズできます。この例のメッセージは、条件付き論理を使用して 3 つの異なるセグメント向けにパーソナライズされています。カスタムイベントプロパティ time_spent は、{{event_properties.${time_spent}}} を呼び出すことでメッセージに含めることができます。

フィルターに関する考慮事項

• API 呼び出し: API 呼び出しを行い、かつ「空白」フィルターを使用する場合、呼び出しから除外されたカスタムイベントプロパティは「空白」と見なされます。例えば、"event_property": "" を含めた場合、ユーザーは「空白でない」と見なされます。
• 整数: 数値のカスタムイベントプロパティにフィルターを適用するときに、値が非常に大きい場合は、「完全一致」フィルターを使用しないでください。数値が大きすぎると特定の長さに丸められ、フィルターが意図どおりに機能しないことがあります。

セグメンテーション

イベントプロパティのセグメンテーションにより、取得したカスタムイベントとそれらのイベントに関連するプロパティに基づいて、ターゲットユーザーを絞り込むことができます。この機能により、購入イベントとカスタムイベントをセグメント化するときのフィルターオプションがさらに追加されます。

カスタムイベントのイベントプロパティは、それを使用するすべてのセグメントでリアルタイムに更新されます。プロパティを管理するには、[データ設定] > [カスタムイベント] ページでカスタムイベントの [プロパティの管理] をクリックします。特定のセグメントフィルターで使用されるカスタムイベントプロパティの最大遡及履歴は 30 日間です。

これらのセグメンテーションフィルターには次のようなものがあります。

• 過去 Y 日間に、値 B のプロパティ A を持つカスタムイベントを X 回実行した。
• 過去 Y 日間に、値 B のプロパティ A を持ついずれかの購入を行った。
• 1、3、7、14、21、30 日以内に、セグメントに加えられる条件を満たした。

特定のイベントプロパティのデータは、カスタマーサクセスマネージャーによって有効にされた後にのみ記録されます。イベントプロパティは、その日付以降にのみ利用可能です。

データポイント

サブスクリプションの使用に関して、以下のフィルターでのセグメンテーション用に有効になっているカスタムイベントプロパティは、カスタムイベント自体でカウントされるデータポイントに加えて、すべて個別のデータポイントとしてカウントされます。

• X Custom Event Property in Y Days
• X Purchase Property in Y Days

キャンバスエントリのプロパティとイベントプロパティ

キャンバスのユーザージャーニーで canvas_entry_properties と event_properties を活用できます。詳細と例については、「キャンバスエントリのプロパティとイベントプロパティ」を参照してください。

• canvas entry properties
• event properties

階層化オブジェクト

階層化オブジェクト (他のオブジェクト内にあるオブジェクト) を使用すると、カスタムイベントや購入のプロパティとして階層化された JSON データを送信できます。この階層化されたデータは、メッセージ内のパーソナライズされた情報のテンプレート作成、メッセージ送信のトリガー、およびセグメンテーションに使用できます。

詳細については、階層化オブジェクトに関する記事を参照してください。

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

カスタムイベントプロパティは、ターゲティングの精度を高め、メッセージのパーソナライゼーションの印象を高めるように設計されています。カスタムイベントプロパティは、短期および長期のいずれでも Braze 内に保存できます。

イベントプロパティの値に基づいてセグメント化する場合、次の 2 つの方法があります。

1. 30 日以内: Braze サポート担当者は、Braze のセグメント内にある特定のイベントプロパティ値の頻度と新近度に基づいて、イベントプロパティのセグメンテーションができます。セグメント内のイベントプロパティを活用したい場合は、Braze のアカウントエグゼクティブまたはカスタマーサクセスマネージャーにお問い合わせください。このオプションはデータ使用量に影響することに注意してください。
   
   
2. 30 日以内およびそれ以降: 短期と長期の両方のイベントプロパティセグメンテーションに対応する目的で、セグメントエクステンションを使用できます。この機能を使用すると、過去 2 年間に追跡されたカスタムイベントとイベントプロパティに基づくセグメンテーションができます。このオプションがデータ使用量に影響しないことに注意してください。

お客様の特定のニーズに応じた最適なアプローチの推奨事項については、Braze カスタマーサクセスマネージャーにお問い合わせください。