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

# LoyaltyLion

> MoEngage の Connector キャンペーンで購入イベントを LoyaltyLion に転送し、MoEngage の Content API を使用して顧客の報酬ポイントをキャンペーンに表示します。

# 概要

[LoyaltyLion](https://loyaltylion.com/) は、e コマース向けの顧客ロイヤルティおよびエンゲージメントプラットフォームです。データドリブンなロイヤルティプログラムを通じて、成長とリテンションを促進します。

# MoEngage × LoyaltyLion

MoEngage と LoyaltyLion の統合により、MoEngage で顧客のアクティビティをトラッキングし、それに応じて LoyaltyLion 内で報酬を付与できます。LoyaltyLion の REST API を使用すると、アプリで行われた購入を LoyaltyLion に転送し、購入後のエンゲージメントを図るパーソナライズされたキャンペーンを送信できます。

# 統合

<Info>
  **前提条件**

  * LoyaltyLion の API を使用するには、LoyaltyLion のトークンとシークレットが必要です。
</Info>

## MoEngage の購入を LoyaltyLion に転送する

MoEngage の Connector キャンペーンを使用すると、ユーザーがアプリまたは Web サイトで購入したときに、購入イベントを LoyaltyLion に転送できます。

MoEngage で Connector キャンペーンを作成するには、次の手順を実行します。

1. Create Campaign >> Connectors >> Custom に移動し、ニーズに最も適した配信タイプを選択します。この例では、「Event Triggered」を選択し、イベントとして「Purchased」を選択します。 <img src="https://mintcdn.com/moengage/y7-xt66tDwKMqCwN/images/partner_19614809395604.png?fit=max&auto=format&n=y7-xt66tDwKMqCwN&q=85&s=6120ee436c38068564d21d90b3599682" width="1182" height="1558" data-path="images/partner_19614809395604.png" />
2. キャンペーンのステップ 2 で、次の操作を行います。

### LoyaltyLion API を呼び出す

購入イベントを LoyaltyLion に送信するには、`POST` メソッドを使用してペイロードを設定します。

* メソッドとして POST を選択します。
* URL Parameters:
  * `api_key`: `<your_api_key>`
* Headers
  * `Authorization`: オンラインツールを使用して、ユーザー名に `token`、パスワードに `secret` を指定して Basic 認証を作成します。\
    <img src="https://mintcdn.com/moengage/y7-xt66tDwKMqCwN/images/partner_19614378396692.png?fit=max&auto=format&n=y7-xt66tDwKMqCwN&q=85&s=da50fc4d5fe3a214210d7874810b88d3" width="1836" height="616" data-path="images/partner_19614378396692.png" />\
    上の例では、このヘッダーの値は `Basic dG9rZW46c2VjcmV0` になります。
  * `Content-Type`: `application/json`
* Webhook URL としてエンドポイントを追加します: `https://api.loyaltylion.com/v2/orders`
* Body:\
  @ を入力してペイロードをパーソナライズします。
  <CodeGroup>
    ```json JSON theme={null}
    {
        "merchant_id": "6253e03b",
        "merchant_number": "1001",
        "customer_id": {{UserAttribute['customer_id']}},
        "customer_email": "{{UserAttribute['Email (Standard)']}}",
        "total": "{{EventAttribute['price']}}",
        "total_shipping": "{{EventAttribute['price']}}",
        "payment_status": "paid",
        "date": "{{EventAttribute['event_time']}}",
        "discount_codes": [
          {
            "code": "{{EventAttribute['coupon_code']}}",
            "amount": "{{EventAttribute['coupon_code_discount']}}"
          }
        ]
      }
    ```
  </CodeGroup>

<img src="https://mintcdn.com/moengage/y7-xt66tDwKMqCwN/images/partner_19614782841364.png?fit=max&auto=format&n=y7-xt66tDwKMqCwN&q=85&s=88c4c3648a1fb621f2f9313cbc782598" alt="" width="1533" height="803" data-path="images/partner_19614782841364.png" />

* 詳細については、[LoyaltyLion の API ドキュメント](https://developers.loyaltylion.com/api-reference/v2/resources/orders/create-order)を参照してください。

### リクエストをプレビューする

この時点で、キャンペーンをテストして送信する準備が整っています。Connector キャンペーン作成のステップ 2 にあるテスト機能を使用して、コネクタの設定をテストすることもできます。<img src="https://mintcdn.com/moengage/y7-xt66tDwKMqCwN/images/partner_19614809409684.png?fit=max&auto=format&n=y7-xt66tDwKMqCwN&q=85&s=619511581da0918ec9dda0920b07f22b" alt="Screen_Shot_2022-02-22_at_11.12.42_AM.png" width="2464" height="270" data-path="images/partner_19614809409684.png" />

その後、キャンペーンを公開できます。

## MoEngage キャンペーンで顧客の報酬を表示する

MoEngage の Content API を使用すると、MoEngage キャンペーン内で顧客の報酬ポイントを動的に取得し、よりパーソナライズされた体験を提供できます。

### ステップ 1: MoEngage Content API を設定する

1. **Settings** -> **Advanced settings** -> **Content API** に移動します。Content API 画面の右上にある **+ Add content API** をクリックします。<img src="https://mintcdn.com/moengage/syqICryKE0qygh49/images/partner_21979026575124.png?fit=max&auto=format&n=syqICryKE0qygh49&q=85&s=d0e6bb4492eea0f7b49b85430a3f428e" alt="ContentAPI_Navogation.png" width="2706" height="1344" data-path="images/partner_21979026575124.png" />
2. エンドポイント URL に LoyaltyLion API を追加します。エンドポイントはユースケースによって異なります。

<img src="https://mintcdn.com/moengage/syqICryKE0qygh49/images/partner_19615149966356.png?fit=max&auto=format&n=syqICryKE0qygh49&q=85&s=2640ffb0766a2dc9983ccf40ba020f9e" alt="" width="1916" height="954" data-path="images/partner_19615149966356.png" />

顧客の報酬を表示するには、LoyaltyLion の [Get Available Rewards API](https://developers.loyaltylion.com/api/resources/rewards#get-v2customersmerchant_idavailable_rewards) を使用します。

Content API の設定時に、次の URL を挿入します。

`https://api.loyaltylion.com/v2/customers/{{UserAttribute['customer_id']}}/available_rewards`

Headers に次の内容を追加します。

1. `Authorization`: オンラインツールを使用して、ユーザー名に `token`、パスワードに `secret` を指定して Basic 認証を作成します。 <img src="https://mintcdn.com/moengage/y7-xt66tDwKMqCwN/images/partner_19614378396692.png?fit=max&auto=format&n=y7-xt66tDwKMqCwN&q=85&s=da50fc4d5fe3a214210d7874810b88d3" width="1836" height="616" data-path="images/partner_19614378396692.png" />\
   上の例では、このヘッダーの値は `Basic dG9rZW46c2VjcmV0` になります。
2. `Content-Type`: `application/json`
3. 「Save」をクリックし、成功のレスポンスが表示されたら「Done」をクリックします。
   **注** - API をテストすることもできます。API をテストするには、Content API のアクションメニューから「Test」をクリックします。API のレスポンスを確認して検証できます。

### ステップ 2: MoEngage キャンペーン内で顧客の報酬を表示する

MoEngage キャンペーンでこの API を使用するには、次の手順を実行します。

1. キャンペーン作成のステップ 2 で、@ を入力します。
2. ポップアップで、ステップ 1 で設定した LoyaltyLion の Content API を選択できます。
3. [MoEngage テンプレート言語](/docs/ja/user-guide/campaigns-and-channels/getting-started/message-personalization/jinja-templating-language)を使用して API レスポンスを解析し、そのコンテンツをキャンペーンで使用できます。 <img src="https://mintcdn.com/moengage/syqICryKE0qygh49/images/partner_19616447980820.png?fit=max&auto=format&n=syqICryKE0qygh49&q=85&s=b27d4e7fd5730435cb448edd4d915710" width="1793" height="741" data-path="images/partner_19616447980820.png" />
4. Preview タブをクリックすると、リアルタイムのパーソナライゼーションでキャンペーンを確認できます。 <img src="https://mintcdn.com/moengage/syqICryKE0qygh49/images/partner_19616419328532.png?fit=max&auto=format&n=syqICryKE0qygh49&q=85&s=96cff6338300e9264d1d7084d1713533" width="1916" height="954" data-path="images/partner_19616419328532.png" />
5. 結果に問題がなければ、キャンペーンを公開できます。
