カスタムイベント

この記事では、カスタムイベントとプロパティ、関連するセグメンテーションフィルタ、キャンバスエントリプロパティ、関連する分析などについて説明します。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) を含む、ユーザープロファイルに保存されているすべてのデータは、各プロファイルがアクティブである限り無期限に保持されます。

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

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

分析

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

ダッシュボードのCustom Events Report ページで、各カスタムイベントの発生頻度を集約して表示できます。時系列に重ねられた灰色の線は、キャンペーンが最後に送信された時刻を示します。これは、キャンペーンがカスタムイベント活動にどのような影響を与えたかを表示するのに役立ちます。

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

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

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

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

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

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

必要なフォーマット

プロパティ値は、キーがプロパティ名、値がプロパティ値であるオブジェクトでなければなりません。プロパティ名は、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 %}

アプリ内メッセージをテンプレート化したアプリ内メッセージとして配信するための Liquid タグの完全なリストについては、よくある質問を参照してください。

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

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

セグメンテーション

イベントプロパティセグメンテーションを使用して、取得されたカスタムイベントと、それらのイベントに関連付けられたプロパティに基づいて、ターゲットユーザを対象にします。これにより、購入イベントとカスタムイベントでセグメンテーションを行うときのフィルタリングオプションが増えます。

カスタムイベントのイベントプロパティは、それを使用するすべてのセグメントでリアルタイムに更新されます。プロパティの管理は、「データ設定」＞「カスタムイベント」と進み、関連するカスタムイベントの「プロパティの管理」を選択することで行える。特定のセグメントフィルターで使用されるカスタムイベントプロパティの最大遡及履歴は 30 日間です。

セグメンテーションのためにイベントプロパティを追加する。

イベントプロパティの再帰性と頻度に基づいてセグメンテーションを作成するには、「カスタムイベントプロパティのセグメンテーションを管理する」ユーザー権限が必要です。

デフォルトでは、1 つのワークスペースにつき 20 個のセグメンテーション可能なイベントプロパティを設定できます。この制限を増やすには、Brazeアカウントマネージャーに連絡する。

セグメンテーションのためにイベントプロパティを追加するには、以下のようにする：

1. カスタムイベントに移動し、[プロパティを管理] を選択します。
2. [セグメンテーションを有効にする] トグルを選択して、セグメンテーションのイベントプロパティを追加します。セグメンテーションの際に、追加のフィルターオプションにアクセスできる。

イベントプロパティセグメンテーションフィルターには次のようなものがあります。

• 過去 Y 日間に、値 B のプロパティ A を持つカスタムイベントを X 回実行した。
• 過去 Y 日間に、値 B のプロパティ A を持ついずれかの購入を行った。
• 1～30日以内のセグメンテーション機能を追加。

データは、有効にした後の特定のイベントプロパティについてのみ記録されます。イベントプロパティは、その日付からのみ使用できます。

データポイント

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

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

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

キャンバスのユーザー・ジャーニーでは、キャンバス・エントリー・プロパティとイベント・プロパティを使用できる。

• canvas entry properties
• event properties

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 %}

詳細と例については、キャンバスのエントリプロパティとイベントプロパティを参照してください。

階層化オブジェクト

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

詳細については、ネストされたオブジェクトの専用ページを参照してください。

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

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

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

1. 30 日以内:イベントプロパティ セグメンテーションは、Braze Segments 内の特定のイベントプロパティの頻度と新旧に基づいて使用できます。このオプションは、データの使用に影響を与えます。
   
   
2. 30 日以内およびそれ以降:短期と長期の両方のイベントプロパティセグメンテーションに対応する目的で、セグメントエクステンションを使用できます。この機能は、過去2 年間に追跡されたカスタムイベントとイベントプロパティに基づいてユーザーをセグメント化します。このオプションは、データの使用には影響しません。

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