--- title: "セグメント" description: "Adapty でユーザーセグメントを作成・管理して、より精度の高いターゲティングを実現しましょう。" --- **セグメント**は、共通の属性を持つユーザーをグループ化するフィルターの集合です。セグメントを使うと、ペイウォールや A/B テストのターゲティングをより効果的に行えます。 --- no_index: true --- import Callout from '../../../components/Callout.astro'; :::note イベントフィードのイベントはダッシュボードに届くまでに遅延が発生します。新しいプロファイルや属性の変更はすぐに反映されない場合があります。 ::: セグメントを作成したら、[プレースメントや A/B テストで**オーディエンス**として使用](audience)し、ユーザーに表示するペイウォール（単数または複数）を制御できます。使用例： - 非サブスクリプションユーザーには標準のペイウォールを表示し、以前サブスクリプションやトライアルをキャンセルしたユーザーには割引を提示する。 - 国ごとに異なるペイウォールを表示する。 - Apple Search Ads のアトリビューションデータに基づいてユーザーをターゲティングする。 - 古いバージョンのアプリを使用しているユーザーには既存のペイウォールを表示し続け、新しいバージョンのユーザーには更新されたペイウォールを表示する。 - [アナリティクス](controls-filters-grouping-compare-proceeds#filter-and-group-data)では、セグメントでフィルタリングして特定のユーザーグループのパフォーマンスを確認する。セグメントでグループ化すると、**全ユーザー**内でのパフォーマンスや貢献度を比較できる。 ## 作成 \{#creation\} セグメントを作成するには、名前を入力し、フィルターを定義する属性を選択します。複数の属性を選択した場合、ユーザーはすべての条件を満たす必要があります。Adapty は属性間に AND 論理を適用します。 ## 利用可能な属性 \{#available-attributes\} :::note **Country**（国）や **Calculated total revenue USD**（計算済み合計収益 USD）など多くのユーザー属性は自動的に設定されますが、**Age**（年齢）、**App user ID**（アプリユーザー ID）、**Attribution**（アトリビューション）データ、**Gender**（性別）、**Custom attributes**（カスタム属性）は自動的には設定されません。セグメント化に利用する場合は、[ユーザー属性を設定](setting-user-attributes)するか、[アトリビューションデータを渡す](attribution-integration)必要があります。 ::: :::tip 日付ベースの属性には、以下の方法でフィルタリングできます： - **固定日付**: カレンダーから特定の日付を選択（例：ブラックフライデーからサイバーマンデーの間にインストールしたユーザーに特別オファーを表示） - **相対範囲**: 「過去 7 日間」や「過去 3 ヶ月」などの動的な期間を設定（例：30 日以上前に最後に見られたユーザーを再エンゲージしたり、最近のインストールをターゲティングしたりする） 相対範囲は自動的に更新されるため、継続的なキャンペーンに最適です。固定日付は期間限定のプロモーションに最も適しています。 ::: | 属性 | フィルター対象 | |---------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Age** | ユーザーの年齢。年齢は Adapty が最初に受け取った時点で計算され、その後は更新されません。 | | **App User ID** | アプリ内のユーザー識別子（[customer_user_id](profiles-crm#user-attributes)）。存在するかどうかでフィルタリングできます。例えば、ログインしていないユーザーにのみペイウォールを表示する場合などに使います。 | | **App version (current)** | Adapty が最後にイベントデータを受け取ったユーザーデバイスにインストールされているアプリの現在のバージョン。ユーザーがアップグレードすると**更新され**、常に現在実行中のバージョンを反映します。特定のバージョンを実行しているすべてのユーザー（以前のバージョンからアップグレードしたユーザーを含む）にロールアウトする場合に使用します。セグメント作成時に、**App version** の横にある鉛筆アイコンを選択して新しいバージョンを追加すると、すぐに使用できます。
**version > X.X** 条件を使うと、各バージョンを個別にリストアップすることなく、特定のバージョンより古いまたは新しいすべてのアプリバージョンのコンバージョンへの影響を計測できます。

**フォーマット：** バージョン文字列は [SemVer](https://semver.org/) 形式に従う必要があります。各部分の先頭ゼロは無効です。`26.03.4` はマッチしませんが、`26.3.4` はマッチします。無効なバージョンはセグメントから黙って除外されます。 | | **App version (on install)** | Adapty が初めてイベントデータを受け取ったときにユーザーデバイスにインストールされていたアプリのバージョン。インストール時の値に**固定され、ユーザーがアップグレードしても更新されません**。現在のバージョンではなく、最初にインストールしたバージョンでユーザーをターゲティングする場合に使用します。`App version (on install) = 1.5.7` は、初回インストールが 1.5.7 だったユーザーのみにマッチし、以前のバージョンから 1.5.7 にアップグレードしたユーザーは黙って除外されます。アップグレードユーザーも対象にするには、**App version (current)** を使用してください。

**フォーマット：** バージョン文字列は [SemVer](https://semver.org/) 形式に従う必要があります。各部分の先頭ゼロは無効です。`26.3.04` はマッチしませんが、`26.3.4` はマッチします。無効なバージョンはセグメントから黙って除外されます。 | | **Attribution: Ad Group** | アトリビューションの広告グループ。 | | **Attribution: Ad Set** | アトリビューションの広告セット。 | | **Attribution: Campaign** | マーケティングキャンペーン名。 | | **Attribution: Creative** | アトリビューションのクリエイティブキーワード。 | | **Attribution: Channel** | マーケティングチャネル名。 | | **Attribution: Source** | アトリビューションの発生元。 | | **Attribution: Status** | アトリビューションのステータス。設定可能な値： | | **Calculated subscription state** | ユーザーの[現在のサブスクリプション状態](profiles-crm#subscription-state)。サブスクリプションがアクティブか、キャンセル済みか、または未解決の請求問題があるかを示します。 | | **Calculated total revenue USD** | このユーザーが生み出した合計収益。 | | **Country** | 直近の IP アドレスから判定された顧客の国。Adapty は IP シグナルを最大週 1 回更新するため、ユーザーが場所を変えたり VPN を使用したりすると値がずれる場合があります。ユーザーの App Store / Play Store アカウントの国でターゲティングする場合は、**Country from store account** を使用してください。 | | **Country from store account** | ユーザーの iOS または Android ストアアカウントに関連付けられた国。Adapty がストアの国を収集するのは、バージョン 13 以降の iOS デバイスのみです。 | | **Creation date** | プロファイルが作成された日付（ユーザーのデバイスにアプリが初めてインストールされた日時）。 | | **Device** | メタデータに基づくデバイスタイプ。例：「Samsung Galaxy」や「iPhone 13」 | | **Gender** | ユーザーの性別。この値は自分で設定します。 | | **Installation date** | ユーザーがアプリをインストールした日付。 | | **Language** | ユーザーのデバイスの言語。Adapty は言語を 2 文字の `ISO 639-1` コードで保存します。`zh-Hant-TW` や `pt-BR` のような拡張ロケールは使用しないでください。ドロップダウンに表示される場合がありますが、どのユーザーにもマッチしません。 言語ターゲティングをさらに絞り込むには、**Language** と **Country** を組み合わせてください。例えば、**簡体字中国語（`zh`）** + **Country = TW, HK, MO** とすると、繁体字スクリプトのユーザーをターゲットにできます。 | | **Last seen** | ユーザーが最後にアプリを開いた日付。 | | **OS** | ユーザーデバイスのオペレーティングシステムのバージョン。 | | **Paid access level** | ユーザーに付与されているアクセスレベル。 | | **Platform** | ユーザーのデバイスプラットフォーム。設定可能な値：`iOS`、`macOS`、`iPadOS`、`visionOS`、`Android`。
ユーザーが複数のプラットフォーム（iOS と Android など）からアプリにアクセスする場合、セグメントへの所属はそれぞれのデバイスの最新データを使って各プラットフォームで個別に評価されます。これにより、同じユーザープロファイルでもプラットフォームごとにターゲティングが可能です。 | | **Subscription expiration date** | サブスクリプションの有効期限、またはその有無。永続アクセス購入の場合は `none` と表示され、ユーザーがプロファイルを持っているがトライアル、サブスクリプション、永続アクセス購入のいずれも行っていない場合は空のままです。 | | **Subscription product** | 顧客のアクティブなサブスクリプションの最新プロダクト ID。 | | **[Custom attributes](profiles-crm#custom-attributes)** | アプリやビジネスに固有のプロパティに基づいて、高度にターゲティングされたセグメントを作成するための独自属性を定義します。 | ## カスタム属性 \{#custom-attributes\} カスタム属性を定義して、アプリやビジネスに固有のプロパティに基づいたより精度の高いセグメントを構築できます。 :::note - カスタム属性は SDK または Adapty ダッシュボードで設定できます。SDK での設定手順は[こちら](setting-user-attributes#custom-user-attributes)をご覧ください。 - セグメントで使用後にカスタム属性を変更すると、[アナリティクス](controls-filters-grouping-compare-proceeds#filter-and-group-data)でそのセグメントとユーザーの同期が外れる場合があります。データは以前の値を反映します。 ::: ### カスタム属性の設定方法 \{#how-to-configure-a-custom-attribute\} Adapty ダッシュボードで、属性のドロップダウンメニューから **Create custom attributes** を選択します。 | フィールド | 説明 | | ------ |--------------------------------------------------------------------------------------------------------------------------------------| | **Name** | カスタム属性のラベル。Adapty ダッシュボード内でのみ使用されます。 | | **Key** | 属性の一意の識別子。SDK で使用されるキーと一致している必要があります。 | | **Type** | 以下から選択します： | | **Values** | `String` を選択した場合は、使用可能な値のリストを入力します。`Number` を選択した場合、属性は数値入力のみ受け付けます。数値属性は小数値をサポートし、比較演算子と組み合わせて使用できます。 | 必須フィールドを入力したら、セグメント、[A/B テスト](ab-tests)などでカスタム属性を使用できます。 各プロファイルには最大 30 個のカスタム属性を設定できます。 ## 総数とランダムサンプル \{#total-number-and-random-sample\} セグメントを作成すると、Adapty はセグメント条件に一致するユーザーの総数を表示します。 また、条件に合致する 40 人のランダムサンプルも表示されます。これを使ってセグメントをテストし、正しく設定されているか確認できます。 ## セグメントの複製 \{#duplicate-segments\} 既存のセグメントに似たものが必要な場合は、最初から作り直す代わりに複製しましょう。ユーザーグループが重複する複数のキャンペーンや A/B テストを運用しているチームの作業時間を節約できます。 セグメントを複製すると、すべてのフィルターと説明を含むコピーが作成されます。新しいセグメントの名前には「(copy)」が追加されるので、元のものと区別できます。新しいセグメントは元のセグメントから独立しており、一方への変更は他方に影響しません。 Adapty ダッシュボードでセグメントを複製するには： 1. Adapty メインメニューの **Profiles & Segments** セクションを開き、[**Segments**](https://app.adapty.io/segments) タブに切り替えます。 2. セグメントの横にある **3-dot** ボタンをクリックし、**Duplicate** を選択します。 3. 新しいセグメントを開き、必要に応じてフィルターを調整します。 ## セグメントの削除 \{#delete-segments\} セグメントが不要になったら、完全に削除できます。 以下のいずれかでセグメントが現在オーディエンスとして使用されている場合、Adapty は削除をブロックします： - **プレースメント**：削除されていないプレースメントの少なくとも 1 つがそのセグメントをオーディエンスとして使用している。 - **A/B テスト（ライブまたは完了済み）**：削除されていない A/B テストの少なくとも 1 つがそのセグメントをオーディエンスとして使用している。 セグメントの削除において、Adapty は**ライブ**と**完了済み**の A/B テストをどちらもアクティブとして扱います。完了済みのテストは、テスト後のペイウォールまたはオンボーディングを一致するユーザーに表示するために引き続きオーディエンスを使用しており、テストの過去の指標はそのセグメントにスコープされています。セグメントは A/B テスト自体が削除されて初めて解放されます。 :::warning セグメントの削除は永続的です。削除されたセグメントは復元できません。 ::: Adapty ダッシュボードでセグメントを削除するには： 1. Adapty メインメニューの **Profiles & Segments** に移動し、[**Segments**](https://app.adapty.io/segments) タブに切り替えます。 2. セグメントの横にある **3-dot** ボタンをクリックし、**Delete** を選択します。 3. 確認フィールドにセグメント名を入力し、**Delete forever** をクリックします。 :::info セグメントが使用中の場合、ダイアログにはそれを参照しているプレースメントと A/B テストの一覧が表示されます。 削除のブロックを解除するには、リストの各プレースメントまたは A/B テストを開き、オーディエンスからセグメントを削除するか、プレースメントまたは A/B テスト自体を削除してください。何もセグメントを参照していない状態になれば、削除できます。 :::