> ## 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 でカスタムセグメントを作成、再利用、管理します。セグメントクエリを保存してキャンペーンや分析で再利用し、All Segments ページから表示、編集、名前変更、アーカイブ、分析を行えます。
カスタムセグメントとは、保存された名前付きのセグメントクエリであり、毎回クエリを作り直すことなく、キャンペーン、フロー、分析ページで再利用できます。カスタムセグメントは [ファイルセグメント](/docs/ja/user-guide/segment/create-segments/file-segments) またはルールベースの [フィルターセグメント](/docs/ja/user-guide/segment/create-segments/rule-based-filter-segments) のいずれかであり、両方を組み合わせることもできます。さらに他のカスタムセグメントと組み合わせることも可能です。
この記事では、カスタムセグメントの作成方法と使用方法、および **All Segments** ページからの表示・管理方法について説明します。
1 つのワークスペースで保持できるアクティブなセグメントは最大 1,000 件です（ファイル、フィルター、カスタムの合計）。この上限を引き上げるには、サポートにお問い合わせください。
## カスタムセグメントの作成
MoEngage ダッシュボードでは、カスタムセグメントを次の 3 つの方法で作成できます。
* **Segment** > **Create Segment** に移動します。クエリを入力した後、**Create** をクリックして **Create Custom Segment** を選択します。カスタムセグメント名を入力して保存します。Recent Query セクションから作成することもできます。選択したクエリの **Create Custom Segment** アイコンをクリックし、名前を入力して保存します。これらのセクションでは動的なカスタムセグメントが作成されます。詳細については、[セグメントの作成](/docs/ja/user-guide/segment/create-segments/rule-based-filter-segments) を参照してください。
* ユーザーのインポート時。セグメント内のユーザーは固定されるため、これは静的なカスタムセグメントになります。[CSV を使用したユーザーデータのインポートの詳細はこちら。](/docs/ja/user-guide/data/imports/manual-uploads)
* Behavior 分析、Funnel 分析、RFM セグメントから。これらのセクションでは動的なカスタムセグメントが作成されます。[RFM セグメントの詳細はこちら。](/docs/ja/user-guide/segment/create-segments/rfm-segments)
**セグメントの命名ルール:** `All Users` という名前は MoEngage によって予約されているため、カスタムセグメント名として使用できません。また、セグメント名には `:` `|` `*` `?` `\` `<` `>` `=` `$` `"` の文字を含めることはできず、ピリオド（`.`）で始めることはできず、空白のみで構成することはできず、200 文字を超えることはできません。これらのルールは名前にのみ適用され、アップロードされたファイル内の値には適用されません。無効な名前または予約済みの名前を持つセグメントは拒否されます。セグメントが API または外部連携（Mixpanel コホート同期など）を通じて作成された場合、拒否は通知なしに行われることがあります。その場合、セグメントはカスタムセグメントのドロップダウンに表示されないか、ユーザー数が 0 と表示されます。
## カスタムセグメントの使用
MoEngage ダッシュボードでは、カスタムセグメントを複数の方法で使用できます。
* カスタムセグメントをユーザープロパティやユーザーアクティビティと組み合わせて、複雑なユーザーセグメントを構築できます。
* 他のカスタムセグメントを作成する際にカスタムセグメントを使用できます。カスタムセグメントは最大 6 レベルの再帰/ネストをサポートします。たとえば、カスタムセグメント A にセグメント B を含め、セグメント B にセグメント C を含める、といった形です。[ファイルセグメント](/docs/ja/user-guide/segment/create-segments/file-segments) はネストの上限にカウントされません。高度なネスト手法については、[セグメントのネスト](/docs/ja/user-guide/segment/advanced-concepts/segment-nesting) を参照してください。
* 新しいカスタムセグメントを定義する際、既存のカスタムセグメントを最大 10 件使用できます。[ファイルセグメント](/docs/ja/user-guide/segment/create-segments/file-segments) はこの上限にカウントされません。
* Push、Email、SMS、In-App、Facebook、Flows などのチャネルでキャンペーンを作成する際に、カスタムセグメントをターゲットオーディエンスとして使用できます。
上記のネストおよびカスタムセグメントの上限内に収まっている定義であっても、実行に失敗する場合があります。参照されている各カスタムセグメントは、クエリのシリアル化時に完全な定義に展開され、シリアル化されたクエリは 256 KB（262,144 文字）を超えることはできません。複数のカスタムセグメントを OR で組み合わせること（除外ブロック内を含む）が、この上限を超える最も一般的なパターンです。症状と定義のサイズを削減する方法については、[セグメントクエリがクエリ長エラーで失敗するのはなぜですか？](/docs/ja/user-guide/segment/faqs-segment/why-does-my-segment-query-fail-with-a-query-length-error) を参照してください。
### カスタムセグメントの分析
カスタムセグメントのユーザーは、MoEngage の分析ページ（[Behavior](/docs/ja/user-guide/analyze/analytics/behavior/behavior-overview)、[Funnel](/docs/ja/user-guide/analyze/analytics/funnels/funnels-overview)、[Retention](/docs/ja/user-guide/analyze/analytics/retention/retention-overview)、[Session & Source](/docs/ja/user-guide/analyze/analytics/session-and-source/session-and-source-overview)、[User Paths](/docs/ja/user-guide/analyze/analytics/user-paths/user-paths-overview)、[RFM Segments](/docs/ja/user-guide/segment/create-segments/rfm-segments)）で分析できます。デフォルトでは、上記の分析ではすべてのユーザーが分析対象となります。特定のカスタムセグメントのユーザーを分析するには、カスタムセグメントのドロップダウンから目的のカスタムセグメントを選択し、各分析に必要なその他のパラメーターを指定して、**Apply** をクリックします。
# All Segments
All Segments ページでは、MoEngage で作成・使用されているすべてのカスタムセグメントを一元的に確認できます。これにより、グロースチームはカスタムセグメントの概要を 1 か所ですばやく把握し、それらに対してアクションを実行できます。また、All Segments ページから各カスタムセグメントの詳細ページに移動することもできます。アカウントで Teams が有効になっている場合は、アクセス権のあるすべてのチーム向けに作成されたカスタムセグメントが表示されます。特定のチーム向けに作成されたカスタムセグメントを表示するには、**All Segments for** ドロップダウンリストでチームを選択します。
このページにはすべてのカスタムセグメントが一覧表示され、カスタムセグメント名、セグメントタイプ（ファイルセグメントまたはフィルターセグメント）、セグメントの作成日時、セグメントの最終実行日時（クエリまたはキャンペーンでセグメントが最後に実行された日時）、およびカスタムセグメントに対して実行できるアクションが表示されます。
カスタムセグメント名をクリックすると、そのセグメントの詳細ページに移動します。
テーブルは任意の列で昇順または降順に並べ替えることができます。デフォルトでは、最終実行日時の降順で並べ替えられています。
検索ボックスに目的のセグメント名を入力して、セグメントを検索できます。
セグメントはセグメントタイプ（ファイルセグメントまたはフィルターセグメント）でフィルタリングすることもできます。
1. **File Segment** - グロースチームがユーザーのリストをアップロードしたときに作成されるカスタムセグメントです。一意のユーザーを識別するユーザー属性のいずれかを含むユーザーリストをインポートすると、それらのユーザーのカスタムセグメントが作成されます。[ファイルセグメントの詳細については、こちらの記事を参照してください](/docs/ja/user-guide/segment/create-segments/file-segments)。
2. **Filter Segment** - MoEngage ダッシュボードから作成されるカスタムセグメントです。グロースチームはルールと条件を作成してユーザーセグメントを定義できます。ルールと条件は、ユーザー属性/プロパティ、イベントとイベントプロパティ、およびその両方の組み合わせに適用できます。[フィルターセグメントの詳細はこちら。](/docs/ja/user-guide/segment/create-segments/rule-based-filter-segments)
**+Segment** をクリックするとパネルが開き、**Create Segment** ページ（フィルターセグメントの作成）、RFM セグメントページ、**Create File Segment** ポップアップ（ファイルセグメントの作成）に移動できます。Teams が有効で、複数のチームに所属している場合は、**+ Segment** をクリックする前に **Teams** ドロップダウンからチームを選択する必要があります。
Segmentation Filters を使用した MoEngage Teams はベータ機能です。アカウントで有効にするには、CSM にお問い合わせください。
## アーカイブ済みセグメント
All Segments ページで Archived Segment トグルをクリックすると、アーカイブ済みセグメントの一覧ページに移動します。
過去 6 か月以内にアーカイブされたフィルターセグメント（最大 1000 件のアーカイブ済みセグメント）がここに一覧表示されます。ここからこれらのセグメントのアーカイブを解除できます。
アーカイブ日から 30 日を超えたファイルセグメントは、有効期限が切れているため、このページには表示されません。[ファイルセグメントの詳細はこちら。](/docs/ja/user-guide/segment/create-segments/file-segments) アーカイブから 30 日以内であれば、このページからファイルセグメントのアーカイブを解除できます。
# カスタムセグメントに対するアクション
| アクション | 説明 |
| - | - |
| View | ファイルセグメントとフィルターセグメントのどちらでも、View をクリックするとそのセグメントの詳細ページに移動します。 |
| Edit | - フィルターセグメントの場合、Edit オプションを選択すると、セグメントのフィルターが事前入力された状態で Create Segments ページが開きます。これらのフィルターを編集し、新しいクエリを新しいカスタムセグメントとして保存できます。
- ファイルセグメントの場合、Edit オプションを使用して、既存のファイルセグメント内のユーザーを追加、削除、または置換できます。[ファイルセグメントの詳細はこちら。](/docs/ja/user-guide/segment/create-segments/file-segments)
|
| Duplicate | - フィルターセグメントの場合、Duplicate オプションを選択すると、セグメントのフィルターが事前入力された状態で Create Segments ページが開きます。これらのフィルターを編集し、新しいクエリを新しいカスタムセグメントとして保存できます。
- ファイルセグメントは複製できません。ファイルセグメントはアップロードされたファイルからの静的なユーザーリストであり、編集可能なルールによって定義されていないためです。セグメントの複製はルールをコピーして変更する場合に便利ですが、ファイルセグメントにはルールがないため、このアクションは適用されません。同じリストを再利用するには、元のセグメントをそのまま使用してください。
|
| Archive | ファイルセグメントとフィルターセグメントはどちらも、セグメントのソースに応じてダッシュボードからアーカイブできます。 |
| Rename | 既存のキャンペーン、分析、ダウンストリームの連携に影響を与えることなく、セグメントの名前を更新します。名前を変更しても、セグメントの一意の ID は変わりません。**早期アクセス:** この機能を有効にするには、MoEngage の CSM またはサポートチームにお問い合わせください。Campaigns、Imports、Locales、Global Control Groups、またはパートナー連携をソースとするセグメントでは使用できません。 |
| Export Users | Export Users を使用すると、そのセグメントに属するユーザー属性を 1 つ以上ダウンロードできます。最新のユーザーリストを取得するには、ユーザーをエクスポートする前にカスタムセグメントを実行してください。Export Users は [Object データ型](/docs/ja/user-guide/data/key-concepts/support-for-object-data-type) の属性（オブジェクトの配列を含む）をサポートしていません。選択した属性が Object の場合、無効または不完全な JSON としてエクスポートされ、確実に解析することはできません。 |
| Create Campaign | Create Campaign アクションを選択すると、セグメントの定義がターゲットオーディエンスに事前入力された状態でキャンペーン作成ページに移動します。 |
| Analyze Segment | Segmentation ページから直接セグメントを分析します。このアクションにより、Behavior、Funnels、Retention、Session and Source、User Paths、RFM 分析のターゲットオーディエンスセクションにセグメントが自動入力されます。 |
## セグメントのソース
すべてのカスタムセグメントは、MoEngage 上のどこで作成されたか、または MoEngage システムにどこからインポートされたかに応じて、次のいずれかのソースに分類されます。
| ソース | 説明 | 利用可能なアクション |
| - | - | - |
| Segmentation | MoEngage Segmentation から作成されたカスタムセグメントは、ソースが Segmentation になります。 | 1. View
2. Edit
3. Duplicate
4. Archive/Unarchive
5. Export Users
6. Create Campaign
7. Analyze Segment |
| CSV Upload, API, Import Users | ファイルセグメントとして MoEngage システムにアップロードされたカスタムセグメントです。ファイルセグメントは複製できません。 | 1. View
2. Edit
3. Rename
4. Archive/Unarchive
5. Export Users
6. Create Campaign
7. Create Campaign
8. Analyze Segment |
| Campaigns, Analyse, Prediction, Campaign Locale, Global Control Group, Custom | Campaigns、Analyze、Predictions など、Segmentation 以外のソースから MoEngage 上で作成されたカスタムセグメントです。これらのセグメントが含まれるキャンペーンや分析に影響を与える可能性があるため、Edit、Duplicate、Archive、Unarchive などの編集アクションは利用できません。 | 1. View
2. Export Users
3. Create Campaign
4. Analyze Segment |
| Cohort Sync, Amplitude, Mixpanel, mParticle, Segment IO | 他のサードパーティまたは外部ソースから MoEngage システムにインポートされたカスタムセグメントです。外部で管理されているため、Edit、Duplicate、Archive、Unarchive などの編集アクションは利用できません。 | 1. View
2. Export Users
3. Create Campaign
4. Analyze Segment |
## セグメントの管理方法
### セグメントの編集
セグメントのフィルターまたはルールを編集するには、次の手順を実行します。
1. **Segment** > **All Segments** に移動します。
2. セグメントを見つけ、**Actions** 列の省略記号アイコンをクリックします。
3. **Edit** を選択します。
* フィルターセグメントの場合、セグメントの現在のフィルターが事前入力された状態で Create Segments ページが開きます。フィルターを更新して **Save** をクリックします。
* ファイルセグメントの場合、ユーザーの追加、削除、置換のいずれかを選択し、更新したファイルをアップロードします。
### セグメントの名前変更
**早期アクセス**
これは早期アクセス機能です。アカウントで有効にするには、MoEngage のカスタマーサクセスマネージャー（CSM）またはサポートチームにお問い合わせください。
既存のワークフロー、履歴データ、ダウンストリームの連携に影響を与えることなく、セグメントの名前を更新できます。セグメントの名前を変更しても、一意のセグメント ID は変わりません。
セグメントの名前を変更するには、次の手順を実行します。
1. **Segment** > **All Segments** に移動し、目的のセグメントの省略記号アイコンをクリックして、**Rename** を選択します。 
2. **Rename custom segment** ウィンドウで、**Segment name** フィールドに新しい名前を入力し、**Save** をクリックします。 
名前を変更する際は、次の点に注意してください。
* セグメントの名前を変更できるのは、Segments で **Create & Manage** 権限を持つユーザーのみです。
* セグメント名は、文字数制限と一意性のチェックに合格する必要があります。アーカイブ済みのセグメントであっても、名前を再利用することはできません。
Campaigns、Imports、Locales、Global Control Groups、Data Science（予測）、またはパートナー連携（Amplitude、Mixpanel、Segment など）をソースとするセグメントの名前は変更できません。
### セグメントのアーカイブとアーカイブ解除
セグメントをアーカイブするには、次の手順を実行します。
1. **Segment** > **All Segments** に移動します。
2. アーカイブするセグメントを検索します。
3. 省略記号アイコンをクリックし、**Archive** を選択します。
アーカイブに関する次の動作に注意してください。
* アーカイブ済みのセグメントは、MoEngage ダッシュボード全体のセグメントドロップダウンに表示されなくなります。
* アーカイブ済みのルールベースセグメントがキャンペーンで使用されている場合、キャンペーンは引き続きそのルールに基づいてセグメントを計算します。アーカイブ済みのファイルセグメントが使用されている場合は、0 ユーザーが返されます。
* 過去 60 日間実行されていないセグメントは自動的にアーカイブされます。
* 継続的なコホート同期やファイル同期は実行としてカウントされないため、外部からインポートされたセグメント（Amplitude からのものなど）は、定期的に同期されていても自動アーカイブされる場合があります。このようなセグメントをアクティブに保つには、ダッシュボードから手動で実行するか、セグメンテーションフィルターで使用してください。
* 外部からインポートされたセグメント（Amplitude やその他の外部ツールからのものなど）は、ダッシュボードからアーカイブまたはアーカイブ解除できません。アーカイブ解除を試みると、"Unarchive is not available for this segment as it is imported from Amplitude." と表示されます。アーカイブを解除するには、[Unarchive Segment API](/docs/ja/api/manage-segments/unarchive-segment) を使用してください。
* アーカイブ済みのファイルセグメントのすべてのユーザーは、アーカイブから 30 日後に削除されます。それ以降、そのセグメントは 0 ユーザーを返します。
* セグメントがアーカイブされていても、セグメント名を再利用することはできません。
セグメントのアーカイブを解除するには、**Segment** > **All Segments** に移動し、**Archived Segments** トグルを有効にして、セグメントを見つけ、**Unarchive** をクリックします。
# セグメントの詳細
All Segments ページでセグメント名をクリックすると、そのセグメントの Segment Details ページに移動します。All Segments > セグメントを選択 > Actions: View からもこのページに移動できます。
Segment Details ページには、セグメントのタイプ、説明、作成日時、ソース、最終実行日時が表示されます。
このページには、カスタムセグメントのユーザー数、到達可能なユーザー数、最終更新日時も表示されます。ここからセグメントを実行して、最新のユーザー数と到達可能なユーザー数を取得することもできます。
カスタムセグメントに対するすべてのアクション（編集、複製、アーカイブ、ユーザーのエクスポート、キャンペーンの作成）は、セグメントタイプとセグメントソースに応じてこのページで利用できます。
グロースチームは、現在 Create Segment ページで利用できるのと同様に、到達可能性とサンプルユーザーの情報を確認することもできます。また、セグメントのタイプに応じて Segment Edit History を確認することもできます。
## 到達可能性とサンプルユーザー
**Reachable Users**
すべてのアウトバウンドチャネル（Push、Email、SMS）における到達可能なユーザー数が表示されます。到達可能なユーザー数は、特定のチャネルごとに個別に確認することもできます。
**Sample users** のイニシャルまたは GU（Guest の略）- これらのバブルをクリックすると、ユーザープロファイルが開きます。
## Segment Edit History
Segment Details ページの Segment Edit History セクションは、選択したセグメントのセグメントタイプに基づいています。
### ファイルセグメントの編集履歴
ファイルセグメントの編集履歴には、Segment Edited on（編集日時）、Operation（ユーザーの追加、削除、置換）、Status of Operation、および処理されたファイルの詳細の列が表示されます。
Status of Operation には次の値があります。
1. Pending: 処理キューに別のファイルがすでにあるため、まだ処理されていないファイルセグメントです。
2. Processing: システムによって現在処理中のファイルセグメントです。
3. Successful: 正常に処理され、属性が更新されたファイルセグメントです。
4. Failed: 処理中に失敗したファイルセグメントです。このステータスにカーソルを合わせると、失敗の理由も確認できます。
処理されたファイルの詳細:
1. Attribute name: ファイルでアップロードされたユーザー属性とそのデータ型を示す列です。
2. Valid attributes: アップロードされたファイル内で正常に処理されたレコードの数を示します。
3. Users resolved: ファイルで指定されたユーザー属性で更新された既存ユーザーの数を示します。これらのユーザーがカスタムセグメントの一部になります。
4. Invalid attributes: ファイル内で処理中に失敗したレコードの数を示します。
デフォルトでは、このテーブルは「Segment edited on」列で並べ替えられ、最新の編集が最初に表示されます。ファイルセグメントの編集履歴では、直近 20 件の編集を確認できます。
### フィルターセグメントの編集履歴
フィルターセグメントの編集履歴には、Segment edited on（編集日時）、Segment description、Option（Use this version）の列が表示されます。
セグメントの古いバージョンで **Use this version** をクリックすると、現在のセグメント定義を選択したバージョンに更新できます。セグメント数を更新して、編集したセグメントの最新のユーザー数と到達可能性を取得してください。
デフォルトでは、このテーブルは「Segment edited on」列で並べ替えられ、最新の編集が最初に表示されます。フィルターセグメントの編集履歴では、直近 20 件の編集を確認できます。
### セグメント名の変更
**早期アクセス** \
これは早期アクセス機能です。アカウントで有効にするには、MoEngage のカスタマーサクセスマネージャー（CSM）またはサポートチームにお問い合わせください。
セグメントの名前が変更されると、Segment Detail ページの動的ヘッダーが自動的に更新されます。さらに、Segment Edit History テーブルにもこの変更が反映されます。 
* 以前の名前は取り消し線付きで新しい名前の前に表示されます（例: Name : ~~Custom Segment 1~~ -> Custom Segment 2）
* この行に対してユーザーはアクションを実行できません。
* セグメントのすべての履歴バージョンは静的テキストとして保存され、イベント名やセグメント名が変更されても変わりません。
* Segment Edit History の **Updated By** 列には、セグメントを変更したユーザーが次の条件で記録されます。
* **フィルターベースのセグメント**: 以降のすべての編集を追跡しますが、最初の作成は追跡しません。
* **ファイルベースのセグメント**: セグメントの名前が変更された場合のみ追跡します。最初の作成や一般的なファイルの更新は追跡しません。
## 同期されたセグメント
MoEngage で作成した顧客セグメントを、技術スタック内の他のプラットフォームに同期して送信できます。詳細については、[Outbound Segment Sync](/docs/ja/user-guide/data/exports/segments/outbound-segment-sync) を参照してください。
## トラブルシューティング
カスタムセグメントのユーザー数がアップロードしたファイル内のユーザー数より少ない場合、一般的な理由は 2 つあります。
* **ファイル内のユーザー ID の重複:** MoEngage は重複を無視します。一意のユーザー ID はそれぞれ 1 回だけカウントされます。
* **まだ MoEngage に存在しないユーザー:** ファイルセグメントには、MoEngage にすでに存在するユーザーのみを含めることができます。アップロードされたユーザー ID が既存のプロファイルと一致しない場合、そのユーザーはセグメントから除外されます。
詳細については、[CSV を使用したユーザーデータのインポート](/docs/ja/user-guide/data/imports/manual-uploads) を参照してください。
カスタム属性で利用できるフィルターは、MoEngage がその属性について受信するデータ型によって異なります。日付属性で日付ベースのフィルター（"before"、"after"、"between" など）が利用できない場合、その属性は datetime ではなく文字列として受信されている可能性があります。
これは通常、次の場合に発生します。
* 属性は当初 datetime として設定されていたが、後でアプリが文字列として送信し始めた。
* 同じ属性が異なるソースから異なるデータ型で送信されている。
これを解決するには、すべてのソースが同じ正しいデータ型で属性を送信するようにしてください。送信されているデータ型を確認するには、開発チームにお問い合わせください。
MoEngage は、システム全体で参照を追跡・管理するための一意の識別子としてセグメント名を使用します。データの整合性を保護するため、元のセグメントがアーカイブされてダッシュボードに表示されなくなった場合でも、セグメント名を再利用することはできません。
これを解決するには、新しいセグメントに別の名前を使用してください。