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

この記事では、カスタムイベントプロパティ、その想定されるフォーマット、メッセージングやセグメンテーションでの使用方法、およびカスタムイベントプロパティのストレージについて説明します。

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

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

想定されるフォーマット

プロパティ値はオブジェクトである必要があります。キーはプロパティ名（空でない文字列、255文字以下、先頭に $ なし）で、値はプロパティ値です。サポートされるデータタイプ、フォーマット要件、およびペイロード制限については、データタイプを参照してください。

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

予約キー

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

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

カスタムイベントプロパティは、キャンペーンのトリガー条件の絞り込み、コンバージョンのトラッキング、およびメッセージングのパーソナライズに使用できます。

メッセージのトリガー

カスタムイベントプロパティを使用して、特定のキャンペーンやキャンバスのオーディエンスをさらに絞り込みます。たとえば、e コマースアプリケーションがあり、ユーザーがカートを放棄したときにメッセージを送信したい場合、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」ユーザー権限が必要です。

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

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

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

イベントプロパティセグメンテーションフィルターには以下が含まれます。

• 過去 Y 日間に、プロパティ A の値が B であるカスタムイベントを X 回実行した。
• 過去 Y 日間に、プロパティ A の値が B である購入を 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 内で短期および長期の両方で保存できます。

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

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

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