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コマース推奨イベントのセグメントエクステンションは有料機能であり、早期アクセス段階にあります。早期アクセスへの参加に興味がある場合は、カスタマーサクセスマネージャーにお問い合わせください。ネストされたプロパティのセグメンテーションをチームに推奨する前に、ご利用のプランにアクセスが含まれていることを確認してください。
トリガー
eコマースイベントでは、他のカスタムイベントと同様に、Braze全体でカスタムイベント実行トリガーを使用できます。放棄カートフローの場合は、カート更新トリガーを使用してカートの更新を適切にキャプチャします。
さらに、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 |
| 終了イベント | 注文する |
| コンバージョンイベント | 注文する |
購入の成功を確認し、レビュー収集と購入後エンゲージメントを促進するためにフィードバックアンケートでフォローアップします。
購入後のコミュニケーションを効率化し、1つのワークフローで顧客のフィードバックを収集したい場合に、このテンプレートを使用します。
| 設定 | 値 |
|---|---|
| エントリイベント | 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,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」を購入したすべてのユーザーを検索できます。