eコマースイベントの使い方
eコマースの推奨イベントは、共有された注文レベルのスキーマを使用しており、Brazeがeコマースデータの上に信頼性の高い機能を構築できるようにします。これには、ユーザープロファイル、セグメンテーション、メッセージング、レポート、AIを活用したレコメンデーションが含まれます。この記事の各セクションでは、Brazeで各機能を使用する方法について説明します。
プロパティの要件とデータタイプについてはイベントスキーマを、イベントがバリデーションに失敗した場合の動作についてはイベントのバリデーションとトラブルシューティングを参照してください。
eコマースイベントは予測可能なスキーマに従っているため、Brazeは収益トラッキングや構築済みのキャンバステンプレートからAIを活用したレコメンデーションまで、信頼性の高い機能を構築できます。以下のセクションでは、各機能の概要と詳細ドキュメントへのリンクを紹介します。

コマースタブ
各ユーザープロファイルのコマースタブは、注文アクティビティ(計算された収益と注文の指標)とアクティブカート(ecommerce.cart_updatedイベントからの最新のカート)の2つのモジュールで構成されています。
注文アクティビティ
注文アクティビティモジュールは、イベントが処理されるとリアルタイムで更新される3つの計算指標を表示します。これらの計算の注文レベルモデルにより、製品価格と注文合計値が明確に分離されます。

eコマース推奨イベントは、コマースタブの購入履歴セクションには表示されません。購入履歴はレガシー購入イベントによって入力されます。推奨イベントからの収益と注文アクティビティについては、以下の表の指標を使用してください。
| 指標 | 計算式 |
|---|---|
| 合計収益 | sum (order_placed.total_value) − sum (order_refunded.total_value) |
| 合計注文数 | count (distinct order_placed) − count (distinct order_cancelled) |
| 合計返金額 | sum (order_refunded.total_value) |
アクティブカート
アクティブカートモジュールは、ユーザープロファイル上の最新のカートを表示します。このビューはテスト中に特に役立ちます。カートの内容を確認したり、カートベースのジャーニーを検証したり、ecommerce.cart_updatedイベントが期待どおりにプロファイルを更新しているかを確認したりできます。
アクティブカートには以下が含まれます:
- カートID — 最後に
ecommerce.cart_updatedイベントを受信したカートの識別子。 - 最終更新日時 — 最新のカート更新のタイムスタンプ。
- カート合計値 — 現在のカート内のラインアイテムの合計値。
- 製品を表示 — カート内の製品リストを開くリンク(最大50製品)。
eコマースオーケストレーション
セグメンテーション
Brazeは、eコマースデータに基づいてユーザーをセグメント化する3つの方法を提供しています。
- eコマースフィルター: セグメンターのeコマースカテゴリを使用します。これには、eコマース推奨イベント(最終注文日、合計収益、平均注文額など)に基づくフィルターが含まれています。利用可能なフィルターの完全なリストについては、セグメントフィルターを参照してください。
- カスタムイベントフィルター: eコマースイベントはカスタムイベントと同様に動作するため、既存のすべてのカスタムイベントフィルターがすぐに使えます。たとえば、「カスタムイベント
ecommerce.order_placedをX回以上実行した」や「カスタムイベントecommerce.order_placedを最初に実行した」でフィルタリングできます。 - セグメントエクステンション: ネストされた商品配列やメタデータオブジェクトのプロパティなど、ネストされたイベントプロパティに基づいてセグメント化するには、ネストされたイベントプロパティフィルタリングを使用したセグメントエクステンションを使用します。これにより、「過去90日間に商品SKU-123を購入したユーザー」のようなオーディエンスを構築したり、同じ注文の異なるプロパティ間で条件を組み合わせたりできます。
ドキュメント化されたイベントスキーマに含まれないカスタムプロパティでフィルタリングする必要がある場合は、イベントを記録する際にmetadataの下にネストしてください(たとえば、colorではなくmetadata.color)。APIやSDKを通じて送信するカスタムトップレベルプロパティは、エクステンションのプロパティフィルターには有効ではありません。イベントデータにそれらのプロパティが表示されていても同様です。許可リストにないトップレベルプロパティを使用すると、エクステンションの保存またはアーカイブ解除ができなくなります。

