カスタムイベント
この記事では、カスタムイベントとプロパティ、関連するセグメンテーションフィルタ、キャンバスエントリプロパティ、関連する分析などについて説明します。Braze のイベント全般については、「イベント」を参照してください。
カスタムイベントとは、ユーザーによって実行されたアクションまたはユーザーに関する更新です。カスタムイベントがログに記録されると、任意の数とタイプのフォローアップキャンペーンをトリガできます。その後、セグメンテーションフィルタ を使用して、最近の発生頻度とカスタムイベントの発生頻度に基づいてユーザーをセグメンテーションできます。これにより、カスタムイベントは、アプリケーション内の高価値のユーザーインタラクションの追跡に最適です。
ユースケース
一般的なカスタムイベントのユースケースをいくつか示します。
- アクションベースの配信 を使用したカスタムイベントに基づくキャンペーンまたはキャンバスのトリガ
- ユーザがカスタムイベントを実行した回数、イベントが最後に発生した時刻、および同様の方法でユーザをセグメント化する
- ダッシュボードカスタムイベント分析 を使用して、各イベントが発生した頻度の集計を表示する
- ファンネル およびretention レポートを使用した追加の分析の検索
- 永続的なエントリプロパティを活用し、キャンバスステップで顧客イベントのメタデータをパーソナライゼーションに使用します。
- Currents を使用してより高度な分析を行う
- ユーザーがキャンバスから退出するタイミングを定義する退出基準の設定
カスタムイベントの管理
ダッシュボードでカスタムイベントを管理、作成、またはブロックリストするには、データ設定 > カスタムイベントと移動します。
次のアクションのカスタムイベントの横にあるメニューを選択します。
ブロックリスト
アクションメニューから個々のカスタムイベントをブロックリストにすることも、最大100のイベントを一括で選択してブロックリストにすることもできる。
カスタムイベントをブロックする場合:
- そのイベントの将来のデータは収集されません。
- 既存のデータは、そのイベントがブロック解除されない限り使用できません。
- そのイベントはフィルタやグラフには表示されません。
さらに、ブロックされたカスタムイベントが、現在、Braze の他の領域のフィルタまたはトリガによって参照されている場合、それを参照するフィルタまたはトリガのすべてのインスタンスが削除され、アーカイブされることを示す警告モードが表示されます。
説明を加える
Manage Events, Attributes, Purchases
ユーザー権限がある場合は、作成後にカスタムイベントに説明を追加できます。カスタムイベントの [説明を編集] を選択し、チームへのメモなど好きなものを入力します。
タグを追加する
“Manage Events, Attributes, Purchases” user permission がある場合は、作成後にカスタムイベントにタグを追加できます。タグは、イベントのリストをフィルタリングするために使用できます。
利用レポートを見る
使用状況レポートには、特定のカスタムイベントを使用しているすべてのキャンバス、キャンペーン、およびセグメントが一覧表示されます。このリストには、Liquid の使用状況は含まれていません。
複数のカスタムイベントのチェックボックスを選択し、使用状況レポートの表示を選択することで、一度に最大100件の使用状況レポートを表示できます。
データのエクスポート
カスタムイベントのリストをCSV ファイルとしてエクスポートするには、ページ上部のExport all ボタンを選択します。CSVファイルが生成され、ダウンロードリンクがEメールで送信される。
カスタムイベントのログ記録
カスタムイベントには追加の設定が必要です。各プラットフォームに関するドキュメントについては、以下のリストを参照してください。ここでは、カスタムイベントのログ記録に使用される方法、およびカスタムイベントにプロパティと数量を追加する方法について説明します。
プラットフォーム別のドキュメントの拡張
カスタムイベントの保存
カスタムイベントのメタデータ (最初 / 最後の発生日時、合計数、30日間にわたる Y の X) を含む、ユーザープロファイルに保存されているすべてのデータは、各プロファイルがアクティブである限り無期限に保持されます。
セグメンテーションフィルター
次の表に、ユーザーのカスタムイベント別セグメンテーションに使用できるフィルターを示します。
セグメンテーションオプション | ドロップダウン・フィルター | 入力オプション |
---|---|---|
カスタムイベントがX回以上発生したかどうかをチェックする | より大きい | 数値 |
カスタムイベントの発生回数がX回未満かどうかをチェックする | 未満 | 数値 |
カスタムイベントが正確にX回発生したかどうかをチェックする | 正確に一致 | 数値 |
カスタムイベントが 日付 X より後に発生したかどうかをチェックする | 導入後 | 時間 |
カスタムイベントが日付 X より前に発生したかどうかをチェックする | 前 | 時間 |
カスタムイベントが最後に発生したのがX日以上前かどうかをチェックする | より大きい | 過去の日数(正の数) |
カスタムイベントが最後に発生したのがX日以内かどうかをチェックする | 未満 | 過去の日数(正の数) |
カスタムイベントがX(Max = 50)回以上発生したかどうかをチェックする。 | より大きい | 過去Y日間 (Y = 1,3,7,14,21,30) |
カスタムイベントがX (最大 = 50) 回未満発生したかどうかを確認する | 未満 | 過去Y日間 (Y = 1,3,7,14,21,30) |
カスタムイベントが正確に X (最大 = 50) 回発生したかどうかを確認する | 正確に一致 | 過去Y日間 (Y = 1,3,7,14,21,30) |
分析
Braze はセグメンテーション用として、カスタムイベントが発生した回数と、各ユーザーの最終実行時刻を記録します。Analytics> カスタムイベントレポートに移動して、これらの分析を表示します。
ダッシュボードのCustom Events Report ページで、各カスタムイベントの発生頻度を集約して表示できます。時系列にオーバーレイされた灰色の線は、キャンペーンが最後に送信された時刻を示します。これは、キャンペーンがカスタムイベントアクティビティにどのような影響を与えたかを表示するのに役立ちます。
フィルターを使用して、カスタムイベントを時間、月間平均ユーザー数 (MAU)、セグメント、または KPI 式別に分類することもできます。
カスタム属性 をインクリメントして、カスタムイベントに似たユーザアクションのカウンタを保持します。ただし、カスタム属性データを時系列で表示することはできません。時系列で分析する必要のないユーザーアクションは、この方法を使用して記録する必要があります。
カスタムイベント分析が表示されない理由
カスタムイベントデータを使用して作成されたセグメントでは、作成前の履歴データを表示できません。
カスタムイベントプロパティ
カスタムイベントプロパティは、イベントの特定の発生を表すカスタムイベントのメタデータまたは属性です。したがって、これらのプロパティを使用して、トリガー条件の絞り込み、メッセージングのパーソナライゼーションの強化、コンバージョンの追跡、生工データのエクスポートによるより高度な分析の生成ができます。
カスタムイベントプロパティは Braze プロファイルに保存されないため、データポイントを消費しません(例外についてはデータポイントを参照)。
各カスタムイベントまたは購入には、最大 256 個の異なるカスタムイベントプロパティを設定できます。256 個を超えるプロパティを持つカスタムイベントまたは購入がログ記録された場合、最初の 256 個のみが取得されて使用できます。
必要なフォーマット
プロパティ値は、キーがプロパティ名、値がプロパティ値であるオブジェクトでなければなりません。プロパティ名は、255 文字以下の空でない文字列でなければならず、先頭にドル記号 ($
) は使用できません。
プロパティ値は、次のデータ型のいずれでもかまいません。
データ型 | 説明 |
---|---|
数値 | 整数または浮動小数点数として |
ブール値 | true またはfalse の値。 |
日時 | ISO-8601またはyyyy-MM-dd'T'HH:mm:ss:SSSZ 形式の文字列としてフォーマットされる。アレイ内ではサポートされていない。 |
文字列 | 255 文字以下。 |
配列 | 配列に日時を含めることはできない。 |
ネストされたオブジェクト | 他のオブジェクトの中にあるオブジェクト。詳細については、この記事の「階層化オブジェクト」のセクションを参照してください。 |
配列またはオブジェクト値を含むイベントプロパティオブジェクトには、最大100 KB のイベントプロパティペイロードを設定できます。
カスタムイベントプロパティのデータ型は変更できますが、データの収集後にデータ型を変更した場合の影響に注意してください。
カスタムイベントプロパティの使用
カスタムイベントプロパティを使用して、キャンペーントリガーの絞り込み、コンバージョンの追跡、メッセージングのパーソナライぜーションができます。
トリガーメッセージ
カスタムイベントプロパティを使用して、特定のキャンペーンまたはキャンバスの対象をさらに絞り込むことができます。例えば、eコマース・アプリケーションを持っていて、ユーザーがカートを放棄したときにメッセージを送りたい場合、item price
のカスタムイベントプロパティを追加することで、ターゲットオーディエンスを改善し、キャンペーンのパーソナライゼーションを高めることができる。
階層化されたカスタムイベントプロパティはアクションベースの配信でもサポートされています。
メッセージのパーソナライゼーション
カスタムイベントプロパティは、メッセージングテンプレート内でパーソナライゼーションに使用することもできます。トリガーイベントを持つアクションベース配信を使用するキャンペーンは、メッセージングパーソナライゼーションのために、そのイベントのカスタムイベントプロパティを使用することができます。
たとえば、ゲームアプリがあり、レベルを完了したユーザーにメッセージを送信する場合、ユーザーがそのレベルを完了するのにかかった時間のために、プロパティを使用してメッセージをさらにパーソナライズできます。この例では、メッセージは条件付きロジックを使用して3つの異なるセグメントに対してパーソナライズされています。カスタムイベントプロパティ time_spent
は、{{event_properties.${time_spent}}}
を呼び出すことでメッセージに含めることができます。
1
2
3
4
5
6
7
{% if {{event_properties.${time_spent}}} < 600 %}
Incredible work, hero! Are you ready to test your skills against other powerful heroes? Visit the Arena for real-time battles with top players from around the globe.
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Great job, hero! Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Well done, hero! Talk to villagers for tips on how to beat levels faster and unlock more rewards.
{% endif %}
ユーザにインターネット接続がない場合、テンプレート化されたカスタムイベントプロパティ(たとえば、{{event_properties.${time_spent}}}
)を持つトリガされたアプリ内メッセージは失敗し、表示されません。
アプリ内メッセージをテンプレート化したアプリ内メッセージとして配信するための Liquid タグの完全なリストについては、よくある質問を参照してください。
フィルターに関する考慮事項
- API 呼び出し:API 呼び出しを行い、かつ「空白」フィルターを使用する場合、呼び出しから除外されたカスタムイベントプロパティは「空白」と見なされます。例えば、
"event_property": ""
を含めた場合、ユーザーは「空白でない」と見なされます。 - 整数:数値のカスタムイベントプロパティにフィルターを適用するときに、値が非常に大きい場合は、「完全一致」フィルターを使用しないでください。数値が大きすぎると特定の長さに丸められ、フィルターが意図どおりに機能しないことがあります。
セグメンテーション
イベントプロパティセグメンテーションを使用して、取得されたカスタムイベントと、それらのイベントに関連付けられたプロパティに基づいて、ターゲットユーザを対象にします。これにより、購入イベントとカスタムイベントでセグメンテーションを行うときのフィルタリングオプションが増えます。
カスタムイベントのイベントプロパティは、それを使用するすべてのセグメントでリアルタイムに更新されます。プロパティの管理は、「データ設定」>「カスタムイベント」と進み、関連するカスタムイベントの「プロパティの管理」を選択することで行える。特定のセグメントフィルターで使用されるカスタムイベントプロパティの最大遡及履歴は 30 日間です。
セグメンテーションのためにイベントプロパティを追加する。
イベントプロパティの再帰性と頻度に基づいてセグメンテーションを作成するには、「カスタムイベントプロパティのセグメンテーションを管理する」ユーザー権限が必要です。
デフォルトでは、1 つのワークスペースにつき 20 個のセグメンテーション可能なイベントプロパティを設定できます。この制限を増やすには、Brazeアカウントマネージャーに連絡する。
セグメンテーションのためにイベントプロパティを追加するには、以下のようにする:
- カスタムイベントに移動し、[プロパティを管理] を選択します。
- [セグメンテーションを有効にする] トグルを選択して、セグメンテーションのイベントプロパティを追加します。セグメンテーションの際に、追加のフィルターオプションにアクセスできる。
イベントプロパティセグメンテーションフィルターには次のようなものがあります。
- 過去 Y 日間に、値 B のプロパティ A を持つカスタムイベントを X 回実行した。
- 過去 Y 日間に、値 B のプロパティ A を持ついずれかの購入を行った。
- 1~30日以内のセグメンテーション機能を追加。
特定のイベントプロパティのデータは、カスタマーサクセスマネージャーによって有効にされた後にのみ記録されます。イベントプロパティは、その日付以降にのみ利用可能です。
データポイント
サブスクリプションの使用に関して、以下のフィルターでのセグメンテーション用に有効になっているカスタムイベントプロパティは、カスタムイベント自体でカウントされるデータポイントに加えて、すべて個別のデータポイントとしてカウントされます。
X Custom Event Property in Y Days
X Purchase Property in Y Days
キャンバスエントリのプロパティとイベントプロパティ
You can use Canvas entry properties and event properties in your Canvas user journeys.
Canvas entry properties are the properties you map for Canvases that are action-based or API-triggered. Note that the canvas_entry_properties
object has a maximum size limit of 50 KB.
For in-app message channels specifically, canvas_entry_properties
can only be referenced in Canvas.
You can reference canvas_entry_properties
in any Message step with this Liquid format: canvas_entry_properties.${property_name}
. Note that the events must be custom events or purchase events to be used this way.
Use case
Let’s say a retail store, RetailApp, has the following request: \"canvas_entry_properties\" : {\"product_name\" : \"shoes\", \"product_price\" : 79.99}
.
RetailApp can pull the product name (shoes) into a message with this Liquid: {{canvas_entry_properties.${product_name}}}
.
RetailApp can also trigger specific messages to send for different product_name
properties in a Canvas that targets users after they’ve triggered a purchase event. For example, they can send different messages to users who purchased shoes and users who purchased something else by adding the following Liquid into a Message step.
1
2
3
4
5
6
{% if {{canvas_entry_properties.${product_name}}} == "shoes" %}
Your order is set to ship soon. While you're waiting, why not step up your shoe care routine with a little upgrade? Check out our selection of shoelaces and premium shoe polish.
{% else %}
Your order will be on its way shortly. If you missed something, you have until the end of the week to add more items to your cart for the same discounts.
{% endif %}
Expand for original Canvas editor
You can no longer create or duplicate Canvases using the original editor. This section is available for reference only. For the Canvases built with the original editor, Canvas entry properties can be referenced in the first full step of a Canvas only.
Event properties refer to the properties you set for custom events and purchases. These event_properties
can be used in campaigns with action-based delivery and Canvases.
You can’t use event_properties
in the first Message step of your Canvas. Instead, you must use canvas_entry_properties
or add an Action Paths step with the corresponding event before the Message step that includes event_properties
.
In Canvas, custom event and purchase event properties can be used in Liquid in any Message step that follows an Action Paths step. Make sure to use {{event_properties.${property_name}}}
if you’re referencing these event properties. These events must be custom events or purchase events to be used this way in the Message component.
In the first Message step following an Action Path, you can use event properties related to the event referenced in that Action Path. However, these event properties can only be used if the user actually performed the action (and didn’t get sorted into the Everyone Else group). You can have other steps (that are not another Action Paths or Message step) in between this Action Paths and the Message step.
Expand for original Canvas editor
You can no longer create or duplicate Canvases using the original editor. This section is available for reference only. For the original Canvas editor, event properties can’t be used in scheduled full steps. However, you can use event properties in the first full step of an action-based Canvas, even if the full step is scheduled.
Refer to Canvas entry properties and event properties for more information and examples.
階層化オブジェクト
階層化オブジェクト (他のオブジェクト内にあるオブジェクト) を使用すると、カスタムイベントや購入のプロパティとして階層化された JSON データを送信できます。この階層化されたデータは、メッセージ内のパーソナライズされた情報のテンプレート作成、メッセージ送信のトリガー、およびユーザーのセグメント化に使用できます。
詳細については、ネストされたオブジェクトの専用ページを参照してください。
カスタムイベントプロパティの保存
カスタムイベントプロパティは、ターゲティングの精度を高め、メッセージのパーソナライゼーションの印象を高めるように設計されています。カスタムイベントプロパティは、短期および長期のいずれでも Braze 内に保存できます。
イベントプロパティの値に基づいてセグメント化するには、次の2 つの方法があります。
- 30 日以内:Braze サポート担当者は、Braze のセグメント内にある特定のイベントプロパティ値の頻度と新近度に基づいて、イベントプロパティのセグメンテーションができます。セグメント内のイベントプロパティを活用したい場合は、Braze アカウントエグゼクティブまたはカスタマーサクセスマネージャーにお問い合わせください。このオプションは、データの使用に影響を与えます。
- 30 日以内およびそれ以降:短期と長期の両方のイベントプロパティセグメンテーションに対応する目的で、セグメントエクステンションを使用できます。この機能は、過去2 年間に追跡されたカスタムイベントとイベントプロパティに基づいてユーザーをセグメント化します。このオプションは、データの使用には影響しません。
お客様の特定のニーズに応じた最適なアプローチの推奨事項については、Braze カスタマーサクセスマネージャーにお問い合わせください。