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