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

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

> Jinja を使用して MoEngage の Connector キャンペーンにパーソナライズされた商品レコメンデーションを追加し、各ユーザーのレコメンドアイテムをサードパーティの API に送信します。

Connector キャンペーンにレコメンデーションを追加すると、全員に同じペイロードを送信するのではなく、各ユーザーのレコメンドアイテムをサードパーティのシステムに送信できます。Connector チャネルでは、レコメンデーションは [Jinja テンプレート言語](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/getting-started/message-personalization/jinja-templating-language.md)を使用してリクエストペイロードに挿入されます。

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

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

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

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

> [!NOTE]
>
> Connector キャンペーンはメッセージを配信するのではなく API を呼び出すため、**Personalized preview** はありません。パーソナライズが正しく解決されることを確認するには、テストキャンペーンを配信し、エンドポイントが受信したペイロードを確認してください。

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

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

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** をクリックします。
3. **New Campaign** ダイアログボックスの **CONNECTOR** で、**Custom** をクリックします。
4. **Periodic** キャンペーンをクリックします。**One Time** を選択することもできます。配信タイプの詳細については、[配信タイプ](https://moengage.com/docs/ja/user-guide/campaigns-and-channels/getting-started/introduction/delivery-types-moengage-channels.md)を参照してください。

   ![Custom コネクターの下に One Time と Periodic が表示されている New Campaign ダイアログボックス](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-connector-new-campaign.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=0ea8c4c78c586da55f1e0c8a545d3c6d)
5. ステップ 1「Target users」でキャンペーンの基本情報を入力してオーディエンスを定義し、**Next** をクリックします。
6. ステップ 2 の **Content** タブで、リクエストを設定します。

   1. **POST** などの **Method** を選択します。
   2. **Webhook URL** ボックスに、呼び出すエンドポイントを入力します。
   3. 必要に応じて、**URL Parameters** と **Headers** をキーと値のペアとして追加します。
   4. エンドポイントで認証情報が必要な場合は、**Enable authorization settings** をオンにします。
   5. **Body type** として **Form**、**JSON**、**Raw** のいずれかを選択します。

   ![メソッド、Webhook URL、URL パラメーター、ヘッダーが表示され、それぞれで @ を入力してパーソナライズするよう促している Configure the API request セクション](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-connector-configuration.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=3d4fb95969a2e739d6182c573a21c25b)
7. レコメンデーションを表示する位置に **@** と入力します。**Connector Personalization** ウィンドウが開きます。**Webhook URL**、**URL Parameters** と **Headers** の値、およびリクエストボディをパーソナライズできます。
8. **Data personalization** タブで、レコメンデーションを検索し、**Product sets** の下でクリックします。
9. **Choose Fallback** で、ユーザーのパーソナライズが失敗した場合の動作を選択します。

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

   ![プロダクトセットのリストとフォールバックオプションが表示されている Connector Personalization ウィンドウ](https://mintcdn.com/moengage/jKaZF1_WNzLbSiuY/images/recommendations-connector-personalization.png?fit=max\&auto=format\&n=jKaZF1_WNzLbSiuY\&q=85\&s=0e0bbdd98ea538ad3e4a0615a8bc8833)
10. **Done** をクリックします。
11. 次のセクションで説明するように、挿入された Jinja コードを変更して必要なアイテムを取得します。
12. テストキャンペーンを配信し、エンドポイントで受信したペイロードを確認します。
13. 下部の **Next** をクリックし、キャンペーン設定のステップ 3 である「Schedule and Goals」に進みます。
14. **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.link}}
{% endfor %}
{% else %}
MOE_NOT_SEND
{% endif %}
```

`MOE_NOT_SEND` は、ユーザーのプロダクトセットが空の場合にリクエストの送信を停止するため、エンドポイントが商品の欠けたペイロードを受信することはありません。

プロダクトセットにはアイテムのリストが含まれており、各アイテムには `name`、`title`、`id`、`image link` などの属性があります。ループ内で属性を取得するには、**@** と入力し、パーソナライズウィンドウからプロパティを選択します。

# 関連記事

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


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