カスタムイベント

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

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

ユースケース

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

• アクションベースの配信 を使用したカスタムイベントに基づくキャンペーンまたはキャンバスのトリガ
• ユーザがカスタムイベントを実行した回数、イベントが最後に発生した時刻、および同様の方法でユーザをセグメント化する
• ダッシュボードカスタムイベント分析 を使用して、各イベントが発生した頻度の集計を表示する
• ファンネル およびretention レポートを使用した追加の分析の検索
• 永続的なエントリプロパティを活用し、キャンバスステップで顧客イベントのメタデータをパーソナライゼーションに使用します。
• Currents を使用してより高度な分析を行う
• キャンバスの次のステップに進まない場合を定義するためのキャンバス例外イベントの設定

カスタムイベントの管理

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

次のアクションのカスタムイベントの横にあるメニューを選択します。

ブロックリスト

アクションメニューを使用して個別のカスタムイベントをブロックリストすることも、一括で最大10 個のイベントを選択してブロックリストすることもできます。

カスタムイベントをブロックする場合:

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

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

説明を加える

Manage Events, Attributes, Purchases ユーザー権限がある場合は、作成後にカスタムイベントに説明を追加できます。カスタムイベントの [説明を編集] を選択し、チームへのメモなど好きなものを入力します。

タグを追加する

“Manage Events, Attributes, Purchases” user permission がある場合は、作成後にカスタムイベントにタグを追加できます。タグは、イベントのリストをフィルタリングするために使用できます。

利用レポートを見る

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

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

データのエクスポート

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

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

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

カスタムイベントの保存

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

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

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

分析

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

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

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

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

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

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

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

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

必要なフォーマット

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

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

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

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

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

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

トリガーメッセージ

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

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

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

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

たとえば、ゲームアプリがあり、レベルを完了したユーザーにメッセージを送信する場合、ユーザーがそのレベルを完了するのにかかった時間のために、プロパティを使用してメッセージをさらにパーソナライズできます。この例では、条件付きロジック]を使って、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": "" を含めた場合、ユーザーは「空白でない」と見なされます。
• 整数:数値のカスタムイベントプロパティにフィルターを適用するときに、値が非常に大きい場合は、「完全一致」フィルターを使用しないでください。数値が大きすぎると特定の長さに丸められ、フィルターが意図どおりに機能しないことがあります。

セグメンテーション

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

カスタムイベントのイベントプロパティは、それを使用するすべてのセグメントでリアルタイムに更新されます。プロパティを管理するには、Data Settings > Custom Eventsに移動し、関連付けられたカスタムイベントに対してManage Propertiesを選択します。特定のセグメントフィルターで使用されるカスタムイベントプロパティの最大遡及履歴は 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 を使用できます。詳細と例については、キャンバスのエントリプロパティとイベントプロパティを参照してください。

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

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

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