> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# In-App でのレコメンデーションの使用

> Jinja を使用して MoEngage の In-App キャンペーンにパーソナライズされた商品レコメンデーションを追加し、各ユーザーにカタログから関連する商品を表示します。

In-App キャンペーンにレコメンデーションを追加すると、全員に同じメッセージを表示するのではなく、各ユーザーの関心に合った商品を表示できます。In-App チャネルでは、レコメンデーションは [Jinja テンプレート言語](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/getting-started/message-personalization/jinja-templating-language.md)を使用してメッセージに挿入されます。

In-App チャネルでは商品グリッドは使用しません。メッセージに他のパーソナライズを追加するのと同じ方法で、パーソナライズメニューからプロダクトセットを追加します。

MoEngage では、In-App キャンペーンの作成は 3 つのステップで行います。

1. Target users
2. Content
3. Schedule and Goals

2 番目のステップ「Content」で、レコメンデーションを使用してキャンペーンをパーソナライズできます。それでは、レコメンデーションを使用してパーソナライズした In-App キャンペーンを作成してみましょう。

> [!WARNING]
>
> 目的のレコメンデーションが作成済みであることを確認してください。キャンペーンのパーソナライズには、アクティブなレコメンデーションのみを使用できます。[レコメンデーションの作成と管理](https://moengage.com/docs/ja/user-guide/content/recommendations)の方法を確認してください。

# レコメンデーションを使用した In-App キャンペーンの作成

レコメンデーションを使用した In-App キャンペーンを作成するには、次の手順を実行します。

1. MoEngage のサイドバーメニューで、Engage メニュー項目 ![Engage アイコン](https://mintcdn.com/moengage/eF2J43N9Ckga5Apm/images/moengage_2f187f.png?fit=max\&auto=format\&n=eF2J43N9Ckga5Apm\&q=85\&s=db255ddcee14f3a83a80ca1b6ce47cd3) にカーソルを合わせます。**Engage** メニューが表示されます。
2. **+ New Campaign** をクリックします。

   ![New Campaign、New Flow、All Campaigns、All Flows オプションが表示されている Engage メニュー](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-in-app-engage-menu.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=7e3f08012f2697163418d3b26d5bbc8e)
3. **New Campaign** ダイアログボックスの **INBOUND** で、**In-app** をクリックします。

   ![Outbound、Inbound、Messaging Apps、Personalization、Audience、Connector にグループ化されたチャネルが表示されている New Campaign ダイアログボックス](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-in-app-new-campaign.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=41d08ae7a97c888f3483b20dc21bf476)
4. ステップ 1「Target users」でキャンペーンの基本情報を入力してオーディエンスを定義し、**Next** をクリックします。
5. ステップ 2 の **Content** タブで、**Prebuilt and saved templates** からテンプレートを選択するか、**Start from scratch** をクリックします。リストを絞り込むには、**Filter By Use Case** の **Product recommendation** など、左側のフィルターを使用します。

   ![タイプ、業種、ユースケース、コンテンツのフィルターとともに、事前構築済みおよび保存済みのテンプレートが表示されているテンプレートピッカー](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-in-app-template-picker.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=01bbf938346f6bd10bc880e6593e8f3f)
6. テンプレートエディターの **Text** セクションで、**Heading** などのパーソナライズしたいフィールドをクリックし、レコメンデーションを表示する位置に **@** と入力します。**In-App Personalization** ウィンドウが開きます。

   ![Text セクションが開いており、Heading フィールドにパーソナライズが追加されている In-App テンプレートエディター](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-in-app-template-editor.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=4901e65ae52727028943e65cff767092)
7. **Data personalization** タブで、レコメンデーションを検索し、**Product sets** の下でクリックします。
8. **Choose Fallback** で、ユーザーのパーソナライズが失敗した場合の動作を選択します。

   | オプション | 動作 |
   | - | - |
   | **No fallback** | レコメンデーションなしで In-App メッセージを送信します。 |
   | **Do not send In-App** | そのユーザーへのメッセージの送信を停止します。 |
   | **Replace text** | 入力した代替テキストを使用してメッセージを送信します。 |

   ![プロダクトセットの検索結果とフォールバックオプションが表示されている In-App Personalization ウィンドウ](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-in-app-personalization.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=07921a2784add013fbfecb7f2a77955c)
9. **Done** をクリックします。
10. 次のセクションで説明するように、挿入された Jinja コードを変更して単一のアイテムを取得します。
11. 下部の **Next** をクリックし、キャンペーン設定のステップ 3 である「Schedule and Goals」に進みます。
12. **Schedule and Goals** で適切な設定を行い、キャンペーンを公開します。

# 単一のレコメンドアイテムを取得する

プロダクトセットをそのまま追加すると、セット内のすべてのアイテムが挿入されます。代わりに 1 つの商品を表示するには、プロダクトセットをループ処理します。次の例では、`Recommendations` という名前のレコメンデーションを含む `ProductSet` という名前のプロダクトセットを使用しています。

最初のレコメンドアイテムのタイトルを取得するには:

```text JINJA theme={null}
{% if ProductSet.Recommendations %}
{% for product in ProductSet.Recommendations[0:1] %}
{{product.title}}
{% endfor %}
{% else %}
MOE_NOT_SEND
{% endif %}
```

同じメッセージに商品の画像リンクを追加するには:

```text JINJA theme={null}
{% if ProductSet.Recommendations %}
{% for product in ProductSet.Recommendations[0:1] %}
{{product.image_link}}
{% endfor %}
{% else %}
MOE_NOT_SEND
{% endif %}
```

`MOE_NOT_SEND` は、ユーザーのプロダクトセットが空の場合にメッセージの送信を停止するため、商品が欠けたメッセージを受け取るユーザーはいません。別のフォールバックを使用するには、`MOE_NOT_SEND` を表示したいテキストに置き換えるか、何も表示しない場合は空のままにします。

プロダクトセットにはアイテムのリストが含まれており、各アイテムには `title`、`description`、`id`、`link`、`image link` などの属性があります。利用可能な属性は、レコメンデーションが使用するカタログによって決まるため、そのカタログを開いて存在する属性を確認してください。ループ内で属性を取得するには、**@** と入力し、パーソナライズウィンドウからプロパティを選択します。

> [!NOTE]
>
> In-App キャンペーン用に作成した Jinja コードは、Cards と On-Site Messaging でもそのまま動作します。これらのチャネルは同じ方法でプロダクトセットを読み取るためです。

# UTM パラメーターを追加する

UTM パラメーターを追加すると、レコメンデーションからのトラフィックが、そのトラフィックをもたらしたキャンペーンに帰属されます。パラメーターの値はメッセージのコンテンツと同じ方法でパーソナライズできるため、1 つのキャンペーンでバリエーションごとまたはセグメントごとにレポートできます。

![パーソナライズされた値と Create custom parameter オプションが表示されている UTM パラメーターセクション](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-in-app-utm-parameters.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=0fd7d6eecbd4f7bf6f44ca6161f3301d)

独自のキーと値のペアを追加するには、**+ Create custom parameter** をクリックします。パラメーターの完全な一覧とアカウントレベルのデフォルトの適用方法については、[キャンペーンへの UTM パラメーターの追加](https://moengage.com/docs/ja/user-guide/settings/advanced-settings/add-utm-parameters-to-campaigns.md)を参照してください。

# In-App メッセージをプレビューする

公開する前に、**Preview in-app** を使用して自分のデバイスでメッセージを確認します。

![Unique ID ボックス、Test ボタン、パーソナライズされたプレビューのサンプルデータを使用するオプションが表示されている Preview in-app ウィンドウ](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-in-app-preview.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=2617e2d84734dd3cd0833d1c5e2dfc92)

**Unique ID** ボックスにテストユーザーの ID を入力し、**Test** をクリックします。**Use sample data from the personalized preview for the test** を選択して、レコメンデーションがプレースホルダーではなく実際の商品に解決されることを確認します。

> [!NOTE]
>
> プレビューにはメッセージ自体が表示されます。キャンペーンのトリガー条件をテストするには、テストユーザー向けにキャンペーンを公開してください。

# 関連記事

* [In-App キャンペーンの作成](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/in-app-message/create/create-in-app-campaign.md)
* [レコメンデーションを使用したコンテンツのパーソナライズ](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/getting-started/message-personalization/personalize-content-using-recommendations.md)
* [Cards でのレコメンデーションの使用](https://moengage.com/docs/ja/user-guide/content/recommendations/personalize-campaign-with-recommendations/using-recommendations-in-cards.md)
* [On-Site Messaging でのレコメンデーションの使用](https://moengage.com/docs/ja/user-guide/content/recommendations/personalize-campaign-with-recommendations/using-recommendations-in-on-site-messaging.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.