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

# ユーザー属性を管理する

> カスタムユーザー属性を登録し、必要な属性の値を暗号化する手順です。

**属性管理**でカスタムユーザー属性を登録し、属性ごとに暗号化を設定できます。氏名や住所など保護が必要な情報は、**データを送信する前に属性を登録し、暗号化を有効に**してください。暗号化を有効にした属性は、データベースの暗号化に加え、値自体も暗号化して保存します。メッセージのパーソナライズに使う場合は、復号した値を差し込みます。

ここで設定できるのは、カスタムユーザー属性の暗号化です。標準フィールドのメールアドレスと電話番号は暗号化して保存され、この画面から暗号化を無効にすることはできません。

## ユーザー属性とイベントパラメータのキーに使える文字

カスタムユーザー属性やイベントパラメータのキーは、正規表現 `^[A-Za-z][A-Za-z0-9_]*$` に一致する必要があります。

* 1文字目には半角英字（`A–Z` または `a–z`）を使います。
* 2文字目以降に使えるのは、半角英字、数字（`0–9`）、アンダースコア（`_`）です。
* ひらがな、カタカナ、漢字、全角の英数字、空白、ピリオド（`.`）など、上記以外の文字は使えません。

たとえば、`delivery_address` や `productId2` は使用できます。

キーが命名規則に合わなくても、Notiflyはデータを保存します。ただし、そのキーは一部の機能で使えない場合があります。たとえば、`delivery.address` のようにピリオド（`.`）を含むユーザー属性には、次の制限があります。

* キャンペーンの条件設定で検索しても表示されません。
* ユーザー一覧やユーザー詳細に表示されません。
* 全ユーザーのCSVエクスポートに含まれません。
* **属性管理** に表示されないため、暗号化を設定できません。

## 属性を登録する

1. Notiflyコンソールで設定対象のプロダクトと環境を選びます。
2. **ユーザー管理** > **ユーザー一覧** を開き、**属性管理** をクリックします。
3. **属性を追加** をクリックします。

![ユーザー属性の一覧と属性を追加するボタン](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/users/01-property-management.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=7d8523da683b01b7683240285d448bda)

4. 送信するキーと同じ **属性名** を入力します。たとえば、配送先住所を `delivery_address` として送信する場合は、その名前で登録します。
5. 保護が必要な属性の場合は **暗号化** をオンにし、**追加** をクリックします。

![属性名の入力欄と暗号化の設定](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/users/02-property-registration.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=08cab8e8d29e156358d6cfaa0f4957b8)

属性を登録しても、ユーザーや属性値は作成されません。データの収集を始める前に、キーを登録し、暗号化を設定できます。

## 暗号化を設定する

### 暗号化を有効にする

1. **属性管理** で対象の属性のスイッチをクリックします。
2. 注意事項を確認します。更新が必要なキャンペーンやユーザージャーニーが表示された場合は、その一覧を確認します。
3. **暗号化を有効にする** をクリックします。

> [!NOTE]
>
> 暗号化の設定が反映されるまでに、最大15分かかることがあります。

### キャンペーンとユーザージャーニーへの影響を確認する

暗号化を有効にする前に、Notiflyはその属性を使っている有効なキャンペーンとユーザージャーニーの条件を確認します。暗号化された属性で[サポートされていない条件](#配信対象の条件)が使われている場合、暗号化は有効にできません。

確認画面には、修正が必要なキャンペーンとユーザージャーニー、および使用中の条件が表示されます。たとえば、`address` に対して **文字列を含む** を指定している場合は、その条件を修正してください。

![暗号化を有効にできないキャンペーンとユーザージャーニーの条件](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/users/03-encryption-impact.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=99df68b18ef1eab689316cc5b5c20565)

一覧に表示されたキャンペーンとユーザージャーニーを開いて条件を修正したら、**属性管理** に戻り、もう一度暗号化を有効にします。

### 暗号化を無効にする

> [!WARNING]
>
> 暗号化を無効にする前に、既存の値がマスキングなしで表示されても問題ないか確認してください。設定が反映されると、コンソールに値が表示され、SDKに渡される場合があります。保存済みの暗号文が一括で復号されることはありません。

1. 暗号化されている属性のスイッチをクリックします。
2. **暗号化を無効にする際の注意事項** を確認します。
3. **暗号化を無効にする** をクリックします。

![暗号化を無効にする際の注意事項と確認ボタン](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/users/04-encryption-disable.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=ec6e2cea3f3bf3843742bc85668e8188)

暗号化を無効にする際は、キャンペーンやユーザージャーニーの条件は確認されません。

## 暗号化した属性を使う

### ユーザー情報を確認する

ユーザー詳細画面では、暗号化した属性の値がマスキングされ、鍵のアイコンが表示されます。暗号化していない属性は通常どおり表示されます。

![ユーザー詳細画面で伏せ字になっている氏名](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/users/05-user-property-masking.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=83bbac372a359faf9bb104d8a1f5eaca)

### 配信対象の条件

暗号化された属性には、次の条件だけを使用できます。

* **一致**。属性値が入力した値と同じユーザーが対象です。
* **不一致**。属性値が入力した値と異なるユーザーが対象です。
* **存在する**。その属性に値があるユーザーが対象です。
* **存在しない**。その属性に値がないユーザーが対象です。

文字列の部分一致、前方一致、後方一致、大小比較など、その他の条件は使用できません。

![キャンペーンの配信対象設定に表示される、暗号化した属性の条件](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/users/06-encrypted-condition-operators.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=7a1d994578abb5e187c7a86f19e26828)

### メッセージのパーソナライズ

暗号化した属性もメッセージに差し込めます。たとえば、暗号化した氏名を使って受信者ごとに宛名を変えられます。

コンソールで伏せ字になっていても、差し込んだ値は受信者のメッセージに表示されます。受信者に見せてよい情報か確認してください。

設定方法は、[メッセージのパーソナライズ](https://docs.notifly.tech/ja/user-guide/campaigns/personalization/basic.md)を参照してください。

## 暗号化の制限

* 暗号化した属性をセグメント条件に使う場合は、[対応する条件](#配信対象の条件)を選びます。メッセージのパーソナライズにも使用できます。
* 暗号化の有効化や無効化が反映されるまでに、最大15分かかることがあります。反映されるまでは、変更前の設定が適用される場合があります。
* 同じセッション内で暗号化されたユーザー属性の値が変わっても、ポップアップの表示対象はすぐには更新されません。次にユーザーの状態を取得するときに再判定します。


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