eコマースイベントの使い方

eコマースの推奨イベントは、共有された注文レベルのスキーマを使用しており、Brazeがeコマースデータの上に信頼性の高い機能を構築できるようにします。これには、ユーザープロファイル、セグメンテーション、メッセージング、レポート、AIを活用したレコメンデーションが含まれます。この記事の各セクションでは、Brazeで各機能を使用する方法について説明します。

プロパティの要件とデータタイプについてはイベントスキーマを、イベントがバリデーションに失敗した場合の動作についてはイベントのバリデーションとトラブルシューティングを参照してください。

eコマースイベントは予測可能なスキーマに従っているため、Brazeは収益トラッキングや構築済みのキャンバステンプレートからAIを活用したレコメンデーションまで、信頼性の高い機能を構築できます。以下のセクションでは、各機能の概要と詳細ドキュメントへのリンクを紹介します。

コマースタブ

各ユーザープロファイルのコマースタブは、注文アクティビティ（計算された収益と注文の指標）とアクティブカート（ecommerce.cart_updatedイベントからの最新のカート）の2つのモジュールで構成されています。

注文アクティビティ

注文アクティビティモジュールは、イベントが処理されるとリアルタイムで更新される3つの計算指標を表示します。これらの計算の注文レベルモデルにより、製品価格と注文合計値が明確に分離されます。

指標	計算式
合計収益	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を通じて送信するカスタムのトップレベルプロパティは、エクステンションのプロパティフィルターには有効ではありません。これらのプロパティがイベントデータに表示されていたとしても同様です。許可リストにないトップレベルプロパティを使用すると、エクステンションの保存やアーカイブ解除ができなくなります。

トリガー

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[].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コマースライフサイクルフローをカバーしています。出発点として使用し、オーディエンスに合わせてタイミング、チャネル、クリエイティブをカスタマイズしてください。

• 閲覧放棄
• カート放棄
• チェックアウト放棄
• 注文確認とアンケート

テンプレートのカスタマイズ

これらのテンプレートは出発点として設計されています。一般的なカスタマイズには以下が含まれます。

• メールのカスタマイズ：各テンプレートには、ドラッグ＆ドロップエディターで構築された事前設定済みのメールが含まれており、ブランドやコンテンツに合わせて完全に編集できます。
• チャネルの追加：メールにプッシュ、SMS、またはアプリ内メッセージを組み合わせてクロスチャネルの強化を行います。
• 遅延と条件分岐の追加：動作（たとえば、高額カートと低額カートの比較）やメッセージ間の待機期間でユーザーを分岐させます。
• クリエイティブの変更：含まれているメールテンプレートをブランドのビジュアルスタイルに置き換えます。
• 製品ブロックの使用：ドラッグ＆ドロップの製品ブロック（早期アクセスプログラム中）を使用して、カスタムLiquidを記述することなく、放棄カートの内容や閲覧した製品をダイナミックにレンダリングします。

より高度なライフサイクル戦略（Liquidパーソナライゼーションの例を含む）については、eコマースのユースケースを参照してください。

eコマースレポート

eコマース推奨イベントは、顧客が現在すでに使用しているのと同じ収益サーフェスを活用します。インテグレーションがeコマースイベントを送信している場合、以下のレポートにeコマース収益が自動的に含まれます。

レポート	表示内容
収益レポート	選択した日付範囲とアプリにおける、すべてのソースにわたる合計収益、平均日次収益、日次購入、およびユーザーあたりの収益の推移。
ラストタッチアトリビューション収益ダッシュボード	注文を行う前にユーザーが最後にインタラクションしたキャンペーンまたはキャンバスに帰属する収益。タッチイベントには、メールクリック、プッシュ開封、Content Cardsクリック、アプリ内メッセージクリック、SMSまたはWhatsAppショートリンククリックが含まれます。
キャンペーンおよびキャンバスの分析	1次コンバージョンウィンドウ内で特定のキャンペーンまたはキャンバスに帰属する合計収益。
コンバージョンレポート	キャンペーンおよびキャンバスのコンバージョンイベントに関連付けられた収益。 注:ecommerce.order_placedの収益をカウントするには、キャンペーンまたはキャンバスでPlaces Orderコンバージョンイベントタイプを使用する必要があります。
セグメントインサイト	セグメントインサイトダッシュボードにおけるセグメント間の収益比較。
レポートビルダー	レポートビルダーで構築したカスタムレポートの収益指標。
ダッシュボードビルダー	ダッシュボードビルダーで構築したカスタムダッシュボードの収益指標。

ユーザー以外の計算フィールド（例: キャンペーンまたはキャンバスの収益）の場合、収益はすべてのレポートで同じ方法で計算されます。注文内の製品ごとにpriceにquantityを乗算し、各order_placedイベントの製品全体で合計します。

BrazeAI^TM

予測イベント、解約予測、およびアイテムレコメンデーションは、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」を購入したすべてのユーザーを見つけることができます。