セグメント

セグメントは、共通の属性を持つユーザーをグループ化するフィルターの集合です。セグメントを使うと、ペイウォールや A/B テストのターゲティングをより効果的に行えます。

イベントフィードのイベントはダッシュボードに届くまでに遅延が発生します。新しいプロファイルや属性の変更はすぐに反映されない場合があります。

セグメントを作成したら、プレースメントや A/B テストでオーディエンスとして使用し、ユーザーに表示するペイウォール（単数または複数）を制御できます。使用例：

非サブスクリプションユーザーには標準のペイウォールを表示し、以前サブスクリプションやトライアルをキャンセルしたユーザーには割引を提示する。
国ごとに異なるペイウォールを表示する。
Apple Search Ads のアトリビューションデータに基づいてユーザーをターゲティングする。
古いバージョンのアプリを使用しているユーザーには既存のペイウォールを表示し続け、新しいバージョンのユーザーには更新されたペイウォールを表示する。
アナリティクスでは、セグメントでフィルタリングして特定のユーザーグループのパフォーマンスを確認する。セグメントでグループ化すると、全ユーザー内でのパフォーマンスや貢献度を比較できる。

作成

セグメントを作成するには、名前を入力し、フィルターを定義する属性を選択します。複数の属性を選択した場合、ユーザーはすべての条件を満たす必要があります。Adapty は属性間に AND 論理を適用します。

利用可能な属性

Country（国）や Calculated total revenue USD（計算済み合計収益 USD）など多くのユーザー属性は自動的に設定されますが、Age（年齢）、App user ID（アプリユーザー ID）、Attribution（アトリビューション）データ、Gender（性別）、Custom attributes（カスタム属性）は自動的には設定されません。セグメント化に利用する場合は、ユーザー属性を設定するか、アトリビューションデータを渡す必要があります。

日付ベースの属性には、以下の方法でフィルタリングできます：

固定日付: カレンダーから特定の日付を選択（例：ブラックフライデーからサイバーマンデーの間にインストールしたユーザーに特別オファーを表示）
相対範囲: 「過去 7 日間」や「過去 3 ヶ月」などの動的な期間を設定（例：30 日以上前に最後に見られたユーザーを再エンゲージしたり、最近のインストールをターゲティングしたりする）

相対範囲は自動的に更新されるため、継続的なキャンペーンに最適です。固定日付は期間限定のプロモーションに最も適しています。