eコマース推奨イベント用のセグメントエクステンションは有料機能であり、早期アクセス中です。早期アクセスへの参加に興味がある場合は、カスタマーサクセスマネージャーにお問い合わせください。ネストされたプロパティセグメンテーションをチームに推奨する前に、プランにアクセスが含まれていることを確認してください。
トリガー
Brazeでは、他のカスタムイベントと同様に、eコマースイベントで実行済みカスタムイベントトリガーを使用できます。放棄カートフローの場合は、カート更新トリガーを使用してカートの更新を適切にキャプチャします。
さらに、Brazeは専用の注文確定トリガーを提供しています。これにより、ユーザーが注文を行った際にジャーニーを開始したりアクションを実行したりできます。詳細については、アクションベース配信を参照してください。
プロパティフィルター
注文確定およびカート更新トリガーは、イベントに含まれるプロパティでフィルタリングすることもできるため、対象の注文やカートに対してのみトリガーが発動します。
- 基本プロパティは、
total_valueやcurrencyなど、イベントのトップレベルプロパティに一致します。 - ネストされたプロパティは、
products配列内を参照します。各商品には独自のプロパティがあるため、products[].metadata.categoryは注文またはカート内のいずれかの商品が条件を満たす場合に一致します。
カスタム商品フィールドはmetadataの下にネストしてください(たとえば、products[].metadata.brand)。イベントスキーマに含まれない商品プロパティはバリデーションに失敗するため、そのフィルターは一致しません。
たとえば、total_valueが1000を超えるという条件とproducts[].metadata.categoryがshoesに等しいという条件を組み合わせると、靴を含む高額注文に対してのみトリガーが発動します。プロパティフィルターが導入される前は、注文が行われたことをトリガーにはできましたが、注文の内容に基づいてトリガーすることはできませんでした。
プロパティフィルターは以下のサーフェスで利用できます。
- 注文確定: キャンペーンおよびキャンバストリガー、例外イベント、キャンバス終了条件、アクションパスステップ、コンバージョンイベント、Content Cardの削除イベント。基本プロパティとネストされたプロパティの両方がサポートされています。アプリ内メッセージトリガーでは、注文確定は基本プロパティのみをサポートしています。
- カート更新: キャンペーンおよびキャンバストリガー、例外イベント、キャンバス終了条件、アクションパスステップ。基本プロパティとネストされたプロパティの両方がサポートされています。コンバージョンイベント、Content Cardの削除イベント、アプリ内メッセージトリガーでは、カート更新は
ecommerce.cart_updatedカスタムイベントによって動作し、基本プロパティのみをサポートしています。

ネストされたフィルターでは、等しくないは配列内のどのアイテムも一致しない場合に一致します。products[].metadata.categoryがshoesに等しくないでフィルタリングされたカートは、すべての靴がカートから削除された場合にのみ一致し、カートに他のカテゴリも含まれている場合には一致しません。
アプリ内メッセージトリガーはデバイス上で評価されるため、注文確定は特定の商品をターゲットにしたり、ネストされたプロパティでフィルタリングしたりできません。コンポーザーでは特定の商品の注文確定オプションは無効になっています。特定の商品に基づいてアクションを実行するには、別のチャネルのキャンペーンまたはキャンバスを使用してください。
特定の商品への注文のスコープ
注文に特定の商品が含まれている場合にのみトリガーするには、注文確定トリガーにネストされたプロパティフィルターを追加します。これはアプリ内メッセージトリガーでは使用できません。
| 目標 | ネストされたプロパティフィルター |
|---|---|
| 商品名 | products[].product_nameが値に等しい |
| 商品ID | products[].product_idが値に等しい |
| 商品バリアントID | products[].variant_idが値に等しい |
商品スコープ付きの保存済み動作
プロパティフィルターが利用可能になる前に注文確定の動作を設定していた場合、商品識別子(商品名、product_id、またはvariant_id)を使用した特定の商品の注文確定がまだ使用されている場合があります。これらの保存済み動作は引き続き機能し、以前とまったく同じように一致するため、既存のキャンペーンやキャンバスには影響しません。
保存済みの動作をプロパティフィルターに切り替えるには、任意の注文確定を選択します。これにより、商品スコープのコントロールがプロパティフィルターに置き換えられます。同じスコープを再作成するには、以下の表を使用してください。
| 以前の商品識別子 | 同等のネストされたプロパティフィルター |
|---|---|
| 商品名 | products[].product_nameが値に等しい |
| 商品ID | products[].product_idが値に等しい |
| 商品バリアントID | products[].variant_idが値に等しい |

動作を任意の注文確定に移行すると元に戻すことはできません。引き続き必要な場合は、ネストされたプロパティフィルターとしてスコープを再作成してください。

