サンプルステータスエンドポイントのプレビュー(プロファイルプレビュー)

Adobe Experience Platformを使用すると、複数のソースから顧客データを取り込んで、個々の顧客ごとに堅牢で統合されたプロファイルを作成できます。 データが Platform に取り込まれると、サンプルジョブが実行され、プロファイル数やその他のリアルタイム顧客プロファイルデータ関連指標が更新されます。

このサンプルジョブの結果は、リアルタイム顧客プロファイル API の一部である /previewsamplestatus エンドポイントを使用して確認できます。 また、このエンドポイントは、データセットと ID 名前空間の両方によるプロファイル配分のリストを作成したり、複数のレポートを生成して組織のプロファイルストアの構成を明確に把握したりするのにも使用できます。 このガイドでは、/previewsamplestatus API エンドポイントを使用してこれらの指標を表示するために必要な手順について説明します。

メモ

Adobe Experience Platform Segmentation Service API の一部として使用できる推定およびプレビューエンドポイントがあり、予想されるオーディエンスを特定するのに役立つ、セグメント定義に関する概要レベルの情報を表示できます。 セグメントのプレビューと予測のエンドポイントを使用する詳細な手順を見つけるには、『Segmentation API 開発者ガイド』の一部である、 プレビューと予測のエンドポイントに関するガイド を参照してください。

はじめに

このガイドで使用する API エンドポイントは、Real-time Customer Profile API の一部です。先に進む前に、はじめる前にのガイドを参照し、関連ドキュメントへのリンク、このドキュメントのサンプル API 呼び出しを読み取るためのガイドおよび任意の Experience Platform API の呼び出しを成功させるのに必要なヘッダーに関する重要な情報を確認してください。

プロファイルフラグメントと結合プロファイル

このガイドでは、「プロファイルフラグメント」と「結合されたプロファイル」の両方を参照します。 先に進む前に、これらの用語の違いを理解することが重要です。

個々の顧客プロファイルは、その顧客に対する単一のビューを形成する複数のプロファイルフラグメントで構成されます。例えば、顧客が複数のチャネルをまたいでブランドとやり取りする場合、組織には、その 1 人の顧客に関連する複数のプロファイルフラグメントが複数のデータセットに表示される可能性があります。

プロファイルフラグメントが Platform に取り込まれると、その顧客の単一のプロファイルを作成するために、プロファイルフラグメントが(結合ポリシーに基づいて)結合されます。 したがって、各プロファイルは複数のフラグメントで構成されるので、プロファイルフラグメントの合計数は、結合されたプロファイルの合計数よりも常に多くなる可能性があります。

Experience Platform内でのプロファイルとその役割の詳細については、まず「 リアルタイム顧客プロファイルの概要 」を参照してください。

サンプルジョブのトリガー方法

リアルタイム顧客プロファイルに対して有効なデータが Platform に取り込まれると、そのデータはプロファイルデータストアに保存されます。 レコードのプロファイルストアへの取り込みで、プロファイルの合計数が 5%以上増減すると、サンプリングジョブがトリガーされ、カウントが更新されます。 サンプルのトリガー方法は、使用する取り込みのタイプによって異なります。

  • ストリーミングデータワークフロー の場合は、5%の増減しきい値に達したかどうかを判断するために、1 時間ごとにチェックが行われます。 ある場合は、サンプルジョブが自動的にトリガーされ、カウントが更新されます。
  • バッチ取得 の場合、15 分以内にバッチをプロファイルストアに正常に取り込みます。5%の増減しきい値に達すると、ジョブが実行されてカウントが更新されます。 プロファイル API を使用すると、最新の成功したサンプルジョブのプレビューや、データセット別、ID 名前空間別のプロファイル配分のリストを表示できます。

Experience Platform数と名前空間別のプロファイルは、プロファイル UI の Profiles セクション内でも使用できます。 UI を使用してプロファイルデータにアクセスする方法について詳しくは、Profile UI ガイド を参照してください。