属性	フィルター対象
Age	ユーザーの年齢。年齢は Adapty が最初に受け取った時点で計算され、その後は更新されません。
App User ID	アプリ内のユーザー識別子（customer_user_id）。存在するかどうかでフィルタリングできます。例えば、ログインしていないユーザーにのみペイウォールを表示する場合などに使います。
App version (current)	Adapty が最後にイベントデータを受け取ったユーザーデバイスにインストールされているアプリの現在のバージョン。ユーザーがアップグレードすると更新され、常に現在実行中のバージョンを反映します。特定のバージョンを実行しているすべてのユーザー（以前のバージョンからアップグレードしたユーザーを含む）にロールアウトする場合に使用します。セグメント作成時に、App version の横にある鉛筆アイコンを選択して新しいバージョンを追加すると、すぐに使用できます。 version > X.X 条件を使うと、各バージョンを個別にリストアップすることなく、特定のバージョンより古いまたは新しいすべてのアプリバージョンのコンバージョンへの影響を計測できます。フォーマット：バージョン文字列は SemVer 形式に従う必要があります。各部分の先頭ゼロは無効です。`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 形式に従う必要があります。各部分の先頭ゼロは無効です。`26.3.04` はマッチしませんが、`26.3.4` はマッチします。無効なバージョンはセグメントから黙って除外されます。
Attribution: Ad Group	アトリビューションの広告グループ。
Attribution: Ad Set	アトリビューションの広告セット。
Attribution: Campaign	マーケティングキャンペーン名。
Attribution: Creative	アトリビューションのクリエイティブキーワード。
Attribution: Channel	マーケティングチャネル名。
Attribution: Source	アトリビューションの発生元。
Attribution: Status	アトリビューションのステータス。設定可能な値： Organic – 有料マーケティングの影響を受けずにアプリをインストールしたユーザー（App Store/Google Play での直接検索、口コミ、オーガニックソーシャルメディアなど）。 Non-organic – 有料マーケティングチャネル経由で獲得したユーザー（広告、インフルエンサーキャンペーン、リファラルプログラムなど）。 Unknown – このユーザーのアトリビューションデータが利用できない。
Calculated 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	アプリやビジネスに固有のプ��ロパティに基づいて、高度にターゲティングされたセグメントを作成するための独自属性を定義します。

カスタム属性

カスタム属性を定義して、アプリやビジネスに固有のプロパティに基づいたより精度の高いセグメントを構築できます。

カスタム属性は SDK または Adapty ダッシュボードで設定できます。SDK での設定手順はこちらをご覧ください。
セグメントで使用後にカスタム属性を変更すると、アナリティクスでそのセグメントとユーザーの同期が外れる場合があります。データは以前の値を反映します。

カスタム属性の設定方法

Adapty ダッシュボードで、属性のドロップダウンメニューから Create custom attributes を選択します。

883d3b2-CleanShot_2023-03-16_at_17.20.452x.webp

フィールド	説明
Name	カスタム属性のラベル。Adapty ダッシュボード内でのみ使用されます。
Key	属性の一意の識別子。SDK で使用されるキーと一致している必要があります。
Type	以下から選択します： String：あらかじめ定義した値のリストが必要です。 Number：数値のみ受け付けます。
Values	`String` を選択した場合は、使用可能な値のリストを入力します。`Number` を選択した場合、属性は数値入力のみ受け付けます。数値属性は小数値をサポートし、比較演算子と組み合わせて使用できます。

必須フィールドを入力したら、セグメント、A/B テストなどでカスタム属性を使用できます。

各プロファイルには最大 30 個のカスタム属性を設定できます。

総数とランダムサンプル

セグメントを作成すると、Adapty はセグメント条件に一致するユーザーの総数を表示します。

また、条件に合致する 40 人のランダムサンプルも表示されます。これを使ってセグメントをテストし、正しく設定されているか確認できます。

セグメントの複製

既存のセグメントに似たものが必要な場合は、最初から作り直す代わりに複製しましょう。ユーザーグループが重複する複数のキャンペーンや A/B テストを運用しているチームの作業時間を節約できます。

セグメントを複製すると、すべてのフィルターと説明を含むコピーが作成されます。新しいセグメントの名前には「(copy)」が追加されるので、元のものと区別できます。新しいセグメントは元のセグメントから独立しており、一方への変更は他方に影響しません。

Adapty ダッシュボードでセグメントを複製するには：

Adapty メインメニューの Profiles & Segments セクションを開き、Segments タブに切り替えます。
セグメントの横にある 3-dot ボタンをクリックし、Duplicate を選択します。

新しいセグメントを開き、必要に応じてフィルターを調整します。

セグメントの削除

セグメントが不要になったら、完全に削除できます。

以下のいずれかでセグメントが現在オーディエンスとして使用されている場合、Adapty は削除をブロックします：

プレースメント：削除されていないプレースメントの少なくとも 1 つがそのセグメントをオーディエンスとして使用している。
A/B テスト（ライブまたは完了済み）：削除されていない A/B テストの少なくとも 1 つがそのセグメントをオーディエンスとして使用している。

セグメントの削除において、Adapty はライブと完了済みの A/B テストをどちらもアクティブとして扱います。完了済みのテストは、テスト後のペイウォールまたはオンボーディングを一致するユーザーに表示するために引き続きオーディエンスを使用しており、テストの過去の指標はそのセグメントにスコープされています。セグメントは A/B テスト自体が削除されて初めて解放されます。

セグメントの削除は永続的です。削除されたセグメントは復元できません。

Adapty ダッシュボードでセグメントを削除するには：

Adapty メインメニューの Profiles & Segments に移動し、Segments タブに切り替えます。
セグメントの横にある 3-dot ボタンをクリックし、Delete を選択します。
確認フィールドにセグメント名を入力し、Delete forever をクリックします。

セグメントが使用中の場合、ダイアログにはそれを参照しているプレースメントと A/B テストの一覧が表示されます。

削除のブロックを解除するには、リストの各プレースメントまたは A/B テストを開き、オーディエンスからセグメントを削除するか、プレースメントまたは A/B テスト自体を削除してください。何もセグメントを参照していない状態になれば、削除できます。

アクティブな A/B テストでセグメントが使用されているためブロックされた削除セグメントダイアログ