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

# Liquidでメッセージをパーソナライズする

> Liquidの基本構文、データのカテゴリ、チャネルごとの対応範囲を説明します。

Notiflyは、[Liquidテンプレート言語](https://liquidjs.com/tutorials/intro-to-liquid.html)を使ってメッセージをパーソナライズします。

Liquidは、メッセージ内の変数にユーザーごとの値を差し込むテンプレート言語です。たとえば、「こんにちは、［お名前］さん！」の［お名前］に、お客様ごとの名前を表示できます。

> [!NOTE]
>
> 商品、店舗、コンテンツなど、複数のメッセージで使うデータは[カタログ](https://docs.notifly.tech/ja/user-guide/catalogs/guide.md)に保存し、`catalog_items` または `catalog_selection_items` タグで取得できます。

## 基本構文

* 基本形式は `{{ category["variable_name"] | default: "デフォルト値" }}` です。
  * 式には、差し込むデータのカテゴリと項目名を指定します。
  * 項目に値がない場合に表示する文言は、`default` フィルターで指定します。
* 属性値もデフォルト値もない場合は、その部分が空欄のまま送信されます。
* 使えるカテゴリは、キャンペーンの送信対象や送信タイミングによって異なります。詳しくは[データのカテゴリ](#データのカテゴリ)をご覧ください。
* キャンペーンの作成画面では、構文を直接入力せずにパーソナライズ変数を追加できます。

## データのカテゴリ

利用できるカテゴリは、送信対象と送信タイミングによって異なります。詳しくは[送信対象を設定する](https://docs.notifly.tech/ja/user-guide/campaigns/campaign-segments/segment.md)と[送信タイミング](https://docs.notifly.tech/ja/user-guide/campaigns/basic.md#2-%E9%80%81%E4%BF%A1%E3%82%BF%E3%82%A4%E3%83%9F%E3%83%B3%E3%82%B0)をご覧ください。

1. Notiflyに登録されているユーザー属性
   * カテゴリ名は `user` です。
   * **ユーザーグループ設定**、AIセグメント、またはユーザーIDを使ったCSV送信で使用できます。APIベースの送信では、宛先が登録済みユーザーに紐づく場合に使用できます。
   * たとえば、年齢を表示する箇所に `{{ user["age"] }}` と入力します。値を表示するには、ユーザーの年齢が `age` という属性名でNotiflyに登録されている必要があります。
   * 標準のユーザー属性は、次の式で参照できます。
     * ユーザーIDは `user["$user_id"]` です。
     * メールアドレスは `user["$email"]` です。
     * 電話番号は `user["$phone_number"]` です。
     * カスタム属性にこれらと同じ名前を使った場合は、標準の属性値が優先されます。
2. Notiflyに登録されているデバイス情報
   * カテゴリ名は `device` です。
   * **ユーザーグループ設定**、ユーザーIDを使ったCSV送信、またはAIセグメントで、登録済みのデバイス情報を使用できます。APIベースの送信では、宛先が登録済みのデバイスに紐づく場合に使えます。
   * Webhookでは使用できません。
   * 参照できるデバイス属性は次のとおりです。
     * `external_user_id` はサービス側のユーザーIDです。
     * `platform` はデバイスのプラットフォーム（`ios` または `android`）です。
     * `os_version` はデバイスのOSバージョンです。
     * `app_version` はアプリのバージョンです。
3. イベントパラメータ
   * カテゴリ名は `event` です。
   * イベントベースの送信とAPIベースの送信で使用できます。
     * イベントベースの送信では、送信を開始したイベントのパラメータを使用できます。パラメータを含むイベントを送信する方法は、[イベントベースの送信](https://docs.notifly.tech/ja/user-guide/campaigns/basic.md#2-2-%E3%82%A4%E3%83%99%E3%83%B3%E3%83%88%E3%83%99%E3%83%BC%E3%82%B9%E3%81%AE%E9%80%81%E4%BF%A1)をご覧ください。
     * APIベースの送信では、リクエストボディの `recipients[].eventParams` にパラメータを指定します。詳しくは[APIベースの送信](https://docs.notifly.tech/ja/user-guide/campaigns/basic.md#2-3-api%E3%83%99%E3%83%BC%E3%82%B9%E3%81%AE%E9%80%81%E4%BF%A1)をご覧ください。
   * たとえば、イベントに `name` パラメータが含まれている場合は、`event["name"]` で参照できます。この項目がない場合、値は挿入されません。
4. CSVで指定した送信対象のデータ
   * カテゴリ名は `csv` です。
   * CSVファイルをアップロードするキャンペーンの予約送信で使用できます。CSVで送信対象を指定する場合、イベントベースの送信には対応していません。
   * 参照できるのは、アップロードしたファイルにある項目だけです。
   * たとえば、ファイルに `budget` がある場合は、`csv["budget"]` で参照できます。存在しない項目を参照すると、キャンペーンを作成できません。
5. ユーザージャーニーの進入イベント
   * カテゴリ名は `entry_event` です。
   * ユーザージャーニーでは、進入イベントのパラメータを参照できます。APIベース進入の場合は、リクエストの `users[].eventParams` の値を参照できます。
   * たとえば、進入イベントに `product_name` がある場合は、`entry_event["product_name"]` で参照できます。
6. ジャーニーへの進入に使うCSVの項目
   * カテゴリ名は `entry_csv` です。
   * CSVを使ってユーザージャーニーへの進入条件を設定した場合、アップロードしたファイルの項目を参照できます。
   * たとえば、ファイルに `coupon_code` がある場合は、`entry_csv["coupon_code"]` で参照できます。

## チャネルごとの対応範囲

> [!WARNING]
>
> LINEでは現在、メッセージのパーソナライズに対応していません。

| チャネル | パーソナライズできる項目 | `{{ ... }}` による 変数の出力 | `{% if %}` などの タグ | `default` 以外の フィルター | Connected Contentと `abort_message` |
| - | - | - | - | - | - |
| アプリプッシュ | タイトル、本文、アクションURL、カスタムデータ | 対応 | 対応 | 対応 | 対応 |
| Webプッシュ | タイトル、本文 | 対応 | 対応 | 対応 | 非対応 |
| アプリ内ポップアップ | Textの内容、Buttonのラベルとリンク、HTMLブロック | 対応 | 対応 | 対応 | 対応 |
| Webポップアップ | Textの内容、Buttonのラベルとリンク、HTMLブロック | 対応 | 対応 | 対応 | 対応 |
| SMS | タイトル、本文 | 対応 | 非対応 | 一部対応 | 非対応 |
| カカオアリムトーク | テンプレート変数として指定された箇所 | 対応 | 一部対応 | 一部対応 | 非対応 |
| カカオブランドメッセージ | テンプレート変数として指定された箇所 | 対応 | 一部対応 | 一部対応 | 非対応 |
| メール | タイトル、本文、ハイパーリンク | 対応 | 非対応 | 非対応 | 非対応 |
| Webhook | JSONボディ | 対応 | 対応 | 対応 | 非対応 |

ポップアップのパーソナライズには、新しいポップアップエディターで作成したテンプレートと、対応するSDKバージョンが必要です。入力方法と最小SDKバージョンは、[アプリ内ポップアップテンプレートの作成](https://docs.notifly.tech/ja/user-guide/channel/in-app-message/file.md)と[Webポップアップテンプレートの作成](https://docs.notifly.tech/ja/user-guide/channel/web-message/file.md)をご覧ください。

ポップアップでは `user`、`device`、`event` を使用できます。ジャーニーの進入データは `entry_event` または `entry_csv` で参照します。データがある場合、Notiflyが変数に値を差し込みます。通常のCSV送信用の `csv` はポップアップで使用できません。

## 作成画面でパーソナライズ変数を追加する

1. メッセージ入力欄の左下で **パーソナライズ変数** を選択します。パーソナライズに対応していないチャネルでは、ボタンが表示されない場合があります。
2. チャネル、送信対象、送信タイミングに応じて表示されるカテゴリから、使用するカテゴリを選択します。

![パーソナライズ変数の設定画面](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/campaigns/ui-personalization.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=24cab5a9dfe16c1dbcf15d2afcb17b97)

3. 差し込む項目名を選択するか、入力します。項目名は必須です。
4. 項目の値がない場合に表示する文言は、必要に応じて **デフォルト値（任意）** に入力します。

メッセージ入力欄にLiquid式が表示されます。

![メッセージに挿入されたLiquid式](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/campaigns/ui-personalization-example.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=97bd8529767ea9c1c2f51f30cea99527)


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