Liquidパーソナライゼーション
eコマースイベントは、カスタムイベントと同じ方法でLiquidパーソナライゼーションをサポートしています。メッセージ内でイベントプロパティを直接参照できます。商品画像、価格設定、またはその他のカタログデータをメッセージに取り込むには、product_idまたはvariant_idをリンク識別子として使用して、カタログをイベントと結合します。{% shopping_cart %} Liquidタグを使用すると、放棄カートリマインダー、チェックアウトの促進、または注文確認のためにユーザーの現在のカート内容をループ処理できます。すぐに使えるコードサンプルについては、eコマースのユースケースを参照してください。
ノーコードの代替手段として、ドラッグ&ドロップ商品ブロックが早期アクセスプログラムで利用できます。
eコマースキャンバステンプレート
Brazeは、eコマース推奨イベントをエントリ、終了、コンバージョン条件として事前設定した、すぐに使えるキャンバステンプレートを提供しています。カスタム設定なしでライフサイクルフローを起動できます。各テンプレートにはドラッグ&ドロップのメールデザインが付属しており、ドラッグ&ドロップ商品ブロック(現在早期アクセス中)をサポートしています。詳細なユースケースやLiquidの例については、eコマースのユースケースを参照してください。
これらのテンプレートは、最も一般的なeコマースライフサイクルフローをカバーしています。出発点として使用し、オーディエンスに合わせてタイミング、チャネル、クリエイティブをカスタマイズしてください。
商品を閲覧したがカートに追加しなかったユーザーを再エンゲージします。
最近閲覧したがアクションを起こさなかった商品を再検討するようブラウザーを呼び戻したい場合に、このテンプレートを使用します。
| 設定 | 値 |
|---|---|
| エントリイベント | ecommerce.product_viewed |
| 終了イベント | ecommerce.product_viewed、ecommerce.cart_updated、ecommerce.checkout_started、注文確定 |
| コンバージョンイベント | 注文確定 |
カートに商品を追加したがチェックアウトを開始しなかったユーザーを回復します。
カート内の商品についてユーザーにリマインドし、チェックアウト完了に導きたい場合に、このテンプレートを使用します。
| 設定 | 値 |
|---|---|
| エントリイベント | ecommerce.cart_updated |
| 終了イベント | ecommerce.cart_updated、ecommerce.checkout_started、注文確定 |
| コンバージョンイベント | 注文確定 |

ecommerce.cart_updatedイベントは、完全なカート置換(各イベントがカート全体を記述)またはオプションのactionプロパティのaddおよびremove値を使用した増分更新をサポートしています。カートごとに1つのアプローチを選択し、同じcart_idに対して置換と増分カート更新を混在させないでください。保存されたカートは最新のカートイベントのcurrencyを保持します。異なる通貨でのカート更新は、2つの通貨の値を混合するのではなく、保存されたカートを置き換えます。メッセージ内で{% shopping_cart %} Liquidタグを使用すると、送信時に現在のカート内容を動的に表示できます。
チェックアウトを開始したが購入を完了しなかったユーザーを回復します。
ファネルの最も購買意欲が高い段階で購入を回復したい場合に、このテンプレートを使用します。
| 設定 | 値 |
|---|---|
| エントリイベント | ecommerce.checkout_started |
| 終了イベント | 注文確定 |
| コンバージョンイベント | 注文確定 |
購入完了を確認し、レビュー収集と購入後のエンゲージメントを促進するフィードバックアンケートでフォローアップします。
購入後のコミュニケーションを効率化し、単一のワークフローで顧客のフィードバックを収集したい場合に、このテンプレートを使用します。
| 設定 | 値 |
|---|---|
| エントリイベント | ecommerce.order_placed |
| コンバージョンイベント | セッション開始またはecommerce.product_viewed |
テンプレートのカスタマイズ
これらのテンプレートは出発点として設計されています。一般的なカスタマイズには以下が含まれます。
- メールのカスタマイズ: 各テンプレートには、ドラッグ&ドロップエディターで構築された事前設定済みのメールが含まれており、ブランドとコンテンツに合わせて完全に編集できます。
- チャネルの追加: メールにプッシュ、SMS、またはアプリ内メッセージを組み合わせて、クロスチャネルの強化を図ります。
- 遅延と条件分岐の追加: ユーザーの行動(たとえば、高額カートと低額カートの比較)やメッセージ間の待機期間で分岐します。
- クリエイティブの差し替え: 含まれているメールテンプレートをブランドのビジュアルスタイルに置き換えます。
- 商品ブロックの使用: ドラッグ&ドロップ商品ブロック(早期アクセスプログラム内)を使用して、カスタムLiquidを記述せずに放棄カートの内容や閲覧済み商品を動的にレンダリングします。
Liquidパーソナライゼーションの例を含む、より高度なライフサイクル戦略については、eコマースのユースケースを参照してください。
eコマースレポート
eコマース推奨イベントは、顧客がすでに利用している同じ収益サーフェスを活用します。eコマースイベントを送信するインテグレーションが設定されていると、以下のレポートにeコマースの収益が自動的に含まれます。
| レポート | 表示される内容 |
|---|---|
| 収益レポート | 選択した日付範囲とアプリにおける、すべてのソースの合計収益、1日の平均収益、1日あたりの購入数、および経時的なユーザーあたりの収益。 |
| 収益 - ラストタッチアトリビューションダッシュボード | 注文前にユーザーが最後に操作したキャンペーンまたはキャンバスに帰属する収益。タッチイベントには、メールのクリック、プッシュの開封、Content Cardsのクリック、アプリ内メッセージのクリック、SMSまたはWhatsAppのショートリンクのクリックが含まれます。 |
| キャンペーンとキャンバスの分析 | 1次コンバージョンウィンドウ内の特定のキャンペーンまたはキャンバスに帰属する合計収益。 |
| コンバージョンレポート | キャンペーンとキャンバスのコンバージョンイベントに関連する収益。 注: ecommerce.order_placedの収益をカウントするには、キャンペーンまたはキャンバスでPlaces Orderコンバージョンイベントタイプを使用する必要があります。 |
| セグメントインサイト | セグメントインサイトダッシュボードにおけるセグメント間の収益比較。 |
| レポートビルダー | レポートビルダーで作成されたカスタムレポートの収益指標。 |
| ダッシュボードビルダー | ダッシュボードビルダーで作成されたカスタムダッシュボードの収益指標。 |
非ユーザー計算フィールド(例えばキャンペーンやキャンバスの収益)の場合、収益はすべてのレポートで同じ方法で計算されます。注文内の各商品のpriceにquantityを乗じ、各order_placedイベント内の全商品を合計します。

