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 コマースフィルター: セグメンターの eCommerce カテゴリーを使用します。このカテゴリーには、e コマースの推奨イベントを利用したフィルター (Last Order Placed、Total Revenue、Average Order Value など) が含まれています。利用可能なフィルターの一覧については、セグメントフィルターを参照してください。
• カスタムイベントフィルター: e コマースイベントはカスタムイベントと同様に動作するため、既存のカスタムイベントフィルターをすべてそのまま使用できます。たとえば、「カスタムイベント ecommerce.order_placed を X 回以上実行した」や「カスタムイベント ecommerce.order_placed を初めて実行した」でフィルタリングできます。
• セグメントエクステンション: ネストされた products 配列や metadata オブジェクトのプロパティなど、ネストされたイベントプロパティでセグメント化するには、ネストされたイベントプロパティのフィルタリングを備えたセグメントエクステンションを使用します。これにより、「過去 90 日間に商品 SKU-123 を購入したユーザー」のようなオーディエンスを作成したり、同じ注文の異なるプロパティにまたがる条件を組み合わせたりできます。

ドキュメントに記載されたイベントスキーマに含まれないカスタムプロパティでフィルタリングする必要がある場合は、イベントを記録する際にそれらを metadata の下にネストしてください (たとえば color ではなく metadata.color)。API または SDKを通じて送信したカスタムのトップレベルプロパティは、イベントデータに表示されていても、エクステンションのプロパティフィルターには使用できません。許可リストにないトップレベルプロパティを使用すると、エクステンションの保存やアーカイブ解除ができなくなります。

トリガー

他のカスタムイベントと同様に、Braze 全体で e コマースイベントに対してカスタムイベント実行トリガーを使用できます。カート放棄フローでは、Update Cart トリガーを使用してカートの更新を適切に捕捉してください。

さらに Braze には専用の Place Order トリガーがあり、ユーザーが注文したときにジャーニーを開始したりアクションを実行したりできます。詳細については、アクションベースの配信を参照してください。

プロパティフィルター

Place Order トリガーと Update Cart トリガーでは、イベントが持つプロパティでフィルタリングすることもできるため、対象とする注文やカートに対してのみトリガーを発動できます。

• 基本プロパティは、total_value や currency など、イベントのトップレベルプロパティに一致します。
• ネストされたプロパティは、products 配列の内部を参照します。各商品はそれぞれ独自のプロパティを持つため、products[].metadata.category は、注文またはカート内のいずれかの商品が条件を満たした場合に一致します。

カスタムの商品フィールドは metadata の下にネストしてください (たとえば products[].metadata.brand)。イベントスキーマに含まれない商品プロパティは検証に失敗するため、そのプロパティに対するフィルターは一致しません。

たとえば、total_value が 1000 より大きいという条件と、products[].metadata.category が shoes に等しいという条件を組み合わせると、靴を含む高額な注文に対してのみトリガーが発動します。プロパティフィルターが導入される前は、注文が行われたことに対してはトリガーできても、注文の内容に対してはトリガーできませんでした。

プロパティフィルターは、次の場所で使用できます。

• Place Order: キャンペーンとキャンバスのトリガー、例外イベント、キャンバスの終了条件、アクションパスステップ、コンバージョンイベント、Content Card の削除イベント。基本プロパティとネストされたプロパティの両方がサポートされています。アプリ内メッセージのトリガーでは、Place Order は基本プロパティのみをサポートします。
• Update Cart: キャンペーンとキャンバスのトリガー、例外イベント、キャンバスの終了条件、アクションパスステップ。基本プロパティとネストされたプロパティの両方がサポートされています。コンバージョンイベント、Content Card の削除イベント、アプリ内メッセージのトリガーでは、Update Cart は ecommerce.cart_updated カスタムイベントに基づいており、基本プロパティのみをサポートします。

アプリ内メッセージのトリガーはデバイス上で評価されるため、そこでは Place Order で特定の商品をターゲットにしたり、ネストされたプロパティでフィルタリングしたりすることはできません。作成画面では Place order for specific product オプションが無効になっています。特定の商品に対してアクションを実行するには、代わりに別のチャネルのキャンペーンまたはキャンバスを使用してください。

注文を特定の商品に絞り込む

注文に特定の商品が含まれる場合にのみトリガーするには、Place Order トリガーにネストされたプロパティフィルターを追加します。この方法はアプリ内メッセージのトリガーでは使用できません。

目的	ネストされたプロパティフィルター
商品名	products[].product_name が 値 に等しい
商品 ID	products[].product_id が 値 に等しい
商品バリアント ID	products[].variant_id が 値 に等しい

商品スコープ付きの保存済み行動

プロパティフィルターが利用可能になる前に Place Order 行動を設定していた場合、その行動では引き続き Place order for specific product と Product Identifier (商品名、product_id、または variant_id) が使用されている可能性があります。これらの保存済み行動は引き続き機能し、以前とまったく同じように一致するため、既存のキャンペーンやキャンバスには影響ありません。

保存済みの行動をプロパティフィルターに切り替えるには、Place any order を選択します。これにより、商品スコープのコントロールがプロパティフィルターに置き換わります。同じスコープを再作成するには、次の表を使用してください。

以前の Product Identifier	同等のネストされたプロパティフィルター
商品名	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 コマースのライフサイクルフローを網羅しています。出発点として使用し、オーディエンスに合わせてタイミング、チャネル、クリエイティブをカスタマイズしてください。

• abandoned browse
• abandoned cart
• abandoned checkout
• order confirmation and survey

テンプレートをカスタマイズする

これらのテンプレートは、出発点として使用するよう設計されています。一般的なカスタマイズには次のようなものがあります。

• メールをカスタマイズする: 各テンプレートには、ドラッグ＆ドロップエディターで作成された設定済みのメールが含まれており、ブランドやコンテンツに合わせて自由に編集できます。
• チャネルを追加する: メールにプッシュ、SMS、アプリ内メッセージを組み合わせて、クロスチャネルで効果を高めます。
• 遅延と条件分岐を追加する: 行動 (たとえば高額カートと低額カートの比較) やメッセージ間の待機期間によってユーザーを分岐させます。
• クリエイティブを差し替える: 付属のメールテンプレートを、ブランドのビジュアルスタイルに置き換えます。
• 商品ブロックを使用する: ドラッグ＆ドロップの商品ブロック (早期アクセスプログラムで提供) を使用すると、カスタム Liquid を記述せずに、放棄カートの内容や閲覧した商品をダイナミックに表示できます。

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

eコマースレポート

eコマースの推奨イベントは、お客様が現在すでに使用しているものと同じ収益関連の画面で利用されます。統合からeコマースイベントを送信している場合、次のレポートにはeコマースの収益が自動的に含まれます。

レポート	表示内容
収益レポート	選択した期間とアプリについて、すべてのソースにおける総収益、1日あたりの平均収益、1日あたりの購入数、ユーザーあたりの収益の推移を表示します。
収益 - ラストタッチアトリビューションダッシュボード	ユーザーが注文する前に最後に操作したキャンペーンまたはキャンバスにアトリビュートされた収益を表示します。タッチイベントには、メールのクリック、プッシュの開封、Content Cardのクリック、アプリ内メッセージのクリック、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」を購入したすべてのユーザーを見つけることができます。