> ## 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 でセグメントクエリを名前付きのカスタムセグメントとして保存し、毎回作り直すことなくキャンペーン、Flows、分析で再利用できます。

カスタムセグメントを使用すると、ユーザーセグメントのクエリを保存し、使いやすいようにクエリに名前を付けることができます。これにより、クエリ全体を入力してセグメントを再作成する代わりに、このカスタムセグメントを MoEngage ダッシュボードの複数のページで使用できます。

# カスタムセグメントの作成

MoEngage では、カスタムセグメントを次の 3 つの方法で作成できます。

### Segment ページから作成する

カスタムセグメントを作成するには、次の手順を実行します。

1. MoEngage のサイドバーメニューで、**Segment** メニュー項目 <img alt="Screenshot 2025-06-16 at 3.25.14 PM.png" src="https://mintcdn.com/moengage/0iWkm50wROjmHH3Z/images/moengage_d125fa.png?fit=max&auto=format&n=0iWkm50wROjmHH3Z&q=85&s=01b32d8b5ff6a1f034cf22a5e51355e6" width="74" height="70" data-path="images/moengage_d125fa.png" /> にカーソルを合わせます。**Segment** メニューが表示されます。
2. **+ New Segment** をクリックします。
   <img alt="Screenshot 2025-06-13 at 2.52.15 PM.png" src="https://mintcdn.com/moengage/vl5cQuPaKeqblz8O/images/moengage_8fb993.png?fit=max&auto=format&n=vl5cQuPaKeqblz8O&q=85&s=f5c8b56ab5f72acd98599a47bbdea553" width="546" height="392" data-path="images/moengage_8fb993.png" />
   **Create segment** ページが表示されます。
3. クエリを入力して目的のフィルターを選択したら、**+ Actions** ボタンをクリックして **Create Custom Segment** を選択します。

   <img alt="Screenshot 2025-06-17 at 12.35.11 PM.png" src="https://mintcdn.com/moengage/-X0av6ek9AEOUtsy/images/moengage_c8af99.png?fit=max&auto=format&n=-X0av6ek9AEOUtsy&q=85&s=05f7e2783f0cc5c179b0ca408eb91b5a" width="3162" height="984" data-path="images/moengage_c8af99.png" />

   または\
   **Query results** セクションで、選択したクエリに対して **Create Custom Segment** を選択することもできます。

   <img alt="2025-06-17_12-41-11.png" src="https://mintcdn.com/moengage/geRh9DNA2GhPhrjA/images/moengage_f2fa11.png?fit=max&auto=format&n=geRh9DNA2GhPhrjA&q=85&s=761cec720f18aaca8ad5a01d6284f329" width="3170" height="1582" data-path="images/moengage_f2fa11.png" />

   **Create a custom segment** ダイアログボックスが表示されます。
4. **Segment name** ボックスに、カスタムセグメントの名前を入力します。
   <img alt="Screenshot 2025-06-17 at 12.37.55 PM.png" src="https://mintcdn.com/moengage/DUgG020WbtkVK2Ls/images/moengage_31e7f2.png?fit=max&auto=format&n=DUgG020WbtkVK2Ls&q=85&s=af1dec251a0c2b2ae3fae4f3d1911919" width="1380" height="654" data-path="images/moengage_31e7f2.png" />
5. **Create** をクリックします。

### ユーザーのインポート時に作成する

カスタムセグメントは、ユーザーのインポート時に作成できます。セグメント内のユーザーは固定されるため、これは静的カスタムセグメントになります。詳細については[こちら](/docs/ja/user-guide/data/imports/manual-uploads)をクリックしてください。

### MoEngage Analytics から作成する

カスタムセグメントは、Behaviour 分析、Funnel 分析、RFM Segments から作成することもできます。これらのセクションでは動的カスタムセグメントが作成されます。[詳細はこちらをクリックしてください](/docs/ja/user-guide/segment/create-segments/rfm-segments)。

# カスタムセグメントの使用

MoEngage ダッシュボードでは、カスタムセグメントをさまざまな方法で使用できます。

* カスタムセグメントを利用して、複雑なユーザーセグメントを作成できます。カスタムセグメントは、ユーザープロパティやユーザーアクティビティとともにユーザーセグメントの作成に使用できます。
* カスタムセグメントは他のカスタムセグメントの作成時に使用できるため、カスタムセグメントの複雑なネストが可能です。カスタムセグメントには最大 6 レベルの再帰/ネストを設定できます。つまり、カスタムセグメント A の定義にセグメント B を含め、そのセグメント B にセグメント C を含める、といった形です。[File Segments](/docs/ja/user-guide/segment/create-segments/file-segments) はネストの上限にカウントされません。
* 新しいカスタムセグメントを作成/定義する際、既存のカスタムセグメントを最大 10 個まで新しいカスタムセグメントで使用できます。[File Segments](/docs/ja/user-guide/segment/create-segments/file-segments) はこの上限にカウントされません。
* カスタムセグメントは、Push、Email、SMS、In-App、Facebook、Flows などのさまざまなチャネル向けのキャンペーンを作成する際に、ターゲットオーディエンスの作成に使用できます。