収益計算では、1注文あたりの個別商品の数量が1,000ユニットを上限とします。商品のquantityフィールドが欠落している場合、デフォルトで1ユニットとなります。元のecommerce.order_placedイベントには送信した全数量が保持されます。上限が適用されるのは収益計算のみです。
レガシー購入イベントからecommerce.order_placedに移行する場合は、インテグレーションの変更を行う前にBrazeアカウントチームと連携してください。移行期間中は、レガシー購入イベントとecommerce.order_placedイベントの両方を送信して、正しくトリガーされていることを確認し、アクティブなキャンペーン、キャンバス、セグメントを新しいイベントに移行する準備をしてください。その後、アカウントチームがレガシー購入イベントからecommerce.order_placedへの収益レポートの切り替え計画を支援します。
BrazeAITM
予測イベント、解約予測、およびアイテムレコメンデーションは、eコマースイベントをターゲットイベントおよびシグナルとしてサポートしており、専用の「Order Placed」オプションがあります。標準化されたスキーマにより、ユーザー群全体でデータが一貫しているため、これらのモデルの信頼性が向上します。
データのエクスポート
Brazeは、eコマースイベントデータをデータウェアハウス、BIツール、またはダウンストリームシステムで使用するためにエクスポートする複数の方法を提供しています。eコマース推奨イベントは、他のイベントデータと同じチャネルを通じてエクスポートされます。
| エクスポートパス | 含まれる内容 |
|---|---|
| Currents | eコマースイベントはカスタムイベントとしてストリームされます。ecommerce.*名前空間を検索して見つけることができます。各注文の商品は購入として利用可能です。 |
| Snowflakeデータシェアリング | eコマースイベントはカスタムイベントとして共有されます。ecommerce.*名前空間を検索して見つけることができます。各注文の商品は購入テーブルで利用可能です。 |
| セグメントデータをCSVにエクスポート | セグメントメンバーのCSVエクスポート。eコマースイベントを含めるには、カスタムイベントのドロップダウンから名前で選択します。 |
| セグメント別のユーザープロファイルのエクスポート(API) | セグメントメンバーのユーザープロファイルデータで、APIを介して返されます。eコマースイベントはカスタムイベントとして含まれます。 |
特定の商品でユーザーをセグメント化するには?
セグメンターでは、ユーザーがeコマースイベントを実行した回数でフィルタリングできます。特定の商品プロパティ(product_idやproduct_nameなど)でフィルタリングするには、ネストされたイベントプロパティフィルタリングをサポートするセグメントエクステンションを使用します。例えば、過去90日間に商品「SKU-123」を購入したすべてのユーザーを見つけることができます。