セグメントの使い方
セグメント¶
- セグメントは、条件を設定してゲームユーザーを分類する機能です。ゲームユーザーはセグメント機能を通じて分類でき、作成されたセグメントスナップショットはターゲティングキャンペーンを実施するために使用できます。（このガイド文書では、ゲームユーザーをユーザーと呼びます。）
- ゲームSDKを統合することで、デフォルト機能として提供される30以上のプロパティ条件を設定できます。また、クライアントログ送信機能を使用して送信したプロパティを使用してセグメントを作成することもできます。
- ユーザープロパティクライアントログ送信に関する詳細情報は、カスタムユーザープロパティログで確認できます。
セグメントリスト¶
- ゲーム選択を通じてゲームを選択しない場合、許可されているすべてのゲームのセグメントを表示できます。ゲームを選択すると、選択したゲームのセグメントのみを表示できます。
- セグメントは、それを作成したアカウントを通じてのみ削除できます。セグメントを削除しても、そのセグメントを使用している進行中のターゲティングキャンペーンは維持されますが、削除されたセグメントを使用して新しいスナップショットやターゲティングキャンペーンを作成することはできません。
- セグメント番号の左側にあるラジオボタンをクリックし、「新しいセグメントを読み込み、定義する」ボタンをクリックして、セグメントのプロパティ条件セットに新しいプロパティを追加することで新しいセグメントを作成します。
- セグメントタイトルにマウスをホバーすると、作成時に入力されたセグメントの説明が表示されます。タイトルをクリックすると、セグメント詳細ページに移動し、セグメント作成時に設定されたプロパティ条件に関する詳細情報を確認できます。
セグメントの詳細¶
- セグメントが作成されたときに設定された条件は、セグメント詳細ページで確認でき、ターゲティングキャンペーンで使用するためのセグメントスナップショットを作成できます。
セグメントスナップショット¶
- セグメントスナップショットは、セグメントのために設定されたプロパティ条件に基づいて抽出されたユーザーのリストを指します。セグメントスナップショットタブを通じて作成されたセグメントから抽出されたユーザーの数を確認できます。
- セグメントスナップショットのデータは毎時更新されるため、スナップショットが作成されるたびに抽出されるユーザーの数が変わる可能性があります。
- セグメントスナップショットデータは、毎時10分過ぎまでに受信したデータに基づいて集計され、毎時35分過ぎに同期されます。
- 毎時35分過ぎに生成されたスナップショットには、作成時刻の10分過ぎまでのデータが含まれます。
- 例えば、4月6日の午後7時50分に生成されたスナップショットには、同日の午後7時10分までに受信したデータが含まれます。
- 毎時35分前に生成されたスナップショットには、作成時刻の10分過ぎまでのデータが含まれます -1。
- 例えば、4月6日の午後7時25分に生成されたスナップショットには、同日の午後6時10分までに受信したデータが含まれます。
- 毎時35分過ぎに生成されたスナップショットには、作成時刻の10分過ぎまでのデータが含まれます。
- セグメントスナップショットデータは、毎時10分過ぎまでに受信したデータに基づいて集計され、毎時35分過ぎに同期されます。
- 追加のスナップショットを作成したい場合は、[スナップショットを追加]ボタンをクリックすることで可能です。ボタンをクリックした後、タイトルを入力し、[保存]ボタンをクリックしてスナップショットを作成します。新しく作成されたスナップショットは、スナップショットリストで確認できます。
-
ダウンロードオプションでデフォルトオプションを選択すると、playerId、uid、did、およびappIdフィールドから構成されるユーザーリストをダウンロードできます。追加情報を含めるオプションを選択してダウンロードに追加情報を含める場合、デフォルトオプションで提供されるユーザーリストとともに、セグメントが作成されたときに設定されたプロパティ値もダウンロードできます。
- ダウンロード時に「追加情報を含める」オプションを選択して表示されるプロパティフィールドの順序は、セグメント詳細ページに表示されるプロパティの順序と同じです。ただし、クライアントログ転送機能を使用して送信されたカスタムプロパティのプロパティ名に英語や数字以外の文字（例：韓国語、日本語、中国語など）が含まれている場合、それらはcustomInfoProperty1、customInfoProperty2のようなフィールド名で表示されます。
-
ダウンロード機能を使用してユーザーリストをダウンロードし、その後、Analytics BigQuery機能を使用してユーザーの特性データを調べます。Analytics BigQueryに関する詳細情報はAnalytics BigQueryで確認できます。
キャンペーンのターゲティング¶
- 作成されたセグメントとスナップショットを使用して、これらのユーザーにキャンペーンをターゲットできます。キャンペーンのターゲティングに関する詳細情報はターゲティングで確認できます。
セグメントを作成¶
- セグメントを作成するには、セグメントを作成したいゲームを選択し、「作成」ボタンをクリックします。これにより、セグメントを作成できるセグメント作成ページに移動します。
古いバージョンに切り替え¶
- セグメント作成ページで「古いバージョンに切り替え」ボタンをクリックすると、10のプロパティを提供する古いバージョンのセグメントを使用できます。
- 古いバージョンのセグメントに関する詳細情報はセグメント（古いバージョン）で確認できます。
セグメント情報¶
- 対象ゲームを選択: セグメントリストページで選択されたゲームが表示されます。対象ゲームを変更する必要がある場合は、セグメントリストページで変更できます。
- セグメントタイトル（必須）: これはセグメントの名前です。このフィールドに設定されたセグメントタイトルは、セグメントリストに表示されます。
- セグメント説明（必須）: セグメントを説明する文を入力してください。セグメントリストページで各セグメントタイトルにマウスカーソルを合わせると、このフィールドに入力したセグメント説明が表示されます。
ユーザー属性を選択¶
- ユーザー属性は、各ユーザーが持つ特性情報を指します。ユーザー属性を選択し、詳細な条件を設定することで、指定された条件を満たすユーザーを抽出することができます。
プロパティグループを追加¶
- “プロパティグループを追加”ボタンをクリックすると、ユーザープロパティを選択するためのポップアップが表示されます。1つのセグメントには最大5つのプロパティグループを持つことができ、各グループには最大5つのプロパティを持つことができます。
null - デフォルトでSDK統合を通じてチェックできるプロパティのリストは以下の通りです。ただし、SDKのバージョンの違いなどにより、各プロパティのログが収集されない場合、一部のプロパティは選択画面に表示されないことがあります。
| プロパティカテゴリ | プロパティタイプ | プロパティ名 | 説明 |
| ----------------- | ------------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 広告情報 | 数値 | 期間広告視聴開始 | 特定の期間中にユーザーがゲーム内広告の視聴を開始した回数。 |
| | 数値 | 期間広告視聴完了 | 特定の期間中にユーザーがゲーム内広告の視聴を完了した回数。 |
| | 数値 | 総広告視聴開始 | ユーザーが初回アクセス以来、ゲーム内広告の視聴を開始した累計回数。 |
| | 数値 | 広告視聴完了の合計数 | ユーザーが初回アクセス以来、ゲーム内広告を視聴完了した回数の累計。 |
| 購入情報 | 数値 | 期間購入価格 (KRW) | 特定の期間中にユーザーが支払った金額。(KRW) |
| | 数値 | 期間購入価格 (USD) | 特定の期間中にユーザーが支払った金額。(USD) |
| | 数値 | 期間購入回数 | 特定の期間中にユーザーが支払いを行った回数。 |
| | 数値 | 総購入額 (KRW) | ユーザーが初回アクセス以来行った支払いの累計額。(KRW) |
| | 数値 | 総購入額 (USD) | ユーザーが初回アクセス以来行った支払いの累積額です。 |
| | 数値 | 総購入回数 | ユーザーが初回アクセス以来行った支払いの累積回数です。 |
| | 日付 | 初回購入日 | ユーザーが初めて購入を行った日付を指します。 |
| ユーザー情報 | 文字列 | OS | ユーザーのオペレーティングシステム (例: iOS)。 |
| | 文字列 | OS バージョン | ユーザーのオペレーティングシステムのバージョン (例: 13.0.1)。 |
| | 文字列 | ゲストユーザー | ユーザーのゲストユーザーのステータス。 |
| | 文字列 | 国 | ユーザーの国（例：韓国）。 <br> \* ISO 3166-1 alpha-2に基づく2文字の大文字（2バイトの国コード）。 |
| | 文字列 | マーケット | ユーザーがゲームをインストールしたマーケット（例：Google Play）。 |
| | 文字列 | サーバーID | ユーザーのサーバーID（例：グローバル）。 |
| | 文字列 | アプリバージョン | ユーザーが使用しているゲームアプリのバージョン（例：1.6.5）。 |
| | 文字列 | アプリID | ユーザーのアプリID。<br> \* App Centerから発行されたappId値を選択できます。 |
| | 文字列 | 言語 | ユーザーの言語（例：韓国語）。<br> \* ISO 639 alpha-2に基づく2文字の小文字。 |
| | 文字列 | ユーザー分類タイプ | ユーザー分類タイプ（例：Whale）。<br> \* ユーザー分類タイプの詳細情報は[ユーザー分類指標](./game-indicator/user-classification.md/)で確認できます。 |
| | 文字列 | 認証方法 | ゲームにアクセスする際にユーザーが使用する認証方法（例：Facebook）。 |
| | 文字列 | Hiveユーザー制限 | これはユーザーの現在のHive制限状況です。<br> _ 使用制限中 <br> _ 制限解除 <br> \* 制限の履歴はありません。 |
| | 文字列 | 定期的なアトリビューション活動 – メディア、 <br> アトリビューション活動 – メディア | これはユーザーのゲーム内活動とメディア（活動につながった外部チャネルまたは広告ソース）です。 <br> _ アトリビューションツール（Adjust、Appsflyer）がゲームSDKを通じてリンクされるときに送信されるログに基づいて集計され、「活動 – メディア」の形式で選択できます。 <br> _ アトリビューションの詳細な説明は[ゲーム固有の指標 - キャンペーン指標](./game-indicator.md/#ftoc-heading-14)で確認できます。 <br> _ アトリビューション識別子（customerUserId）は、‘SDK v4’または‘SDK v1 – ログインセンター’を使用するゲームではデフォルトでplayerIDとして送信されるため、他のプロパティと併用できます。 <br> _ アトリビューション識別子（customerUserId）が他のSDKを使用するゲームのHiveユーザーキー（UID）に設定されていない場合、他のプロパティとの接続は制限されます。 <br> \* データは2024年8月1日から適用されます。 |
| ゲームプレイ情報 | 数値 | アカウントレベル | このレベルはユーザーのアカウントによって決定されます。 <br> \* ゲームプレイ分析 – [レベルアップログ](./define-log-3/game-log/gameplay-analytics-level-up-log.md/)の「levelUpTypeフィールド – アカウント」に提出された場合、選択できます。 |
| セッション情報 | 数値 | 定期セッション | 特定の期間中のユーザーのセッション数。 |
| | 数値 | 定期プレイ時間（秒） | 特定の期間中のユーザーのプレイ時間（秒）。 |
| | 数値 | 総セッション数 | ユーザーの初回アクセス以来の累積セッション数。 |
| | 数値 | 合計プレイ時間（秒） | ユーザーの初回アクセス以来の累積プレイ時間。 |
| アクセス情報 | 数値 | 期間ログイン日数 | 特定の期間中にユーザーがアクセスした日数。 |
| | 数値 | 期間ログイン回数 | 特定の期間中にユーザーがアクセスした回数。 |
| | 文字列 | 期間新規ユーザー | 特定の期間中にユーザーが新規ユーザーであるかどうか。 |
| | 日付 | 初回ログイン | ユーザーの初回アクセス日。 |
| | 数値 | 総ログイン日数 | ユーザーが初回アクセス以来アクセスした累積日数。 |
| | 数値 | 総ログイン回数 | ユーザーが初回アクセス以来アクセスした累積回数。 |
| | 数値 | 非活性日数 | ユーザーがアクセスしていない連続日数。 <br> _ 非活性期間のプロパティはセグメント作成日を基に計算されます。 <br> _ 例: 4月10日に非活性期間のプロパティが3日以上に設定されている場合、4月8日以来アクセスしていないユーザーが抽出されます。 |
| プッシュ情報 | 数値 | 期間内の大量プッシュオープン数 | ユーザーが特定の期間内に大量プッシュを開いた回数。 |
| | 数値 | 期間内のターゲティングプッシュオープン数 | ユーザーが特定の期間内にターゲティングプッシュを開いた回数。 |
| | 数値 | 総マッシブプッシュオープン数 | ユーザーが初回アクセス以降にマッシブプッシュを開いた回数の累積。 |
| | 数値 | 総ターゲティングプッシュオープン数 | ユーザーが初回アクセス以降にターゲティングプッシュを開いた回数の累積。 |
- クライアントログ送信機能を使用してユーザー属性ログを送信する際に、ユーザー定義プロパティを使用してログ送信から1時間以内にセグメントを作成できます。
- ユーザー属性クライアントログ送信機能の詳細情報は[**カスタムユーザー属性ログ**](./define-log-3/game-log/custom-user-property-log.md/)で確認できます。
-
セグメント作成のために使用したいすべてのプロパティをプロパティ選択画面で選択したら、「適用」ボタンをクリックすると、選択したすべてのプロパティが単一のグループとして表示されます。選択したプロパティを削除または変更したい場合は、「[-]」および「プロパティを追加」ボタンを使用して行うことができます。希望するすべてのプロパティを選択した後、各プロパティに希望する条件を割り当てることができます。
- 選択したプロパティが「数値プロパティ」（カウント、日数など）の場合、データ型が整数（例：ログインカウント）の場合は、1以上の正の整数値を入力することでプロパティ条件を設定できます。データ型が浮動小数点数（例：期間中の支払額（USD））の場合は、0以上の非負の浮動小数点値を入力し、その後、次のオプションのいずれかを選択することでプロパティ条件を設定できます：以上、以下、間、含む、または含まない。
- 以上または等しい: 入力された数値以上または等しいプロパティ値を持つユーザーを抽出します。
- 以下または等しい: 入力された数値以下または等しいプロパティ値を持つユーザーを抽出します。
- 範囲内: 二つの数値の間にあるプロパティ値を持つユーザーを抽出します。入力された二つの数値を含みます。
- 含む: 入力された数値と一致するプロパティ値を持つユーザーを抽出します。
- 含まない: 入力された数値と一致しないプロパティ値を持つユーザーを抽出します。
- 例: 総支払額（KRW）プロパティに10,000を入力し、「含まない」オプションを選択すると、10,000 KRW以外の総支払額を持つユーザーが抽出されます。
-
選択したプロパティが国、言語などの「文字列プロパティ」である場合（ユーザー定義プロパティの場合、送信されたプロパティのデータ型が文字列である場合）、プロパティ値のドロップダウンボックスを通じて利用可能な値を取得して選択できます。ただし、元の値（例：KR）が韓国語や英語の値（例：韓国または韓国）ではなく、一部のプロパティ値に表示される場合があります。
-
選択したプロパティが初期アクセス日と同じ「日付プロパティ」である場合（ユーザー定義プロパティの場合、送信されたプロパティのデータ型がタイムスタンプである場合）、カレンダーを通じて日付値を選択し、次のいずれかを選択できます: 前、後、日付の上、または間、プロパティ条件を設定します。
- 前: 特定の日付を選択し、「前」を選ぶと、選択した日付の前の期間のプロパティ値を取得できます。
- 後: 特定の日付を選択し、「後」を選ぶと、選択した日付の後の期間のプロパティ値を取得できます。
- 日付: 特定の日付を選択し、「日付」を選ぶと、選択した日付のプロパティ値を取得できます。
- 範囲: 「範囲」を選択し、2つの日付を選ぶと、選択した2つの日付の間のプロパティ値を取得できます。
-
プロパティ名が「period」で始まる場合、たとえば期間中のセッション数など、条件にピリオドを追加することで特定の期間の条件としてプロパティ値を設定できます。
-
期間は最新の期間または日付を選択することで設定できます。
-
最新の期間
- 現在の日付または1から365の間の数値を入力することで、絶対的な期間ではなく相対的な日数を指定できます。
- プロパティ値は取得時点に基づいて計算されるため、スナップショットユーザーの数は取得時点によって異なる場合があります。
- 例: セグメント条件が最新の期間の1日前に設定されている場合:
- 4月10日にスナップショットを作成するか、ターゲティングキャンペーンを設定する → 4月9日から4月10日までの作成時点までのプロパティ値を検索します。
- 4月11日にスナップショットを作成するか、ターゲティングキャンペーンを設定する → 4月10日から4月11日までの作成時点までのプロパティ値を検索します。
- 例: セグメント条件が最新の期間の1日前に設定されている場合:
-
日付
- 設定された期間からプロパティ値を取得できます。設定できる日付に制限はありませんが、日付範囲の最大制限は1年です。たとえば、2018年1月1日から2019年1月1日までの範囲は1年を超えないため設定できますが、2022年1月1日から2023年4月10日までの範囲は1年を超えているため設定できません。
- 日付オプションを選択すると、日付タイプのプロパティに対して「前/後/当日/間」の条件のいずれかを選択することでプロパティ条件を設定できます。
-
-
リンクのプロパティ¶
- セグメントを作成するためのプロパティと条件を設定した後、選択したプロパティをANDまたはOR条件にリンクできます。グループ内のすべてのプロパティは、選択したオプションに基づいてリンクされます。
- AND: 設定されたすべてのプロパティ条件を満たすユーザーを抽出します。
- OR: 設定されたプロパティ条件のうち、少なくとも1つを満たすユーザーを抽出します。
- 例: プロパティ条件を「合計アクセス数が3回以上で、韓国から接続しているユーザー」に設定した場合
- リンクプロパティオプションをANDに設定 → 3回以上アクセスし、韓国から接続しているユーザーを抽出します。
- リンクプロパティオプションをORに設定 → 3回以上アクセスしたユーザー、または韓国から接続したユーザーを抽出します。
複数の値が取得されるとき¶
- プロパティ名が「period」で始まらない場合、例えば国や言語のプロパティのように、最初のアクセス以降のすべてのプロパティ値が提供されます。複数の値が取得される場合、ユーザーが最初のアクセス以降にそのプロパティに持っている値の中から、最後の値またはすべての値のいずれかを選択して条件を設定するオプションを使用できます。
- 最後の値: ユーザーが最初のアクセスから取得時までに持っているすべてのプロパティ値の中で、最も最近のプロパティ値に基づいてユーザーを抽出します。
- すべての値: ユーザーが最初のアクセスから取得時までに持っているすべてのプロパティ値に基づいてユーザーを抽出します。
- 例: ユーザーAが4月9日にアメリカと韓国からアクセスし、4月10日に韓国から最後にアクセスした場合
- 複数の値が取得された場合、最後の値のオプションを設定 → 国のプロパティが「韓国」として選択された場合のみ抽出します。
- 複数の値が取得された場合、すべての値のオプションを設定 → 「アメリカ」または「韓国」が選択されているかどうかに関係なく抽出します。
プロパティグループリンク条件¶
- 2つ以上のプロパティグループを追加すると、プロパティグループリンク条件ボックスが表示され、「AND」または「OR」を選択して条件を設定できます。これにより、オプションで選択した値で作成されたすべてのプロパティグループがリンクされます。
- AND: セットされたグループの共通ユーザー（交差）を抽出します。
- OR: セットされたグループのすべてのユーザー（和集合）を抽出します。
- 例：プロパティグループ1が5,000 KRW以上の総支払額（KRW）の条件で設定され、プロパティグループ2が3,600秒以上の総プレイ時間（秒）の条件で設定されている場合。
- プロパティグループリンク条件を「AND」に設定 → 5,000 KRW以上の総支払額（KRW）を持ち、かつ3,600秒以上の総プレイ時間（秒）を持つユーザーを抽出します。
- プロパティグループリンク条件を「OR」に設定 → 5,000 KRW以上の総支払額（KRW）を持つか、3,600秒以上の総プレイ時間（秒）を持つすべてのユーザーを抽出します。
デフォルトスナップショット作成設定¶
- デフォルト情報スナップショットにplayerId、uid、did、appIdフィールドを含めるかどうかは、デフォルトスナップショット作成設定を通じて設定できます。
- 設定を選択してセグメントを作成すると、「基本セグメント」という名前のデフォルト情報スナップショットがセグメントが作成されるのと同時に作成されます。作成されたスナップショットは、セグメント詳細ページのセグメントスナップショットタブを通じて表示できます。
- 「未設定」を選択してセグメントを作成すると、セグメントスナップショットは作成されません。必要に応じて、セグメントスナップショットページで手動でスナップショットを作成できます。
セグメントスナップショットスケジュール設定¶
- セグメントスナップショットの作成プロセスをセグメントスナップショットスケジュール設定を通じて自動化できます。設定できるスケジュールの数に制限はなく、好きなだけ設定できます。
- 設定を選択し、期間、頻度、時間（KST）を設定すると、設定された期間中に設定された頻度で設定された時間にスナップショットが作成されます。
- 例：期間が4月8日午後3時から4月10日午後3時に設定され、頻度が毎日、時間が午後4時に設定されている場合→セグメントスナップショットは4月8日午後4時と4月9日午後4時の2回作成されます。
- 作成されたスナップショットは、セグメント詳細ページのセグメントスナップショットタブを通じて表示できます。
推奨セグメント¶
- 推奨されるセグメントは、分析で頻繁に作成され使用されるセグメントを指します。このセグメントに加えて、さまざまなプロパティ条件を組み合わせてカスタムセグメントを作成してみてください。
すべてのユーザー¶
- 説明: 発売以来、少なくとも一度ゲームにアクセスしたユーザー。
- プロパティを選択
| プロパティ名 | プロパティ値 | プロパティ条件 | 期間条件 |
|---|---|---|---|
| アプリID | すべてのアプリID値を選択 | - | - |
過去7日間の新規ユーザー¶
- 説明: 過去7日以内に新たに取得されたユーザー。
- プロパティを選択
| プロパティ名 | プロパティ値 | プロパティ条件 | 期間条件 |
|---|---|---|---|
| 期間新規ユーザー | はい | - | 最新の期間 |
過去1年以内に特定の国で少なくとも1回アクセスしたユーザー¶
- 説明: 過去1年以内に特定の国で少なくとも1回アクセスしたユーザー。
- プロパティを選択<
| プロパティ名 | プロパティ値 | プロパティ条件 | 期間条件 |
|---|---|---|---|
| 国 | 国の値（例：アメリカ） | - | - |
| ログイン日数 | 1 | 以上 | 最新の期間 |
- リンクプロパティ: AND
- 複数の値が取得される場合: すべての値
特定のマーケットプレイスのユーザーの中で、3日以上非アクティブな休眠ユーザー¶
- 説明: 特定のマーケットを通じてゲームをインストールし、取得時点から3日連続でアクセスしていないユーザー。
- プロパティを選択
| プロパティ名 | プロパティ値 | プロパティ条件 | 期間条件 |
|---|---|---|---|
| 市場 | 市場価値（例：Google） | - | - |
| 滞在日数 | 3 | 以上 | - |
- リンクプロパティ: AND
- 複数の値が取得される場合: すべての値
特定の期間中にアクセスしたユーザーの中で、3日以上非アクティブな休眠ユーザー¶
- 説明: 特定の期間中にアクティブだったが、取得時点で3日連続でアクセスしていないユーザー。
- プロパティを選択
| プロパティ名 | プロパティ値 | プロパティ条件 | 期間条件 |
|---|---|---|---|
| ログイン期間日数 | 1 | 以上 | 日付 |
| 滞在日数 | 3 | 以上 | - |
- リンクプロパティ: AND