### カスタムセグメント分析

カスタムセグメントのユーザーは、MoEngage Analytics のページ（[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」ボタンをクリックします。これにより、該当するカスタムセグメントについて目的の分析結果が得られます。

<img alt="Custom_segment_analysis.gif" src="https://mintcdn.com/moengage/B1ZqBU-ISgaoSx_O/images/moengage_5465a7.png?s=e3dc110ca85eac251e149652d9b308e0" width="1266" height="597" data-path="images/moengage_5465a7.png" />

# セグメントのアーカイブ

セグメントをアーカイブするには、次の手順を実行します。

1. MoEngage のサイドバーメニューで、**Segment** メニュー項目 <img alt="Screenshot 2025-06-16 at 3.25.14 PM.png" src="https://mintcdn.com/moengage/0iWkm50wROjmHH3Z/images/moengage_d125fa.png?fit=max&auto=format&n=0iWkm50wROjmHH3Z&q=85&s=01b32d8b5ff6a1f034cf22a5e51355e6" width="74" height="70" data-path="images/moengage_d125fa.png" />  にカーソルを合わせます。**Segment** メニューが表示されます。
2. **All Segments** をクリックします。
   <img alt="Screenshot 2025-06-23 at 2.11.56 PM.png" src="https://mintcdn.com/moengage/o0kXRAcOq2mxzDnY/images/moengage_ef53fc.png?fit=max&auto=format&n=o0kXRAcOq2mxzDnY&q=85&s=44f4de3227ef2eb8a91c57cd1c5a644c" width="534" height="778" data-path="images/moengage_ef53fc.png" />
   **All Segments** ページが表示されます。
3. **Search custom segment** ボックスに、アーカイブするカスタムセグメントの名前を入力します。
4. 選択したカスタムセグメントについて、省略記号をクリックして **Archive** を選択します。 <img alt="Custom_segment_archive.png" src="https://mintcdn.com/moengage/jnaevUpPOwD04mEl/images/moengage_80ee69.png?fit=max&auto=format&n=jnaevUpPOwD04mEl&q=85&s=75748ff5c4d31c6df13e072a4fc35cf1" width="2879" height="1234" data-path="images/moengage_80ee69.png" />

カスタムセグメントについて:

* アーカイブされたカスタムセグメントは、MoEngage ダッシュボードのカスタムセグメントのドロップダウンには表示されません。アーカイブされた [Rule/Filter-based Segment](/docs/ja/user-guide/segment/getting-started/types-of-segments) がキャンペーンで使用されている場合、セグメントはルール/フィルターに基づいて計算されます。アーカイブされた [File Segment](/docs/ja/user-guide/segment/create-segments/file-segments) がキャンペーンで使用されている場合、セグメントは 0 ユーザーを返します。
* 過去 60 日間に実行されていない（クエリが実行されていない）カスタムセグメントは、自動的にアーカイブされます。
* アーカイブされた [File Custom Segment](/docs/ja/user-guide/segment/create-segments/file-segments) のすべてのユーザーは、アーカイブから 30 日後に削除されます。そのため、アーカイブから 30 日が経過すると、アーカイブされたカスタムセグメントは 0 ユーザーを返します。
* [Custom File segment API](/docs/ja/api/file-segments/create-file-segment) を使用して、ファイルカスタムセグメントに有効期限を設定できます。有効期限が過ぎると、カスタムセグメントの既存ユーザーはすべて削除され、カスタムセグメントはアーカイブされます。
* 一方のセグメントがアーカイブされている場合でも、カスタムセグメントに同じ名前を付けることはできません。
* `All Users` は MoEngage で予約されているため、カスタムセグメント名として使用できません。
* カスタムセグメント名には `:` `|` `*` `?` `\` `<` `>` `=` `$` `"` の文字を含めることはできず、ピリオド（.）で始めること、空白のみで構成すること、200 文字を超えることもできません。これらのルールは名前にのみ適用され、アップロードされたファイル内の値には適用されません。
* 無効な名前または予約済みの名前を持つセグメントは拒否されます。API または外部インテグレーションを通じてセグメントが作成された場合、拒否が通知されないことがあります。その場合、セグメントはカスタムセグメントのドロップダウンに表示されないか、0 ユーザーと表示されます。

<img alt="CS_unarchive.png" src="https://mintcdn.com/moengage/iCae3l_a7eOJMTbz/images/moengage_209a80.png?fit=max&auto=format&n=iCae3l_a7eOJMTbz&q=85&s=12ab69a719c582776ad0386ee3301493" width="2880" height="1256" data-path="images/moengage_209a80.png" />

# よくある質問

<Accordion title="カスタムセグメントの数がインポートしたユーザー数より少ないのはなぜですか？">
  ### 問題

  **Import users** 機能を使用してユーザーのセットをアップロードすると、対応するカスタムセグメントの数がアップロードしたユーザーの総数より少ないことがあります。

  ### 説明

  この不一致は通常、次の理由によって発生します。

  * **ファイル内の重複ユーザー:** アップロードしたファイルに重複するユーザー ID がある場合、MoEngage はこれらの重複を拒否または無視します。その結果、ダッシュボード上のユーザーの総数は、アップロードしたユーザー数より少なくなります。
  * **ユーザーがダッシュボードに存在しない:** このシナリオは、**Import users** を使用して既存ユーザーを更新しようとした場合に発生します。アップロードしようとした一部のユーザーがカスタムセグメントに含まれていない場合は、Create segment ページでそれらのユーザーを検索してください。見つからない場合、それらのユーザーはまだダッシュボードに存在していません。

  詳細については、[Import User Data Using CSV](/docs/ja/user-guide/data/imports/manual-uploads) と [Custom Segments](/docs/ja/user-guide/segment/create-segments/manage-segments) をお読みください。

  <img alt="user_import_final.gif" src="https://mintcdn.com/moengage/Deli0Qwc2s7oDHRm/images/moengage_96b7c4.png?s=23bcf689bbbe85e3e4d9e8d0349d46c0" width="1661" height="1080" data-path="images/moengage_96b7c4.png" />
</Accordion>

<Accordion title="セグメンテーションでカスタム属性の日付範囲フィルターが失敗することがあるのはなぜですか？">
  ### 問題

  カスタム属性のデータ型が自動的に変更され、セグメンテーション時に利用できるフィルターが変わってしまいます。

  たとえば、カスタム属性 **Subscription Date** が **datetime** データ型で取り込まれている場合、**before**、**after**、**between** などの日付ベースのフィルターが利用できるはずです。しかし、**datetime** データ型が **string** に変わることがあります。その結果、日付フィルターの代わりに **does not contain**、**contains**、**is empty**、**not empty** などの文字列ベースのフィルターが表示されます。

  ### 解決策

  次の手順を実行します。

  1. **カスタム属性のデータ型を確認する**: データ型が **datetime** ではなく誤って **string** に設定されていないか確認します。その場合は、日付範囲に基づくセグメントの作成時に問題が発生しないよう、**datetime** に変更します。
  2. **管理者に問題を報告する**: 同じ属性に対して複数のデータ型が取り込まれていることを管理者に伝えます。正しいデータ型（datetime）を固定するよう依頼します。
  3. **新しいカスタム属性を作成する**: 日付の値をトラッキングするために、既存の属性と似た名前で新しい属性を作成します。
  4. **正しいデータ型で値をインポートする**: 新しい属性のデータをインポートする際は、datetime データ型が使用されていることを確認します。

  <Info>
    新しい属性を作成し、正しいデータ型を使用して日付の値をインポートすると、カスタム属性に基づいて日付範囲内のセグメントを作成できるようになります。
  </Info>
</Accordion>

<Accordion title="「Custom Segment Name Already Taken」エラーが発生するのはなぜですか？">
  ### 問題

  カスタムセグメントの作成中に、次のエラーが発生します。

  The custom segment name that you have provided is already in use by some other team. Please use a different custom segment name.

  ### 解決策

  次の手順を実行します。

  * カスタムセグメントがアーカイブ済みリストにあるかどうかを確認します
  * セグメントがアーカイブされてから 180 日を超えているかどうかを確認します。
  * 過去 60 日間に実行されていない（クエリが実行されていない）カスタムセグメントは、自動的にアーカイブされます。
  * 一方がアーカイブされている場合でも、カスタムセグメントに同じ名前を付けることはできません。

  <Info>
    セグメンテーションのバックエンドはセグメントの参照を保持しており、元のセグメントがアーカイブされてダッシュボードに表示されていない場合でも、同じ名前のセグメントの作成を防止します。
  </Info>
</Accordion>


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