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

# アラートのパーソナライズ

> MoEngage Inform で、パーソナライゼーションエディターまたは属性フォールバック付きの Jinja テンプレートを使用して、トランザクションアラートのコンテンツをパーソナライズします。

アラートは、アラート作成のコンテンツ作成ステップで、*Text personalization* ボタンまたは JINJA を使用してパーソナライズできます。

# パーソナライゼーションエディターを使用したパーソナライズ

パーソナライズするには、次の手順に従います。

1. アラート作成のステップ 2: Content で、**Text personalization** ボタンをクリックします。 <img src="https://mintcdn.com/moengage/50ZszvUJB4M_6y_L/images/moengage_e78ee6.png?fit=max&auto=format&n=50ZszvUJB4M_6y_L&q=85&s=ac0a94f4d1251b0b1a79061478fa595b" alt="text personalize.png" width="1686" height="938" data-path="images/moengage_e78ee6.png" />
2. 表示される画面の **Personalisation Attribute** フィールドに、パーソナライズする属性を追加します。
3. パーソナライズされた属性のフォールバックとして、ユーザー属性を指定できます。注: このオプションを利用するには、Inform Settings で User Attributes を有効にする必要があります。詳細については、[User Attribute settings](/docs/ja/user-guide/settings/miscellaneous/settings-inform#user-attribute-settings) を参照してください。 <img src="https://mintcdn.com/moengage/4hNKOAjPrnhpJB2_/images/moengage_7f5104.png?fit=max&auto=format&n=4hNKOAjPrnhpJB2_&q=85&s=5aa899baf6b9f8351b662a60e7468b4b" alt="PersonalizationEditor.png" width="992" height="828" data-path="images/moengage_7f5104.png" />
4. **Copy & Close** をクリックして、パーソナライズされた属性をクリップボードにコピーします。
5. 標準のキーボードショートカットを使用して、コピーした値をメッセージエディターに貼り付けます。

<Info>
  パーソナライゼーション用に追加するユーザー属性の名前には、文字列、英字と数字の組み合わせ、アンダースコアのみを使用できます。たとえば、パーソナライズする属性名として *username*、*user\_name、usernmae1* は使用できますが、*user name* や *user name1* は使用できません。属性名に文字列、アンダースコア、英数字以外の文字(スペース、数字のみ、特殊文字など)が含まれている場合、パーソナライゼーションは機能しません。
</Info>

<Tabs>
  <Tab title="フォールバックとしてのユーザー属性">
    次のフロー図は、ユーザー属性をフォールバックとして使用した場合のパーソナライゼーションの仕組みを示しています。

    <img src="https://mintcdn.com/moengage/xeb_76Bworf1GG6P/images/moengage_99043f.png?fit=max&auto=format&n=xeb_76Bworf1GG6P&q=85&s=3668ae7e4df747b0f46167a1c6dd0375" alt="UserAttributesas_Fallback.png" width="1178" height="1382" data-path="images/moengage_99043f.png" />

    以下は、ユーザーの名前と注文 ID を、ユーザー属性をフォールバックとしてパーソナライズしたメッセージ本文のサンプルです。

    **サンプルメッセージ本文**

    `Hi {{username|default("{{UserAttribute['USER_ATTRIBUTE_USER_NAME']|default('user')}}")}}!`

    Your order `{{orderid}}` has been placed successfully.

    Happy Shopping!

    Team MoEngage
  </Tab>

  <Tab title="ユーザー属性なし">
    次のフロー図は、ユーザー属性が無効になっている場合のパーソナライゼーションの仕組みを示しています。

    <img src="https://mintcdn.com/moengage/dLyLAwgfsm1v6_MY/images/moengage_8565a9.png?fit=max&auto=format&n=dLyLAwgfsm1v6_MY&q=85&s=2196b7cc2d605c466d58596b1c24b84f" alt="UserAttributesas_Disabled.png" width="692" height="922" data-path="images/moengage_8565a9.png" />

    **注:** ユーザー属性が(有効化後に)無効にされた場合、以降の API リクエストには標準の SLA が適用されます。

    以下は、ユーザーの名前と注文 ID をパーソナライズしたメッセージ本文のサンプルです。

    **サンプルメッセージ本文**

    Hi `{{firstname}}`!

    Your order `{{orderid}}` has been placed successfully.

    Happy Shopping!

    Team MoEngage
  </Tab>
</Tabs>

## パーソナライゼーションを含むサンプルペイロード

JSON

```json wrap theme={null}
{
"user_id": "john_doe",
"payloads": {
        "SMS": {
            "recipient": "+1555555555",
            "personalized_attributes": {
                "firstname": "John",
                "orderid": "#order HXY-12345-ZSDF"
            }
        },
        "EMAIL": {
            "recipient": "john.doe@moengage.com",
            "personalized_attributes": {
                "firstname": "John",
                "orderid": "#order HXY-12345-ZSDF"
            }
        }
    }
```

リクエストをトリガーする際には、firstname と orderid を送信する必要があります。

## 顧客が受信したパーソナライズされたアラート

<Tabs>
  <Tab title="ユーザーが受信したアラート SMS">
    <img src="https://mintcdn.com/moengage/eF2J43N9Ckga5Apm/images/moengage_2d42e0.png?fit=max&auto=format&n=eF2J43N9Ckga5Apm&q=85&s=e5140849055c42c482e288a46da91725" alt="AlertSMS.jpg" width="1165" height="877" data-path="images/moengage_2d42e0.png" />
  </Tab>

  <Tab title="ユーザーが受信したアラートメール">
    <img src="https://mintcdn.com/moengage/OQ0V9ibjQLpsyCSD/images/moengage_0f97c9.png?fit=max&auto=format&n=OQ0V9ibjQLpsyCSD&q=85&s=3f6024a4b32fc22f28c5a9d5932d9e29" alt="AlertEmail.png" width="2880" height="680" data-path="images/moengage_0f97c9.png" />
  </Tab>

  <Tab title="ユーザーが受信したアラートプッシュ通知">
    <img src="https://mintcdn.com/moengage/xjBZUVmmH3jDrySH/images/moengage_c62675.png?fit=max&auto=format&n=xjBZUVmmH3jDrySH&q=85&s=c6acfd25c53ae7e09c2a8407d6b01fc3" alt="Personalized_Notification__1_.png" width="1073" height="481" data-path="images/moengage_c62675.png" />
  </Tab>
</Tabs>

# Content Blocks を使用したパーソナライズ

Content Blocks は、アラートで使用できる再利用可能なコンテンツです。*Content Blocks* 機能を活用してアラートをパーソナライズすることで、ユーザーエンゲージメント、効率、および全体的な顧客体験が向上します。アラート用のコンテンツブロックの作成について詳しくは、[Content Blocks](/docs/ja/user-guide/content/content-blocks/content-blocks) を参照してください。

## コンテンツブロックの追加

1. コンテンツブロックを追加するには、**Text personalization** ボタンをクリックします。Inform のパーソナライゼーションポップアップウィンドウが表示されます。 <img src="https://mintcdn.com/moengage/geRh9DNA2GhPhrjA/images/moengage_f4feab.png?fit=max&auto=format&n=geRh9DNA2GhPhrjA&q=85&s=d4123053a4d15da1dd647e6112f5ecf5" alt="21.png" width="850" height="694" data-path="images/moengage_f4feab.png" />
2. **Content block** タブに移動します。
3. **Select content block** ドロップダウンから目的のコンテンツブロックを選択します。 <img src="https://mintcdn.com/moengage/cFTwc93vQdTanvKi/images/moengage_be7257.png?fit=max&auto=format&n=cFTwc93vQdTanvKi&q=85&s=d81f91b85041ed837ea156cc56f47e25" alt="22.png" width="850" height="698" data-path="images/moengage_be7257.png" />
4. 次のトグルを使用して、コンテンツブロックのコンテンツのみを挿入することもできます。 <img src="https://mintcdn.com/moengage/t9nft78wsoLTI2Nx/images/moengage_293f39.png?fit=max&auto=format&n=t9nft78wsoLTI2Nx&q=85&s=8372e43287725e885f4d38c88485b197" alt="23.png" width="492" height="66" data-path="images/moengage_293f39.png" /> この場合、既存のコンテンツブロックから切り離されてコンテンツのみが挿入され、今後の更新は反映されません。
5. **Copy & Close** をクリックして、パーソナライズされた属性をクリップボードにコピーします。
6. 標準のキーボードショートカットを使用して、コピーした値をメッセージエディターに貼り付けます。

# JINJA を使用したパーソナライズ

JINJA を使用してアラートをパーソナライズするには、コンテンツ作成ステップでテンプレートエディターに JINJA を追加し、JINJA で使用する属性をリクエストペイロードの \_personalized\_attributes\_object で渡します。

## パーソナライゼーションを含むサンプルペイロード

サンプルメールペイロード

```json theme={null}
{  
    "alert_id": "652fba0290f2820d05e12852",
    "user_id": "John_Doe",
    "transaction_id": "135671868",
    "payloads": {
        "EMAIL": {
            "recipient": "john.doe@example.com",
            "personalized_attributes": {
                "items": [
                  {  
                    "name": "iPhone 15",
                    "price": "2500 AED",
                    "image": "https://yourbrand.com/iPhone.jpg"
                  },
                  {
                    "name": "Macbook Air",
                    "price": "3000 AED",
                    "image": "https://yourbrand.com/MacbookAir.jpg"
                  },
                  {
                    "name": "Airpods",
                    "price": "800 AED",
                    "image": "https://yourbrand.com/Airpods.jpg"
                  }
                ],
           }
        }
    }
}
```

## 顧客が受信したパーソナライズされたアラート

<img src="https://mintcdn.com/moengage/0iWkm50wROjmHH3Z/images/moengage_d09832.png?fit=max&auto=format&n=0iWkm50wROjmHH3Z&q=85&s=3724442eae216c2a6568eab4665a4f49" alt="JINJAPersonalization_Email.png" width="2218" height="1328" data-path="images/moengage_d09832.png" />
