カスタムイベント

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

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

ユースケース

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

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

カスタムイベントの管理

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

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

ブロックリスト

アクションメニューから個々のカスタムイベントをブロックリストに登録することも、最大100件のイベントを一括で選択してブロックリストに登録することもできます。

カスタムイベントをブロックすると、以下のようになります。

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

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

説明の追加

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

タグの追加

「Manage Events, Attributes, Purchases」ユーザー権限がある場合は、作成後にカスタムイベントにタグを追加できます。タグは、イベントのリストをフィルタリングするために使用できます。

使用状況レポートの表示

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

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

データのエクスポート

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

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

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

カスタムイベントの保存

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

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

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

分析

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

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

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

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

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

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

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

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

必要なフォーマット

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

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

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

プロパティ値のデータタイプは、カスタム属性の値と同様に検出・処理されますが、2つの重要な違いがあります。

• 文字列から時間への変換: 認識された時間形式に一致する文字列値は、自動的に日時型に変換されます。これは、一部の文字列値がイベントプロパティにそのまま保存できないことを意味します。
• 型の強制変換なし: イベントプロパティには自動的な型の強制変換はありません。トリガーフィルターが数値5を期待している場合、文字列値"5"は一致しません。同じことが Liquid テンプレートと Currents イベントデータにも適用されます。

これらの動作は購入イベントプロパティにも適用されます。

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

予約キー

予約キーをイベントのプロパティ名として使用することはできません。propertiesオブジェクトで予約キーを使用すると、「Invalid ‘properties’ field」というエラーが返されます。

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

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

メッセージのトリガー

カスタムイベントプロパティを使用して、特定のキャンペーンまたはキャンバスのオーディエンスをさらに絞り込むことができます。例えば、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 呼び出しを行い、「is blank」フィルターを使用する場合、呼び出しから除外されたカスタムイベントプロパティは「blank」と見なされます。例えば、"event_property": ""を含めた場合、ユーザーは「not blank」と見なされます。
• 整数: 数値のカスタムイベントプロパティでフィルタリングする際に、値が非常に大きい場合は、「exactly」フィルターを使用しないでください。数値が大きすぎると特定の桁数で丸められ、フィルターが意図どおりに機能しないことがあります。

セグメンテーション

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

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

セグメンテーション用のイベントプロパティの追加

イベントプロパティの最新性と頻度に基づいてセグメントを作成するには、「Edit Custom Event Property Segmentation」ユーザー権限が必要です。

デフォルトでは、1つのワークスペースにつき20個のセグメント化可能なイベントプロパティを設定できます。この制限を増やすには、Braze アカウントマネージャーにお問い合わせください。

セグメンテーション用のイベントプロパティを追加するには、以下の手順を実行します。

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

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

• 過去Y日間に、値Bのプロパティ Aを持つカスタムイベントをX回実行した。
• 過去Y日間に、値BのプロパティAを持ついずれかの購入をX回行った。
• 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  {{context.${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 内に保存できます。

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

• 30日以内: Braze のセグメント内で、特定のイベントプロパティ値の頻度と最新性に基づいたイベントプロパティセグメンテーションを利用できます。このオプションはデータ使用量に影響します。
  
  
• 30日以内およびそれ以降: 短期と長期の両方のイベントプロパティセグメンテーションに対応するために、セグメントエクステンションを使用できます。この機能は、過去2年間に追跡されたカスタムイベントとイベントプロパティに基づいてユーザーをセグメント化します。このオプションはデータ使用量に影響しません。
  
  
• カスタム属性配列を使用したキャンバス: カスタムイベントでトリガーされるキャンバスを構築して起動します。ユーザー更新ステップを設定し、アイテムを追加を使用してイベントプロパティをユーザープロファイルのカスタム属性配列に追加します。その後、イベントプロパティフィルターではなく、そのカスタム属性配列のフィルターを使用してユーザーをセグメント化します。このオプションは、カスタム属性配列への各更新がデータポイントを消費するため、データ使用量に影響します。実装の詳細については、キャンバスのユーザー更新ステップおよびカスタム属性配列を参照してください。

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