Adapty Mail のセグメント

セグメントは再利用可能なオーディエンスのスライスです。Segments で一度定義すれば、フローや A/B テストから参照できます。セグメントはスナップショットではなくフィルター定義です。フロートリガーが発火したタイミングで都度評価されるため、メンバーシップは常に最新のプロファイルデータを反映します。

セグメントを作成する

Adapty Mail で Segments に移動し、+ Create をクリックします。作成ページが開き、タイトルに New Segment と表示されます。
セグメントの Name（必須）と任意の Description を入力します。
Filters の下にある Add filter をクリックして、追加したいルールをそれぞれ設定します。各フィルターは Filter 1、Filter 2 のように折りたたみ可能なカードとして表示されます。
各フィルターにフィールド、演算子、比較値を設定します。
セグメントを保存します。

フィルターは AND で組み合わされます。ユーザーがセグメントに含まれるには、すべてのフィルター条件を満たす必要があります。OR ロジックやネストされたグループはサポートされていません。各フィールドはセグメントごとに1回のみ使用できます。同じフィールドを複数の値で比較したい場合は、ロジックを別々のセグメントに分けてください。

Adapty からセグメントをインポートする

フィルターを使ってセグメントを作成する代わりに、Adapty ダッシュボードから既存のオーディエンスセグメントをインポートすることもできます。

Segments ページで Import をクリックします。
一覧を確認します。インポート可能なセグメントはチェックボックスとフィルター条件が表示されます。インポートできないセグメントは、サポートされていないフィールド（例：Apple Ads のアトリビューションデータ）、サポートされていない演算子、Adapty Mail に対応する設定がないサブスクリプション状態といった具体的な理由とともにグレーアウト表示されます。
インポートしたいセグメントにチェックを入れ、Import をクリックします。

インポート可能なセグメントにチェックが入り、インポート不可のセグメントが拒否理由付きでグレーアウトされたインポートセグメントダイアログ

インポートは、インポート時点でのセグメントのフィルター条件の独立したコピーを作成します。元の Adapty セグメントとは同期されず、Adapty Mail は重複を検出しないため、同じセグメントを再度インポートすると別のコピーが作成されます。

インポートされたセグメントは、手動で作成したセグメントと同様に Draft 状態で開始されるため、すぐにフィルターを編集できます。

利用可能なフィルターフィールド

グループ	フィールド	タイプ
プロファイル	メール	String
プロファイル	年齢	Integer
プロファイル	国	String
プロファイル	外部プロファイル ID	String
プロファイル	作成日時	Date
購入状態	総収益（USD）	Decimal
購入状態	サブスクリプション状態	Enum
購入状態	サブスクリプション購入日時	Date
購入状態	サブスクリプション有効期限	Date
購入状態	買い切り購入状態	Enum
購入状態	買い切り購入日時	Date
サブスクリプション状態の値: Never purchased、Subscribed、Auto-renew off、Billing issue、Grace period、Expired、Refunded。

買い切り購入の状態の値: Never purchased、Purchased、Refunded。

フィールドの種類ごとに使用できる演算子:

String（文字列）: equals、not equals、is set、is not set。
Number（数値）: equals、not equals、less than、greater than、less than or equal、greater than or equal、between、is set、is not set。
Date（日付）: equals、not equals、before、after、on or before、on or after、between、is set、is not set。

All Usersシステムセグメント

Adapty Mailには、フィルターのないビルトインのAll Usersセグメントが用意されています。プロジェクト内のすべてのユーザーが対象となります。このセグメントは編集・削除できません。フローで使用する場合は、最下位の受け皿として機能します（優先順位のルールについてはフローを参照してください）。

ライフサイクル

セグメントの状態は、その使われ方によって決まります。

Draft：作成済みだが、フローやA/B テストにはまだ紐付けられていない。
Live：アクティブなフローまたはA/B テストに紐付けられている。
Inactive：以前は紐付けられていたが、A/B テストが終了したかフローの行が削除された。
Archived：ソフト削除され、メインリストから非表示になっている。

セグメントページのツールバーには状態フィルターがあり、これらの状態で絞り込むことができます。

セグメントの編集と削除

名前と説明: 常に編集可能です。
下書きセグメントのフィルター: 完全に編集可能です。
ライブセグメントのフィルター: ロックされています。セグメントがアクティブなフロー行またはA/B テストで参照されると、フィルターは読み取り専用になります。名前の変更や説明の更新のみ可能です。ターゲティングを変更するには、新しいセグメントを作成してフロー行を入れ替えてください。
削除: セグメントを論理削除します。ライブセグメントは削除できません。先にフローから削除する（またはA/B テストを終了する）必要があります。

制限事項

OR ロジックとネストは不可: フィルターは AND のみで組み合わせられます。
セグメントごとに1つのフィールド: 同じフィールドに対して2つのフィルターを設定することはできません（例：2つの国チェック）。
サイズプレビューなし: エディターでは、現在フィルターに一致するユーザー数は表示されません。
公開後はフィルターをロック: アクティブなセグメントは、名前と説明を除いて読み取り専用になります。