カスタムイベント

この記事では、カスタムイベントとプロパティ、セグメンテーション、使用法、キャンバスエントリのプロパティ、関連する分析が表示される場所などについて説明します。Braze のイベントの詳細については、「イベント」を参照してください。

概要

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

ユースケース

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

• アクションベースの配信を使用して、カスタムイベントに基づいてキャンペーンまたはキャンバスをトリガーする。
• カスタムイベントを何回実行したか、最後にイベントが発生したのはいつか、などでユーザーをセグメントする。
• ダッシュボードのカスタムイベント分析を使って、各イベントの発生頻度の集計を表示する。
• ファネルと リテンションレポートを使用して、追加の分析を見つける。
• 永続エントリのプロパティを活用して、顧客イベントのメタデータをキャンバスのステップでパーソナライゼーションに使用する。
• Currentsでより高度な分析を行う。
• キャンバスの例外イベントを設定して、ユーザーがキャンバスの次のステップに進むべきでないタイミングを定義する。

カスタムイベントの管理

ダッシュボードでカスタムイベントの作成や管理を行うには、[データ設定] > [カスタムイベント] に移動します。

このページでは、既存のカスタムイベントの表示、管理、作成、または禁止リストへの追加ができます。カスタムイベントの横にあるメニューを選択し、以下のアクションを実行する：

ブロックリスト

カスタムイベントは、アクションメニューから個別に禁止リストに追加することも、最大 10 件のイベントを選択して一括登録することもできます。あるカスタムイベントを禁止した場合、そのイベントに関するデータは収集されず、再アクティブ化しない限り既存のデータが利用できなくなります。また、禁止リストに追加されたイベントはフィルターやグラフに表示されません。さらに、イベントが現在 Braze ダッシュボードの他の領域にあるフィルターまたはトリガーから参照されている場合、それを参照しているフィルターまたはトリガーのすべてのインスタンスが削除されてアーカイブされることを説明する警告モーダルが表示されます。

説明を加える

Manage Events, Attributes, Purchases ユーザー権限を持っていれば、作成後にカスタムイベントに説明を追加することができる。カスタムイベントの説明を編集を選択し、チームへのメモなど好きなものを入力する。

タグを追加する

Manage Events, Attributes, Purchases ・ユーザー権限を持っていれば、作成後にカスタム・イベントにタグを追加することができる。タグは、イベントのリストをフィルタリングするために使用することができる。(この機能は現在早期アクセス中である）。この早期アクセスへの参加に興味がある場合は、カスタマー・サクセス・マネージャーに連絡すること)。

利用レポートを見る

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

各カスタムイベントの横にあるチェックボックスを選択し、View usage reportを選択することで、一度に10件までの使用レポートを見ることができる。

データをエクスポートする

カスタム・イベントのリストをCSVファイルとしてエクスポートするには、ページ上部の「Export all」ボタンをクリックする。CSVファイルが生成され、ダウンロードリンクがEメールで送信される。(この機能は現在、早期アクセス版として提供されている）。この早期アクセスへの参加に興味がある場合は、カスタマー・サクセス・マネージャーに連絡すること)。

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

カスタムイベントには追加の設定が必要です。以下に、さまざまなプラットフォームでカスタムイベントのログ記録に使用される方法を示します。これらのページには、カスタムイベントにプロパティと数量を追加する方法に関するドキュメントもあります。

カスタムイベントの保存

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

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

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

分析

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

ダッシュボードの カスタムイベントレポート ページでは、各カスタムイベントの発生頻度を集計したり、セグメント別に表示したりして、より詳細な分析ができます。キャンペーンがカスタムイベントのアクティビティにどのように影響したかを確認する場合に、Braze が時系列に重ねて表示するため、キャンペーンの最終送信時刻を示す灰色の線を調べると特に役立ちます。

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

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

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

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

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

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

必要なフォーマット

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

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

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

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

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

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

トリガーメッセージ

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

ネストされたカスタムイベント・プロパティは、[アクションベース配信]19 でもサポートされている。

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

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

例えば、ゲームアプリケーションで、あるレベルをクリアしたユーザーにメッセージを送信する場合、ユーザーがそのレベルを完了するまでに要した時間のプロパティを使用して、メッセージをさらにパーソナライズできます。この例では、[条件付きロジック]18]を使って、3つの異なるセグメントに対してメッセージをパーソナライズしている。カスタムイベントプロパティ time_spent は、{{event_properties.${time_spent}}} を呼び出すことでメッセージに含めることができます。

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

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

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

セグメンテーション

イベントプロパティのセグメンテーションにより、取得したカスタムイベントとそれらのイベントに関連するプロパティに基づいて、ターゲットユーザーを絞り込むことができます。この機能により、購入イベントとカスタムイベントをセグメント化するときのフィルターオプションがさらに追加されます。

カスタムイベントのイベントプロパティは、それを使用するすべてのセグメントでリアルタイムに更新されます。プロパティを管理するには、[データ設定] > [カスタムイベント] ページでカスタムイベントの [プロパティの管理] をクリックします。特定のセグメントフィルターで使用されるカスタムイベントプロパティの最大遡及履歴は 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 any additional items to your cart and enjoy storewide discounts. 
{% endif %}

階層化オブジェクト

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

詳細については、階層化オブジェクトに関する記事を参照してください。

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

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

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

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

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