最後のサンプルステータスの表示

/previewsamplestatus エンドポイントに対してGETリクエストを実行し、IMS 組織に対して最後に正常に実行されたサンプルジョブの詳細を表示できます。 これには、サンプル内のプロファイルの合計数、プロファイル数指標、またはExperience Platform内に組織が持つプロファイルの合計数が含まれます。

プロファイル数は、プロファイルフラグメントを結合して個々の顧客ごとに 1 つのプロファイルを形成した後に生成されます。 つまり、プロファイルフラグメントを結合すると、すべて同じ個人に関連しているので、「1」プロファイルの数が返されます。

また、プロファイル数には、属性(レコードデータ)を持つプロファイルと、時系列(イベント)データのみを含むプロファイル (Adobe Analyticsプロファイルなど ) の両方が含まれます。 サンプルジョブは、Platform 内の最新の合計プロファイル数を提供するために、プロファイルデータが取り込まれると定期的に更新されます。

API 形式

GET /previewsamplestatus

リクエスト

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

応答

応答には、組織に対して最後に実行された正常なサンプルジョブの詳細が含まれます。

メモ

この例の応答では、numRowsToReadtotalRows は互いに等しくなります。 組織がExperience Platformに持つプロファイルの数に応じて、このような場合があります。 ただし、通常、これら 2 つの数は異なります。numRowsToRead は、サンプルがプロファイルの合計数のサブセット (totalRows) として表されるので、小さい数になります。

{
  "numRowsToRead": "41003",
  "sampleJobRunning": {
    "status": true,
    "submissionTimestamp": "2020-08-01 17:57:57.0"
  },
  "cosmosDocCount": "\"300803\"",
  "totalFragmentCount": 47429,
  "lastSuccessfulBatchTimestamp": "\"null\"",
  "streamingDriven": "\"false\"",
  "totalRows": "41003",
  "lastBatchId": "\"null\"",
  "status": "TASK_FINISHED",
  "samplingRatio": 1.0,
  "mergeStrategy": "timestampOrdered_auto",
  "lastSampledTimestamp": "2020-08-01 17:57:57.0"
}
プロパティ 説明
numRowsToRead サンプル内の結合済みプロファイルの合計数です。
sampleJobRunning サンプルジョブが進行中の場合に true を返す boolean 値。 バッチファイルが実際にプロファイルストアに追加されたときににアップロードされる遅延に対して、透明性を提供します。
cosmosDocCount Cosmos 内の合計ドキュメント数。
totalFragmentCount プロファイルストア内のプロファイルフラグメントの合計数。
lastSuccessfulBatchTimestamp 最後に成功したバッチ取得のタイムスタンプ。
streamingDriven このフィールドは廃止され、応答に対する重要性はありません。
totalRows Experience Platform内の結合済みプロファイルの合計数。「プロファイル数」とも呼ばれます。
lastBatchId 最後のバッチ取得 ID。
status 最後のサンプルのステータス。
samplingRatio 合計結合プロファイル (numRowsToRead) に対する、結合済みプロファイルの比率 (totalRows)。小数形式の割合で表されます。
mergeStrategy サンプルで使用される結合方法。
lastSampledTimestamp 最後に成功したサンプルタイムスタンプ。

データセット別のプロファイル配分のリスト

データセットごとのプロファイルの分布を確認するには、/previewsamplestatus/report/dataset エンドポイントに対してGETリクエストを実行します。

API 形式

GET /previewsamplestatus/report/dataset
GET /previewsamplestatus/report/dataset?{QUERY_PARAMETERS}
パラメーター 説明
date 返されるレポートの日付を指定します。 その日に複数のレポートが実行された場合は、その日の最新のレポートが返されます。 指定した日付のレポートが存在しない場合は、404(見つかりません)エラーが返されます。 日付が指定されていない場合は、最新のレポートが返されます。 形式:YYYY-MM-DD です。 例:date=2024-12-31

