---
title: "メールレンダリングを製品コンテンツの出力に設定する方法"
slug: "configuring-an-email-rendering-to-output-product-content"
abstract: "例えば、商品推薦などの商品コンテンツを出力するためにメール製品推奨レンダリングを使う方法の概要。"
---
# メールレンダリングを製品コンテンツの出力に設定する方法

このトピックは商品推薦に焦点を当てていますが、他のシナリオではメール商品推奨レンダリングも利用できます。SXAのストアフロントサイトテンプレートでは、デフォルトで「新規注文配置 [マーケティングオートメー](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/working-with-commerce-marketing-automation-campaigns.html "Working with Commerce marketing automation campaigns")ションキャンペーン」の一部として推奨商品のメールメッセージが送信されます。このメールメッセージは、店舗名と注文ID(カートID)のカスタム値を使用するように設定されたメール製品推奨レンダリングを使用します。提案される商品は、購入履歴、カタログで定義された関係性、またはカタログに対してクエリを実行した際に返された商品リストに基づいて決定されます。

![Example of a product recommendation email message body.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/RecommendedProductsEmail.png)

レンダリングは複数のシナリオに対応するために汎用的に実装されており、製品IDのリストを受け取り、それに基づいて商品コンテンツをレンダリングします。例えば:

-   クエリに基づいてメールメッセージ内で製品リストをレンダリングしたい場合は、パラメータとしてクエリを設定したデフォルトの実装を使えます。
-   単一の製品のコンテンツを商品を表示するよりも説明的な形でレンダリングしたい場合は、MVCビューを変更して、設定されたクエリから最初に返された製品を選択し、望むマークアップを出力する必要があります。

より高度なシナリオでは、レンダリングリポジトリで製品IDリストを取得する仮想メソッドを上書きしたり、カスタムパイプラインプロセッサを注入して製品IDのリストを処理・返すこともできます。レンダリングに追加パラメータを追加することもできます。

[マーケティングオートメーションキャンペーンのデータフロー](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-marketing-automation-campaigns-data-flow.html "Commerce Marketing Automation campaigns data flow")に示されているように、顧客が注文を提出すると、デフォルトでカスタム値(ショップ名とOrder ID)を含む「New Order Placedマーケティングオートメーションキャンペーン」に登録されます。Send Commerce Emailマーケティング自動化アクションが発生した際、カスタム値はメッセージバスを使ってEmail Experience Manager(EXM)に渡されます。その後、EXMがメールの内容をレンダリングし始めると、ショップ名と注文IDがクエリパラメータとしてレンダリングに渡されます。

> !注Abandoned Cartのマーケティングオートメーションキャンペーンでは、ショップ名とカートIDが使用されます。

![Email Experience Manager Edit email body dialog box](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/EXMRecommendedProducts.png)

メール製品推奨レンダリングは、レンダリングのデータソースから追加パラメータを取得します。パラメータ項目は*Recommended Products Email Parameters*テンプレート(*/sitecore/Templates/Feature/Commerce Experience Accelerator/Emails/Products/Email Recommended products*)に基づいており、以下の表に記載されたフィールドが含まれています。他にカスタムパラメータが必要な場合は、デフォルトのレンダリングパラメータテンプレートのカスタマイズコピーを使用できます。

フィールド

概要

製品ページ リンクテキスト

HTMLマークアップの *「商品ページへ」* ボタンで使われているテキスト。

製品クエリ

EXMがクエリパラメータとして注文IDを渡さない場合に使われるクエリです。 [GetRecommendedProducts](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/the-recommended-products-pipeline.html) パイプラインを参照してください。

推奨される製品数の最大数

回収およびレンダリングされた生成物の最大数。

関連製品フィールド名

カタログで定義され、推奨製品が保存・取得されるコンテンツに公開されている関係フィールドの名前。値が指定されていない場合、フォールバックは関係フィールド RelatedSellableItemToSellableItemを使用します。  
  
\> \[!注\]  
\>カタログ内で任意の数のカスタムリレーションシップを定義し、それらをコンテンツ内で公開して商品推薦に利用できます。デフォルトでは、4つの [リレーションシップ](https://doc.sitecore.com/xp/en/users/100/sitecore-experience-commerce/en/relationship-definitions.html) フィールドが定義されています。