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

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

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

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

コマースタブ

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

注文アクティビティ

注文アクティビティモジュールには、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 を初めて実行した」でフィルタリングできます。
• セグメントエクステンション: ネストされた商品配列やメタデータオブジェクトのプロパティなど、ネストされたイベントプロパティでセグメント化するには、ネストされたイベントプロパティのフィルタリングを備えたセグメントエクステンションを使用します。これにより、「過去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」を購入したすべてのユーザーを見つけることができます。