リクエスト

次のリクエストでは、date パラメーターを使用して、指定した日付の最新のレポートを返します。

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset?date=2020-08-01 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

応答

応答には、データセットオブジェクトのリストを含む data 配列が含まれます。 表示された応答は、3 つのデータセットを表示するように切り捨てられました。

メモ

その日付に対して複数のレポートが存在する場合は、最新のレポートのみが返されます。 指定した日付のデータセットレポートが存在しない場合は、HTTP ステータス 404(未検出)が返されます。

{
  "data": [
    {
      "sampleCount": 12577,
      "samplePercentage": 0.306734,
      "fullIDsCount": 20988,
      "fullIDsPercentage": 0.511865,
      "name": "CRM Profiles",
      "description": "Profiles from the CRM.",
      "value": "5f160106be34361915754b9c",
      "streamingIngestionEnabled": "",
      "createdUser": "{CREATED_USER}",
      "reportTimestamp": "2020-08-01T17:57:58.697",
    },
    {
      "sampleCount": 12938,
      "samplePercentage": 0.315538,
      "fullIDsCount": 21796,
      "fullIDsPercentage": 0.531571,
      "name": "AAM Authenticated Profiles",
      "description": "This data set contains AAM authenticated profiles.",
      "value": "5dc77ec6eed47f18a796ca90",
      "streamingIngestionEnabled": "",
      "createdUser": "{CREATED_USER}",
      "reportTimestamp": "2020-08-01T17:57:58.697"
    },
    {
      "sampleCount": 22725,
      "samplePercentage": 0.554228,
      "fullIDsCount": 41003,
      "fullIDsPercentage": 1.0,
      "name": "Loyalty Program Members",
      "description": "Members of the loyalty program at all levels.",
      "value": "5d0fda92274e55144d4de620",
      "streamingIngestionEnabled": "",
      "createdUser": "{CREATED_USER}",
      "reportTimestamp": "2020-08-01T17:57:58.697"
    }
  ],
  "reportTimestamp": "2020-08-01T17:57:58.697"
}
プロパティ 説明
sampleCount このデータセット ID を持つサンプリングされた結合プロファイルの合計数。
samplePercentage サンプリングされた結合プロファイルの合計数( 最後のサンプルステータス で返される numRowsToRead 値)の割合 (%)。10 進数形式で表されます。sampleCount
fullIDsCount このデータセット ID を持つ結合プロファイルの合計数。
fullIDsPercentage 結合されたプロファイルの合計数( 最後のサンプルステータス で返される totalRows 値)の割合(10 進数形式)。fullIDsCount
name データセットの作成時に指定された、データセットの名前。
description データセットの説明。データセットの作成時に提供されます。
value データセットの ID。
streamingIngestionEnabled データセットのストリーミング取り込みが有効になっているかどうか。
createdUser データセットを作成したユーザーのユーザー ID。
reportTimestamp レポートのタイムスタンプ。 リクエスト中に date パラメーターが指定された場合、指定された日付のレポートが返されます。 date パラメーターを指定しない場合は、最新のレポートが返されます。

ID 名前空間別のプロファイル配分のリスト

/previewsamplestatus/report/namespace エンドポイントに対してGETリクエストを実行し、プロファイルストア内のすべての結合プロファイルにわたる ID 名前空間での分類を表示できます。 これには、Adobeが提供する標準 ID と、組織が定義するカスタム ID の両方が含まれます。

ID 名前空間は、Adobe Experience Platform ID サービスの重要なコンポーネントで、顧客データが関連するコンテキストのインジケーターとして機能します。 詳しくは、まず ID 名前空間の概要 を読んでください。

メモ

1 つのプロファイルが複数の名前空間に関連付けられている可能性があるので、名前空間別のプロファイルの合計数(名前空間ごとに表示される値を加算)は、プロファイル数指標より多くなる場合があります。 例えば、顧客が複数のチャネルでブランドとやり取りする場合、複数の名前空間がその個々の顧客に関連付けられます。

