> ## 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.

# WhatsApp でのレコメンデーションの使用

> 承認済みテンプレートと Jinja を使用して MoEngage の WhatsApp キャンペーンにパーソナライズされた商品レコメンデーションを追加し、各ユーザーに関連する商品を送信します。

WhatsApp キャンペーンにレコメンデーションを追加すると、全員に同じメッセージを送信するのではなく、各ユーザーに最も関連性の高い商品を送信できます。WhatsApp チャネルでは、レコメンデーションは [Jinja テンプレート言語](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/getting-started/message-personalization/jinja-templating-language.md)を使用して、事前承認済みの WhatsApp テンプレートのプレースホルダーに挿入されます。

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

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

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

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

# 前提条件

Email や Push とは異なり、WhatsApp ではコンテンツをパーソナライズする前に承認済みのテンプレートが必要です。次の点を確認してください。

* レコメンデーション (プロダクトセット) が設定され、ユーザーアクションにマッピングされていること。[ユーザーアクション設定のマッピング](https://moengage.com/docs/ja/user-guide/content/recommendations/getting-started/map-user-actions-settings.md)を参照してください。
* レコメンデーションのデータを格納するのに十分なプレースホルダーを持つ、事前承認済みの WhatsApp テンプレートがあること。たとえば、ユーザーの名前に加えて、レコメンドされた商品のタイトルとリンクを送信するには、3 つのプレースホルダーを持つテンプレートの承認を取得します。[WhatsApp テンプレート](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/whatsapp/getting-started-with-whatsapp/whatsapp-templates.md)を参照してください。

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

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

1. MoEngage のサイドバーメニューで、Engage メニュー項目 ![Engage メニューアイコン](https://mintcdn.com/moengage/_fazdN5K6hQMBuV9/images/moengage_3a6ded.png?fit=max\&auto=format\&n=_fazdN5K6hQMBuV9\&q=85\&s=5b7311df5455793975271a77743d0dc4) にカーソルを合わせます。**Engage** メニューが表示されます。
2. **+ New Campaign** をクリックします。![New Campaign オプションが表示されている Engage メニュー](https://mintcdn.com/moengage/2CGhjk8ZDWEC5ocb/images/moengage_f884be.png?fit=max\&auto=format\&n=2CGhjk8ZDWEC5ocb\&q=85\&s=0ada01182ce9b14f1ee343c52b517b74) **Engage** メニューの **All Campaigns** をクリックし、All campaigns ページで **+ Create campaign** をクリックすることもできます。
3. **New Campaign** ダイアログボックスの **MESSAGING APPS** で、**WhatsApp** をクリックします。
4. **Periodic** キャンペーンをクリックします。他の WhatsApp キャンペーンタイプでも同じ手順を実行できます。配信タイプの詳細については、[配信タイプ](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/getting-started/introduction/delivery-types-moengage-channels.md)を参照してください。![Messaging Apps で WhatsApp が選択され、Periodic 配信タイプが表示されている New Campaign ダイアログボックス](https://mintcdn.com/moengage/AqE2bsr1IF39nHOR/images/whatsapp-new-campaign-periodic.png?fit=max\&auto=format\&n=AqE2bsr1IF39nHOR\&q=85\&s=55b22117606b6dd9dfa5be2c5e81a5f2)
5. ステップ 1「Target users」でキャンペーンの基本情報を入力してオーディエンスを定義し、**Next** をクリックします。
6. ステップ 2 の **Content** タブで、**Select sender** リストから送信者を選択します。
7. **Select template** リストで承認済みのテンプレートを選択します。![Content タブで送信者と承認済みテンプレートを選択している様子](https://mintcdn.com/moengage/S2vOz7ciYYqlhjCf/images/moengage_6b5913.png?fit=max\&auto=format\&n=S2vOz7ciYYqlhjCf\&q=85\&s=9421727e6780bf0ab364113870011cd0)
8. **Header** または **Body** のプレースホルダーフィールドに「@」と入力します。**WhatsApp Personalization** ウィンドウが開きます。
9. **Data personalization** タブの **Select attribute** リストで、レコメンデーションを検索し、**Product sets** の下で選択します。![Data personalization タブと Choose Fallback オプションが表示されている WhatsApp Personalization ウィンドウ](https://mintcdn.com/moengage/dLyLAwgfsm1v6_MY/images/moengage_86260a.png?fit=max\&auto=format\&n=dLyLAwgfsm1v6_MY\&q=85\&s=9e359f5a15c90f0b0ecc68a7507b65c4)
10. **Choose Fallback** でフォールバックを選択し、**Done** をクリックします。
    **Choose Fallback** オプションは、ユーザーのパーソナライズが失敗した場合にそのユーザーが受け取る内容を制御します。

    | フォールバック | 動作 |
    | - | - |
    | **No fallback** | プレースホルダーは空の値に置き換えられます。 |
    | **Do not send campaign** | そのユーザーにはキャンペーンが送信されません。 |
    | **Replace text** | プレースホルダーは入力したテキストに置き換えられます。 |
11. レコメンデーションから利用可能なすべてのアイテムリストを取得する Jinja コードが自動的に入力されます。ユースケースに合わせてコードを変更できます。たとえば、次は 1 つのアイテムを表示するように変更したコードです。
    ```jinja JINJA theme={null}
    {% if ProductSet.RealTimeAIRecommendations%}
    {% for product in ProductSet.RealTimeAIRecommendations[0:1]%}
    {{product.title}}
    {% endfor %}
    {% else %}
    MOE_NOT_SEND
    {% endif %}
    ```
    > [!NOTE]
    >
    > `MOE_NOT_SEND` は、ユーザーのプロダクトセットが空の場合にメッセージの送信を停止するため、空白のプレースホルダーを含むメッセージを受け取るユーザーはいません。
12. アイテムの属性を表示するには、`for` ループ内にカーソルを置いて「@」と入力し、**Select attribute** リストで属性を選択します。属性はループ内に挿入されます (例: `{{product['price']}}`)。
13. テンプレート内の残りの各プレースホルダーについて、手順 8 ～ 12 を繰り返します。プレースホルダーごとに、レコメンデーションによるパーソナライズまたは静的なテキストコンテンツを選択できます。
14. 設定が完了したら、**Preview type** で **Personalized** をクリックします。MoEngage がユーザーを選択し、実際の値でメッセージを表示します。
15. 特定のユーザーのメッセージをプレビューするには、編集アイコン ![編集アイコン](https://mintcdn.com/moengage/q2ALITKbE0y0S_CF/images/personalized-preview-edit-icon.png?fit=max\&auto=format\&n=q2ALITKbE0y0S_CF\&q=85\&s=848f3575779c106dc8204643a48b5b83) をクリックします。**Personalized preview** スライドアウトが開きます。
16. **Select user by** リストで、使用する識別子を選択します。
17. **User identifier value** フィールドに、ユーザーの識別子を入力します。
18. **Fetch user data** をクリックします。**Personalization inputs** の下に、そのユーザーが利用できるアイテムを含むプロダクトセットが JSON として表示されます。
19. プレビューしたい内容に合わせて JSON を変更します。(任意)
20. **Update preview** をクリックします。![プロダクトセットの JSON と表示されたメッセージが表示されている Personalized preview スライドアウト](https://mintcdn.com/moengage/AqE2bsr1IF39nHOR/images/whatsapp-personalized-preview.png?fit=max\&auto=format\&n=AqE2bsr1IF39nHOR\&q=85\&s=72a77a357ff0cf472b47f028d9033a5b)
    > [!NOTE]
    >
    > アカウントで **Update preview** を有効にするには、MoEngage の CSM または Support チームにお問い合わせください。詳細については、[パーソナライズされたプレビュー](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/getting-started/message-personalization/personalized-preview.md)を参照してください。
21. すべてのユーザーに対してスケジュールする前に、テストキャンペーンを配信してエンドツーエンドの配信を確認することもできます。![Test Campaign パネル](https://mintcdn.com/moengage/prFQLkdcYp4xSt9t/images/moengage_64d866.png?fit=max\&auto=format\&n=prFQLkdcYp4xSt9t\&q=85\&s=418af816177da54b157eb6fc1262ec7e)
22. レコメンデーションを使用したコンテンツの設定が完了したら、下部の **Next** をクリックし、キャンペーン設定のステップ 3 である「Schedule and Goals」に進みます。
23. **Schedule and Goals** で適切な設定を行い、キャンペーンを公開します。

# 関連記事

* [WhatsApp キャンペーンのパーソナライズ](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/whatsapp/create/personalize-whatsapp-campaign.md)
* [レコメンデーションを使用したコンテンツのパーソナライズ](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/getting-started/message-personalization/personalize-content-using-recommendations.md)
* [Email でのレコメンデーションの使用](https://moengage.com/docs/ja/user-guide/content/recommendations/personalize-campaign-with-recommendations/using-recommendations-in-email.md)
* [Push でのレコメンデーションの使用](https://moengage.com/docs/ja/user-guide/content/recommendations/personalize-campaign-with-recommendations/using-recommendations-in-push.md)


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