---
title: "データエンティティ参照"
slug: "data-entities-reference"
abstract: "データレイクエクスポートサービスのデータエンティティとその属性を記述します。"
---
# データエンティティ参照

> !重要機能の利用可能性は段階的に展開される一環です。あなたの組織はまだこの機能に気づいていないかもしれません。環境が導入された際に利用可能になります。

[現在、データレイクエクスポートサービス](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service.html)で利用可能なデータには、プロファイル^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b\_N6970cc9576a39、セッション^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b\_N6970cca57a253、イベント^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b\_N696f54f334d35が含まれます。このページでは、各サポートデータエンティティの属性や型について説明しています。このリファレンスは、エクスポートされたデータに対してクエリ、レポート、統合を作成する際に活用してください。

## エンティティ関係図

以下の図は、データレイクエクスポートサービスデータエンティティ間の関係を示しています。

![Entity relationship diagram for data lake export service data entities](https://doc.sitecore.com/api/markdown-image/sai/ja/developers/sitecoreai/images/fabric-data-lake-erd.png)

## データエンティティ参照

以下の表は、エクスポートされたデータに現れるデータエンティティとその属性を説明しています。

### プロフィール

名称

種類

概要

例

id

ストリング

プロファイルの一意でシステム生成の識別子。

"123e4567-e89b-12d3-a456-426614174000"

createdAt

タイムスタンプ

システム生成のタイムスタンプで、プロファイルが最初に作成された時期を示します。

"2020-09-08T16:17:16.000Z"

modifiedAt

タイムスタンプ

システム生成のタイムスタンプは、プロファイルが最後に更新されたことを示しています。

"2020-09-08T16:17:16.000Z"

lastSeenAt

タイムスタンプ

システム生成のタイムスタンプで、プロファイルが最後に見られた日を示す。

"2020-09-08T16:17:16.000Z"

type

ストリング

プロファイルの種類を指定し、 identified または visitorのいずれかです。

"identified"

contact

目的

プロフィールに関連する連絡先情報を含みます。

[参照 Profile.contact](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#profile-contact)

identifiers

配列

メールアドレスや電話番号など、プロファイルに関連付けられた識別子の集合。

{ "provider": "email", "id": "john.smith@email.com" }  
  
[参照 Profile.identifiers](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#profile-identifiers)

clientIds

配列

プロファイルに関連付けられたユーザーIDのリスト。

"f3a9c2e4-7b8d-4c2a-9f1e-8a6d3b2c9e1a"

extensions

地図

カスタムゲスト属性。

[参照 Profile.extensions](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#profile-extensions)

traits

目的

プロフィールやセッションに関連する様々な特性を保持するための自由な構造。

[参照 Profile.traits](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#profile-traits)

audiences

目的

プロフィールが属するセグメントやオーディエンスに関する情報。

[参照 Profile.audiences](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#profile-audiences)

### プロフィール.contact(プロフィール).contact

名称

種類

概要

例

firstName

ストリング

個人の名前は空であってはならない。(1〜500文字)

"John"

lastName

ストリング

その人物の姓。(1〜500文字)

"Smith"

email

ストリング

ローカル部分、 @ 記号、ドメインを含む有効なメールアドレス形式。

"example@email.com"

dateOfBirth

日付

生年月日はISO 8601規格(YYYY-MM-DD)で、年、月、日を表します。

"1995-01-01"

gender

ストリング

個人の性別。フリーテキストは受け入れられますが、推奨される値のいずれかが推奨されます。  
  
推奨値は "male"、 "female"、 "unknown"、 "other"  
  
(1〜100文字)

"male"

language

ストリング

言語コードはISO 639-1形式で表され、大文字2文字で表されていました。

"EN"

title

ストリング

個人のためのタイトルは、フリーテキストでも指定された列挙値のいずれかでも構いません。  
  
推奨値: "Br"、 "Brigadier"、 "Capt"、 "Colonel"、 "Dame"、 "Dr"、 "Elder"、 "Fr"、 "General"、 "Hon"、 "Judge"、 "Lord"、 "Master"、 "Miss"、 "Mr"、 "Mrs"、 "Ms"、 "Mstr"、 "Prof"、 "Rabbi"、 "Rev"、 "Shaikha"、 "Sheikh"、 "Sir"、 "Sister"、 "Sr"  
  
(1〜100文字)

"Mr"

phoneNumbers

地図

自宅、職場、モバイルなど、さまざまな電話番号を構造化して表現したものです。

[参照 Profile.contact.phoneNumbers](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#profile-contact-phonenumbers)

address

目的

通り、市、州、郵便番号を含む物理的な場所の構造化された表現。

[参照 Profile.contact.address](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#profile-contact-address)

### プロフィール.contact.address

名称

種類

概要

例

street

ストリング

住所だ。(1〜500文字)

"12 Baker Street"

city

ストリング

その都市の名前。(1〜500文字)

"Madrid"

state

ストリング

州名や地域のこと。(1〜500文字)

"Colorado"

postCode

ストリング

郵便番号は国ごとにフォーマットされています。(1〜500文字)

"AB 123"

country

ストリング

国コードだ。 address がいる場合は必須です。フォーマット:ISO 3166-1 alpha-2

"ES"

### プロフィール.連絡先.電話番号

-   相互運用性のためにE.164の使用や、ローカルパターンのドキュメント作成を推奨します。
-   マップを開けて。価値は顧客によって設定できます。以下にサンプルをご覧ください。

名称

種類

概要

例

home

ストリング

自宅電話番号はE.164形式、または空の番号でも構いません。

"+34911222333"

work

ストリング

E.164形式の職場電話番号、または空の番号でもいいです。

"+34914445566"

mobile

ストリング

携帯電話番号はE.164形式、または空の番号もあります。

"+353861234567"

### Profile.identifiers

名称

種類

概要

例

provider

ストリング

[識別](https://doc.sitecore.com/sai/en/users/sitecoreai/audience-and-insights/identity-resolution/identity-rules.html)子の提供元を指定します。

"email"

id

ストリング

指定された providerに従ってフォーマットされた実際の識別子値。

"john.smith@sitecore.com"

### Profile.traits

名称

種類

概要

例

affinities

地図

ページビューに基づくシステム生成の親和性スコア。

[参照 Profile.traits.affinities](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#profile-traits-affinities)

### プロフィール.traits.affinities

-   顧客が定義した [アフィニティ](https://doc.sitecore.com/sai/en/users/sitecoreai/audience-and-insights/affinities.html) 信号をネストされたマップ構造に保存します。
-   グループ名や値名は動的で顧客ごとに定義されています。固定スキーマフィールドを持つのは葉オブジェクトだけです。
-   第一段階のキーは親和群名です(例: "brand"、 "category"、 "productType")。
-   第二レベルのキーはその群内の親和度値です(例: "adidas"、 "running"、 "shoes")。
-   葉の対象は固定場を持つ affinityValue であり、 views、 score、 lastViewAtです。

名称

種類

概要

例

affinityGroup

文字列キー

ダイナミックなトップレベルのアフィニティグループ。

"brand"

affinityValueKey

文字列キー

グループ内で動的価値キーを配置します。

"adidas"

affinityValue

目的

1つのアフィニティ値に対して固定葉のオブジェクト。

{ views, score, lastViewAt }

名称

種類

概要

例

views

整数

このアフィニティ値の閲覧数。

25

score

番号

この値のアフィニティスコア。

0.95

lastViewAt

タイムスタンプ

最終閲覧または更新されたタイムスタンプ(ISO-8601 UTC)。

"2026-05-20T14:22:31Z"

### Profile.audiences

名称

種類

概要

例

segmentMembership

配列

プロフィールが属するセグメントや [オーディエンス](https://doc.sitecore.com/sai/en/users/sitecoreai/audience-and-insights/audiences.html) に関する情報。

"segment1", "segment2"

### Profile.extensions

組織が特定のビジネスニーズに合わせて定義した汎用拡張可能な属性。 extensionsオブジェクトの中に任意の数のカスタムキー・値ペアを含めることができます。フィールド名はAPIではなく、あなた自身が定義します。

名称

種類

概要

例

属性

文字列、ブール、数、リスト、オブジェクト

カスタムデータ用の1つまたは複数の名前と値の組み合わせ属性。

-   { customKey: "customValue" }
-   { tier: "gold", score: 42 }

### 会期

名称

種類

概要

例

id

ストリング

セッション用の一意でシステム生成の識別子。

"123e4567-e89b-12d3-a456-426614174000"

profileId

ストリング

プロファイルの一意でシステム生成の識別子。

"123e4567-e89b-12d3-a456-426614174000"

createdAt

タイムスタンプ

セッション作成のタイムスタンプ。

"2026-01-08T16:17:16.000Z"

createdAtIso

ストリング

ISO-8601による作成タイムスタンプの表現。データ分割として使用されます。

"2026-01-08"

modifiedAt

タイムスタンプ

セッションが最後に更新されたタイムスタンプ。

"2026-01-08T16:17:16.000Z"

clientId

ストリング

プロファイルに関連付けられたユーザー識別子。

"123e4567-e89b-12d3-a456-426614174000"

siteId

ストリング

サイトまたはアプリケーション識別子。

"SpinAir"

channel

ストリング

セッションが行われた経路。

"Web"

status

ストリング

セッションの現状。

"Closed"

language

ストリング

閲覧されているサイトやページの言語。イベントから送信・導出できるオプションパラメータ。

"EN"

clientDevice

目的

デバイス情報。

[参照 Session.clientDevice](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#session-clientdevice)

geolocation

目的

位置情報。

[参照 Session.geolocation](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#session-geolocation)

utm

目的

UTMの帰属データ。

[参照 Session.utm](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#session-utm)

stats

目的

セッションの統計。

[参照 Session.stats](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#session-stats)

### Session.clientDevice

名称

種類

概要

例

type

ストリング

デバイスの種類。

"mobile"

software

ストリング

ブラウザ名かアプリケーション名。

"Chrome"

softwareVersion

ストリング

ブラウザ版かアプリケーション版。

"125.0"

operatingSystem

ストリング

オペレーティングシステム名。

"Android"

operatingSystemVersion

ストリング

OSのバージョン。

"17"

### Session.geolocation

名称

種類

概要

例

city

ストリング

市の名前。

"Dublin"

continent

ストリング

大陸コード。

"EU"

country

ストリング

国コード。

"IE"

region

ストリング

地域名か州名か。

"Leinster"

### Session.utm

名称

種類

概要

例

source

ストリング

UTMの情報源。

"newsletter"

medium

ストリング

UTM中介。

"email"

term

ストリング

UTMの用語です。

"productivity\_tools"

content

ストリング

UTMコンテンツ記述子。

"cta\_button\_top"

campaign

ストリング

UTMのキャンペーン名。

"july\_promo"

### セッション.統計

名称

種類

概要

例

referer

ストリング

ユーザーが現在のページにたどり着いた経緯。

"google.com"

firstPage

ストリング

最初のページは閲覧済み。

"home"

lastPage

ストリング

最後のページは閲覧しました。

"offers"

durationInSeconds

整数

セッションの時間は秒単位です。

18

eventTypeCount

地図

イベント数はイベントタイプごとにグループ化されています。

[参照 Session.stats.eventTypeCount](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#session-stats-eventtypecount)

### Session.stats.eventTypeCount

-   価値は顧客によって設定できます。以下にサンプルをご覧ください。

フィールド

種類

概要

例

pageViews

番号

ページビュー数。

5

contentClick

番号

コンテンツのクリック数。

11

search

番号

検索回数。

2

### イベント

名称

種類

概要

例

id

ストリング

イベントのシステム生成の一意識別子。

"123e4567-e89b-12d3-a456-426614174000"

sessionId

ストリング

セッション用の一意でシステム生成の識別子。

"123e4567-e89b-12d3-a456-426614174000"

createdAt

タイムスタンプ

イベント作成のタイムスタンプ。

"2026-05-20T14:22:31Z"

createdAtIso

ストリング

ISO-8601による作成タイムスタンプの表現。データ分割として使用されます。

"2026-05-20"

modifiedAt

タイムスタンプ

イベントの最後に更新されたタイムスタンプ。

"2026-05-20T14:30:00Z"

clientId

ストリング

プロファイルに関連付けられたクライアントまたはデバイス識別子。

"123e4567-e89b-12d3-a456-426614174000"

type

ストリング

顧客が許可したカスタムイベントを備えたSitecoreイベント用の事前定義リスト。

"pageView"、 "form"、 "identity"

siteId

ストリング

サイトまたはアプリケーション識別子。

"Sitecore"

channel

ストリング

セッションが行われた経路。

"web"、 "mobile"、 "mobileApp"、 "offline"

name

ストリング

イベントに関連するページやコンテンツ。 pageView のページ名や、コンテンツの読みやすい名前などが使われます。

"homepage"

language

ストリング

閲覧されているサイトやページの言語。送信可能なオプションパラメータ。

"en-US"

customData

地図

顧客は自身のビジネスニーズに応じてイベントに追加できるパラメータを用意しています。

[参照 Events.customData](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-customdata)

core

目的

SitecoreはeventTypeによって決定されるキーと値のペアを定義しました。

[参照 Events.core](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-core)

### Events.core

名称

種類

概要

例

pageView

目的

ページビューイベント。

[参照 Events.pageView](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-pageview)

form

目的

インタラクションイベントを形成しましょう。

[参照 Events.form](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-form)

search

目的

Search インタラクションイベント。

[参照 Events.search](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-search)

identity

目的

アイデンティティイベント。

[参照 Events.identity](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-identity)

### Events.customData

-   価値は顧客によって設定できます。以下にサンプルをご覧ください。

フィールド

種類

概要

サンプル

attribute

文字列、ブール、数、リスト、オブジェクト

カスタムデータ用の1つまたは複数の名前と値の組み合わせ属性。

{ "timeToComplete": 60, "formName": "Contact Us" }

### Events.pageView

名称

種類

概要

例

pageVariantId

ストリング

任意です。ページバリアントのID。

"main-page-1"

currency

ストリング

任意です。サイト訪問者が使用している通貨のアルファベット順通貨コード。設定されていない場合、このプロパティはペイロードの一部ではありません。

"eur"、 "gbp"、 "usd"

### イベント形式

名称

種類

概要

例

formId

ストリング

フォームのID。

"form\_123"

componentInstanceId

ストリング

SitecoreAIフォームを含むコンポーネントのUUID。A/B/nテストに使用されます。

"ac4109f5-9831-4abef-8005-647c70bfba01"

interactionType

ストリング

アクションの種類。

"submitted"、 "viewed"、 "interacted"

### Events.search

名称

種類

概要

例

componentId

ストリング

必須。ウィジェットの一意識別子。

"axfd3243252454"

componentInstanceId

ストリング

SitecoreAIフォームを含むコンポーネントのUUID。A/B/nテストに使用されます。

"ac4109f5-9831-4abef-8005-647c70bfba01"

interactionType

ストリング

アクションの種類。

"viewed", "clicked"

keyword

ストリング

サイト訪問者が検索フィールドに入力したテキストを検索で行いました。

"athletic sneakers"

nullResults

ブール値

検索キーワードで結果が返されたかどうかを示します。

false

### イベント.アイデンティティ

名称

種類

概要

例

currency

ストリング

任意です。サイト訪問者が使用している通貨のアルファベット順通貨コード。設定されていない場合、このプロパティはペイロードの一部ではありません。

"eur"、 "gbp"、 "usd"

contact

目的

プロフィールに関連する連絡先情報を含みます。

[参照 Events.identity.contact](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-identity-contact)

identifiers

配列

メールアドレスや電話番号など、プロファイルに関連付けられた識別子の集合。

[参照 Events.identity.identifiers](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-identity-identifiers)

### イベント.アイデンティティ.連絡先

名称

種類

概要

例

firstName

ストリング

個人の名前は空であってはならない。(1〜500文字)

"John"

lastName

ストリング

その人物の姓。(1〜500文字)

"Smith"

email

ストリング

ローカル部分、 @ 記号、ドメインを含む有効なメールアドレス形式。

"example@email.com"

dateOfBirth

日付

生年月日はISO 8601規格(YYYY-MM-DD)で、年、月、日を表します。

"1995-01-01"

gender

ストリング

個人の性別。フリーテキストは受け入れられますが、推奨される値のいずれかが推奨されます。  
  
推奨値は "male"、 "female"、 "unknown"、 "other"  
  
(1〜100文字)

"male"

language

ストリング

言語コードはISO 639-1形式で表され、大文字2文字で表されていました。

"EN"

title

ストリング

個人のためのタイトルは、フリーテキストでも指定された列挙値のいずれかでも構いません。  
  
推奨値: "Br"、 "Brigadier"、 "Capt"、 "Colonel"、 "Dame"、 "Dr"、 "Elder"、 "Fr"、 "General"、 "Hon"、 "Judge"、 "Lord"、 "Master"、 "Miss"、 "Mr"、 "Mrs"、 "Ms"、 "Mstr"、 "Prof"、 "Rabbi"、 "Rev"、 "Shaikha"、 "Sheikh"、 "Sir"、 "Sister"、 "Sr"  
  
(1〜100文字)

"Mr"

phoneNumbers

地図

自宅、職場、モバイルなど、さまざまな電話番号を構造化して表現したものです。

[詳細はEvents.identity.contact.phoneNumbersをご覧ください。](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-identity-contact-phonenumbers)

address

目的

通り、市、州、郵便番号を含む物理的な場所の構造化された表現。

[参照 Events.identity.contact.address](https://doc.sitecore.com/sai/ja/developers/sitecoreai/data-lake-export-service/data-entities-reference.html#events-identity-contact-address)

### イベント.アイデンティティ.contact.address

名称

種類

概要

例

street

ストリング

住所だ。(1〜500文字)

"12 Baker Street"

city

ストリング

その都市の名前。(1〜500文字)

"Madrid"

state

ストリング

州名や地域のこと。(1〜500文字)

"Colorado"

postCode

ストリング

郵便番号は国ごとにフォーマットされています。(1〜500文字)

"AB 123"

country

ストリング

国コードだ。 address がいる場合は必須です。フォーマット:ISO 3166-1 alpha-2

"ES"

### イベント・身分・連絡先電話番号

-   相互運用性のためにE.164の使用や、ローカルパターンのドキュメント作成を推奨します。
-   マップを開けて。価値は顧客によって設定できます。以下にサンプルをご覧ください。

名称

種類

概要

例

home

ストリング

自宅電話番号はE.164形式、または空の番号でも構いません。

"+34911222333"

work

ストリング

E.164形式の職場電話番号、または空の番号でもいいです。

"+34914445566"

mobile

ストリング

携帯電話番号はE.164形式、または空の番号もあります。

"+353861234567"

### Events.identity.identifiers

名称

種類

概要

例

provider

ストリング

[識別](https://doc.sitecore.com/sai/en/users/sitecoreai/audience-and-insights/identity-resolution/identity-rules.html)子の提供元を指定します。

"email"

id

ストリング

指定された providerに従ってフォーマットされた実際の識別子値。

"john.smith@sitecore.com"

^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b\_N6970cc9576a39:サイト訪問者があなたのブランドと関わる際に収集する、身元情報、個人情報、属性、SitecoreAI好みの記録です。

^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b\_N6970cca57a253:特定のチャネルで一定期間に起こるイベントのグループで、サイト訪問者とブランドの継続的なやり取りを表します。

^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b\_N696f54f334d35:セッション中にサイト訪問者があなたのサイト上で行うアクション。例えば、ウェブページの閲覧、ボタンのクリック、SitecoreAIフォームの提出、コンテンツ検索、その他追跡したいやり取りなどです。イベントがキャプチャされると、そのすべてのデータはSitecoreAIに送信され、利用可能になります。