API 形式

GET /previewsamplestatus/report/namespace
GET /previewsamplestatus/report/namespace?{QUERY_PARAMETERS}
パラメーター 説明
date 返されるレポートの日付を指定します。 その日に複数のレポートが実行された場合は、その日の最新のレポートが返されます。 指定した日付のレポートが存在しない場合は、404(見つかりません)エラーが返されます。 日付が指定されていない場合は、最新のレポートが返されます。 形式:YYYY-MM-DD です。 例:date=2024-12-31

リクエスト

次のリクエストでは、date パラメーターが指定されていないので、最新のレポートが返されます。

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/namespace \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

応答

応答には data 配列が含まれ、個々のオブジェクトに各名前空間の詳細が含まれます。 4 つの名前空間を表示するために、表示された応答が切り捨てられました。

{
  "data": [
    {
      "sampleCount": 12148,
      "samplePercentage": 0.296271,
      "reportTimestamp": "2020-08-01T17:57:58.697",
      "fullIDsFragmentCount": 13141,
      "fullIDsCount": 12631,
      "fullIDsPercentage": 0.308051,
      "code": "Email",
      "value": "6"
    },
    {
      "sampleCount": 6989,
      "samplePercentage": 0.170451,
      "reportTimestamp": "2020-08-01T17:57:58.697",
      "fullIDsFragmentCount": 7543,
      "fullIDsCount": 7042,
      "fullIDsPercentage": 0.171744,
      "code": "ECID",
      "value": "4"
    },
    {
      "sampleCount": 888,
      "samplePercentage": 0.021657,
      "reportTimestamp": "2020-08-01T17:57:58.697",
      "fullIDsFragmentCount": 3801,
      "fullIDsCount": 3206,
      "fullIDsPercentage": 0.078189,
      "code": "AAID",
      "value": "10"
    },
    {
      "sampleCount": 21809,
      "samplePercentage": 0.531888,
      "reportTimestamp": "2020-08-01T17:57:58.697",
      "fullIDsFragmentCount": 27023,
      "fullIDsCount": 21936,
      "fullIDsPercentage": 0.534985,
      "code": "Phone",
      "value": "7"
    }
  ],
  "reportTimestamp": "2020-08-01T17:57:58.697"
}
プロパティ 説明
sampleCount 名前空間内のサンプリングされた結合プロファイルの合計数です。
samplePercentage サンプリングされた結合プロファイル( 最後のサンプルステータス で返される numRowsToRead 値)の割合(10 進数形式)。sampleCount
reportTimestamp レポートのタイムスタンプ。 リクエスト中に date パラメーターが指定された場合、指定された日付のレポートが返されます。 date パラメーターを指定しない場合は、最新のレポートが返されます。
fullIDsFragmentCount 名前空間内のプロファイルフラグメントの合計数です。
fullIDsCount 名前空間内の結合済みプロファイルの合計数です。
fullIDsPercentage fullIDsCount は、合計結合プロファイル( 最後のサンプルステータス で返される totalRows 値)の割合で、10 進数形式で表されます。
code 名前空間の code。 これは、Adobe Experience Platform ID サービス API を使用して名前空間を操作する際に見つかります。Experience PlatformUI では ID 記号 とも呼ばれます。 詳しくは、ID 名前空間の概要 を参照してください。
value 名前空間の id 値。 これは、ID サービス API を使用して名前空間を操作する際に見つかります。

データセットの重複レポートの生成

データセット重複レポートは、アドレス可能なオーディエンス(結合プロファイル)に最も貢献するデータセットを公開することで、組織のプロファイルストアの構成を視覚的に把握できます。 このレポートは、データに関するインサイトを提供するだけでなく、特定のデータセットに対する TTL の設定など、ライセンスの使用を最適化するためのアクションを実行するのに役立ちます。

