カスタムイベント

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

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

ユースケース

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

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

カスタムイベントの管理

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

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

ブロックリスト

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

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

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

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

説明を加える

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

タグを追加する

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

利用レポートを見る

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

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

データのエクスポート

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

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

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

カスタムイベントの保存

User Profileに保存されているすべてのデータは、カスタムイベントメタデータ(最初または最後のオカレンス、合計数、および30 日間のY のX)を含め、各プロファイルがactiveである限り、無期限に保持されます。

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

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

分析

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

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

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

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

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

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

カスタムイベントプロパティは、イベントの特定の発生を表すカスタムイベントのメタデータまたは属性です。これらのプロパティは、トリガ条件をさらに修飾したり、メッセージングのパーソナライゼーションを増やしたり、変換を追跡したり、生データのエクスポートを通じてより高度な分析を生成したりするために使用できます。

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

必要なフォーマット

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

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

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

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

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

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

トリガーメッセージ

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

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