/previewsamplestatus/report/dataset/overlap エンドポイントに対してGETリクエストを実行すると、データセット重複レポートを生成できます。

コマンドラインまたは Postman UI を使用してデータセットの重複レポートを生成する手順については、 データセットの重複レポートの生成に関するチュートリアル を参照してください。

API 形式

GET /previewsamplestatus/report/dataset/overlap
GET /previewsamplestatus/report/dataset/overlap?{QUERY_PARAMETERS}
パラメーター 説明
date 返されるレポートの日付を指定します。 同じ日付で複数のレポートが実行された場合は、その日の最新のレポートが返されます。 指定した日付のレポートが存在しない場合は、404(見つかりません)エラーが返されます。 日付が指定されていない場合は、最新のレポートが返されます。 形式:YYYY-MM-DD です。 例:date=2024-12-31

リクエスト

次のリクエストでは、date パラメーターを使用して、指定した日付の最新のレポートを返します。

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-12-29 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

応答

リクエストが成功すると、HTTP ステータス 200(OK) とデータセットの重複レポートが返されます。

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-12-29T19:55:31.147"
}
プロパティ 説明
data data オブジェクトには、データセットのコンマ区切りのリストと、それぞれのプロファイル数が含まれます。
reportTimestamp レポートのタイムスタンプ。 リクエスト中に date パラメーターが指定された場合、指定された日付のレポートが返されます。 date パラメーターを指定しない場合は、最新のレポートが返されます。

データセットの重複レポートの解釈

レポートの結果は、応答のデータセットとプロファイル数から解釈できます。 次の例のレポート data オブジェクトについて考えてみましょう。

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

このレポートには、次の情報が表示されます。

  • 次のデータセットからのデータで構成される 123 のプロファイルがあります。5d92921872831c163452edc85da7292579975918a851db575eb2cdc6fa3f9a18a7592a98
  • 次の 2 つのデータセットから得られるデータで構成される 454,412 件のプロファイルがあります。5d92921872831c163452edc85eb2cdc6fa3f9a18a7592a98
  • データセット 5eeda0032af7bb19162172a7 のデータのみから構成される 107 個のプロファイルがあります。
  • 組織には、合計 454,642 件のプロファイルがあります。

ID 名前空間の重複レポートの生成

ID 名前空間重複レポートは、アドレス可能なオーディエンス(結合プロファイル)に最も貢献する ID 名前空間を公開することで、組織のプロファイルストアの構成を視覚的に確認できます。 これには、Adobeが提供する標準 ID 名前空間と、組織が定義したカスタム ID 名前空間の両方が含まれます。

/previewsamplestatus/report/namespace/overlap エンドポイントに対してGETリクエストを実行すると、ID 名前空間の重複レポートを生成できます。

API 形式

GET /previewsamplestatus/report/namespace/overlap
GET /previewsamplestatus/report/namespace/overlap?{QUERY_PARAMETERS}
パラメーター 説明
date 返されるレポートの日付を指定します。 同じ日付で複数のレポートが実行された場合は、その日の最新のレポートが返されます。 指定した日付のレポートが存在しない場合は、404(見つかりません)エラーが返されます。 日付が指定されていない場合は、最新のレポートが返されます。 形式:YYYY-MM-DD です。 例:date=2024-12-31

リクエスト

次のリクエストでは、date パラメーターを使用して、指定した日付の最新のレポートを返します。

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/namespace/overlap?date=2021-12-29 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

応答

リクエストが成功すると、HTTP ステータス 200(OK) と ID 名前空間の重複レポートが返されます。

{
    "data": {
        "Email,crmid,loyal": 2,
        "ECID,Email,crmid": 7,
        "ECID,Email,mobilenr": 12,
        "AAID,ECID,loyal": 1,
        "mobilenr": 25,
        "AAID,ECID": 1508,
        "ECID,crmid": 1,
        "AAID,ECID,crmid": 2,
        "Email,crmid": 328,
        "CORE": 49,
        "AAID": 446,
        "crmid,loyal": 20988,
        "Email": 10904,
        "crmid": 249,
        "ECID,Email": 74,
        "Phone": 40,
        "Email,Phone,loyal": 48,
        "AAID,AVID,ECID": 85,
        "Email,loyal": 1002,
        "AAID,ECID,Email,Phone,crmid": 5,
        "AAID,ECID,Email,crmid,loyal": 23,
        "AAID,AVID,ECID,Email,crmid": 2,
        "AVID": 3,
        "AAID,ECID,Phone": 1,
        "loyal": 43,
        "ECID,Email,crmid,loyal": 6,
        "AAID,ECID,Email,Phone,crmid,loyal": 1,
        "AAID,ECID,Email": 2,
        "AAID,ECID,Email,crmid": 142,
        "AVID,ECID": 24,
        "ECID": 6565
    },
    "reportTimestamp": "2021-12-29T16:55:03.624"
}
プロパティ 説明
data data オブジェクトには、ID 名前空間コードの一意の組み合わせと、それぞれのプロファイル数を含む、コンマ区切りのリストが含まれます。
名前空間コード code は、各 ID 名前空間名の短い形式です。 各 codename へのマッピングは、Adobe Experience Platform ID サービス API を使用して見つかります。 code は、Experience PlatformUI では ID 記号 とも呼ばれます。 詳しくは、ID 名前空間の概要 を参照してください。
reportTimestamp レポートのタイムスタンプ。 リクエスト中に date パラメーターが指定された場合、指定された日付のレポートが返されます。 date パラメーターを指定しない場合は、最新のレポートが返されます。

ID 名前空間の重複レポートの解釈

レポートの結果は、応答の ID とプロファイルの数から解釈できます。 各行の数値は、標準 ID 名前空間とカスタム ID 名前空間の正確な組み合わせで構成されるプロファイルの数を示します。

data オブジェクトの次の抜粋を考えてみましょう。

  "AAID,ECID,Email,crmid": 142,
  "AVID,ECID": 24,
  "ECID": 6565

このレポートには、次の情報が表示されます。

  • AAIDECIDEmail の標準 ID と、カスタムの crmid ID 名前空間のプロファイルは 142 個あります。
  • AAIDECID の ID 名前空間で構成される 24 個のプロファイルがあります。
  • ECID ID のみを含むプロファイルは 6,565 個あります。

不明なプロファイルレポートの生成

不明なプロファイルレポートを使用すると、組織のプロファイルストアの構成をさらに明確に把握できます。 「不明なプロファイル」とは、特定の期間、未関連付けおよび非アクティブの両方にあるプロファイルを指します。 「未関連付け」プロファイルは、1 つのプロファイルフラグメントのみを含むプロファイルで、「非アクティブ」プロファイルは、指定された期間、新しいイベントを追加しなかったプロファイルです。 不明なプロファイルレポートは、7 日、30 日、60 日、90 日、120 日のプロファイルの分類を表示します。

/previewsamplestatus/report/unknownProfiles エンドポイントに対してGETリクエストを実行すると、不明なプロファイルレポートを生成できます。

API 形式

GET /previewsamplestatus/report/unknownProfiles

リクエスト

次のリクエストは、不明なプロファイルレポートを返します。

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/unknownProfiles \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

応答

リクエストが成功すると、HTTP ステータス 200(OK) と不明なプロファイルレポートが返されます。

メモ

このガイドの目的上、レポートは "120days" と"7days"の期間のみを含むように切り捨てられました。 完全な不明なプロファイルレポートは、7 日、30 日、60 日、90 日、120 日のプロファイルの分類を表示します。

{
  "data": {
      "totalNumberOfProfiles": 63606,
      "totalNumberOfEvents": 130977,
      "unknownProfiles": {
          "120days": {
              "countOfProfiles": 1644,
              "eventsAssociated": 26824,
              "nsDistribution": {
                  "Email": {
                      "countOfProfiles": 18,
                      "eventsAssociated": 95
                  },
                  "loyal": {
                      "countOfProfiles": 26,
                      "eventsAssociated": 71
                  },
                  "ECID": {
                      "countOfProfiles": 1600,
                      "eventsAssociated": 26658
                  }
              }
          },
          "7days": {
              "countOfProfiles": 1782,
              "eventsAssociated": 29151,
              "nsDistribution": {
                  "Email": {
                      "countOfProfiles": 19,
                      "eventsAssociated": 97
                  },
                  "ECID": {
                      "countOfProfiles": 1734,
                      "eventsAssociated": 28591
                  },
                  "loyal": {
                      "countOfProfiles": 29,
                      "eventsAssociated": 463
                  }
              }
          }
      }
  },
  "reportTimestamp": "2025-08-25T22:14:55.186"
}
プロパティ 説明
data data オブジェクトには、不明なプロファイルレポートに対して返される情報が含まれます。
totalNumberOfProfiles プロファイルストア内の一意のプロファイルの合計数です。 これは、アドレス可能なオーディエンスの数と同じです。 既知のプロファイルと不明なプロファイルの両方が含まれます。
totalNumberOfEvents プロファイルストア内の ExperienceEvents の合計数です。
unknownProfiles 不明なプロファイル(未関連付けおよび非アクティブ)の時間別分類を含むオブジェクト。 不明なプロファイルレポートは、7 日、30 日、60 日、90 日、120 日の期間のプロファイルの分類を表示します。
countOfProfiles 期間中の不明なプロファイルの数、または名前空間の不明なプロファイルの数。
eventsAssociated 時間範囲の ExperienceEvents の数または名前空間のイベント数。
nsDistribution 個々の ID 名前空間と、各名前空間の不明なプロファイルおよびイベントの配分を含むオブジェクト。 注意:nsDistribution オブジェクトの各 ID 名前空間の合計 countOfProfiles を合計すると、その期間の countOfProfiles と等しくなります。 名前空間ごとの eventsAssociated と期間ごとの合計 eventsAssociated についても同様です。
reportTimestamp レポートのタイムスタンプ。

不明なプロファイルレポートの解釈

レポートの結果から、組織のプロファイルストア内にある未関連付けプロファイルと非アクティブなプロファイルの数を把握できます。

data オブジェクトの次の抜粋を考えてみましょう。

  "7days": {
    "countOfProfiles": 1782,
    "eventsAssociated": 29151,
    "nsDistribution": {
      "Email": {
        "countOfProfiles": 19,
        "eventsAssociated": 97
      },
      "ECID": {
        "countOfProfiles": 1734,
        "eventsAssociated": 28591
      },
      "loyal": {
        "countOfProfiles": 29,
        "eventsAssociated": 463
      }
    }
  }

このレポートには、次の情報が表示されます。

  • 1 つのプロファイルフラグメントのみを含み、過去 7 日間新しいイベントを持たない 1,782 個のプロファイルがあります。
  • 1,782 件の不明なプロファイルに関連付けられた ExperienceEvents は 29,151 件あります。
  • ECID の ID 名前空間の単一のプロファイルフラグメントを含む不明なプロファイルは 1,734 件あります。
  • 1,734 件の不明なプロファイルに関連付けられた 28,591 件のイベントがあり、この中には、ECID の ID 名前空間の 1 つのプロファイルフラグメントが含まれています。

次の手順

これで、プロファイルストアでサンプルデータをプレビューし、データに関する複数のレポートを実行する方法がわかったので、Segmentation Service API の推定エンドポイントとプレビューエンドポイントを使用して、セグメント定義に関する概要レベルの情報を表示できます。 この情報は、セグメント内の期待されるオーディエンスを確実に特定するのに役立ちます。 セグメント化 API を使用したセグメントプレビューと推定の操作について詳しくは、『 プレビューと推定エンドポイントのガイド 』を参照してください。

このページ