データエンティティ参照
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要機能の利用可能性は段階的に展開される一環です。あなたの組織はまだこの機能に気づいていないかもしれません。環境が導入された際に利用可能になります。
現在、データレイクエクスポートサービスで利用可能なデータには、プロファイル^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b_N6970cc9576a39、セッション^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b_N6970cca57a253、イベント^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b_N696f54f334d35が含まれます。このページでは、各サポートデータエンティティの属性や型について説明しています。このリファレンスは、エクスポートされたデータに対してクエリ、レポート、統合を作成する際に活用してください。
エンティティ関係図
以下の図は、データレイクエクスポートサービスデータエンティティ間の関係を示しています。
データエンティティ参照
以下の表は、エクスポートされたデータに現れるデータエンティティとその属性を説明しています。
プロフィール
名称
種類
概要
例
id
ストリング
プロファイルの一意でシステム生成の識別子。
"123e4567-e89b-12d3-a456-426614174000"
createdAt
タイムスタンプ
システム生成のタイムスタンプで、プロファイルが最初に作成された時期を示します。
"2020-09-08T16:17
.000Z"modifiedAt
タイムスタンプ
システム生成のタイムスタンプは、プロファイルが最後に更新されたことを示しています。
"2020-09-08T16:17
.000Z"lastSeenAt
タイムスタンプ
システム生成のタイムスタンプで、プロファイルが最後に見られた日を示す。
"2020-09-08T16:17
.000Z"type
ストリング
プロファイルの種類を指定し、 identified または visitorのいずれかです。
"identified"
contact
目的
プロフィールに関連する連絡先情報を含みます。
identifiers
配列
メールアドレスや電話番号など、プロファイルに関連付けられた識別子の集合。
{ "provider": "email", "id": "[email protected]" }
clientIds
配列
プロファイルに関連付けられたユーザーIDのリスト。
"f3a9c2e4-7b8d-4c2a-9f1e-8a6d3b2c9e1a"
extensions
地図
カスタムゲスト属性。
traits
目的
プロフィールやセッションに関連する様々な特性を保持するための自由な構造。
audiences
目的
プロフィールが属するセグメントやオーディエンスに関する情報。
プロフィール.contact(プロフィール).contact
名称
種類
概要
例
firstName
ストリング
個人の名前は空であってはならない。(1〜500文字)
"John"
lastName
ストリング
その人物の姓。(1〜500文字)
"Smith"
ストリング
ローカル部分、 @ 記号、ドメインを含む有効なメールアドレス形式。
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
address
目的
通り、市、州、郵便番号を含む物理的な場所の構造化された表現。
プロフィール.contact.address
名称
種類
概要
例
street
ストリング
住所だ。(1〜500文字)
"12 Baker Street"
city
ストリング
その都市の名前。(1〜500文字)
"Madrid"
state
ストリング
州名や地域のこと。(1〜500文字)
"Colorado"
postCode
ストリング
郵便番号は国ごとにフォーマットされています。(1〜500文字)
"AB 123"
country
ストリング
国コードだ。 address がいる場合は必須です。フォーマット
3166-1 alpha-2"ES"
プロフィール.連絡先.電話番号
- 相互運用性のためにE.164の使用や、ローカルパターンのドキュメント作成を推奨します。
- マップを開けて。価値は顧客によって設定できます。以下にサンプルをご覧ください。
名称
種類
概要
例
home
ストリング
自宅電話番号はE.164形式、または空の番号でも構いません。
"+34911222333"
work
ストリング
E.164形式の職場電話番号、または空の番号でもいいです。
"+34914445566"
mobile
ストリング
携帯電話番号はE.164形式、または空の番号もあります。
"+353861234567"
Profile.identifiers
名称
種類
概要
例
provider
ストリング
識別子の提供元を指定します。
"email"
id
ストリング
指定された providerに従ってフォーマットされた実際の識別子値。
Profile.traits
名称
種類
概要
例
affinities
地図
ページビューに基づくシステム生成の親和性スコア。
プロフィール.traits.affinities
- 顧客が定義した アフィニティ 信号をネストされたマップ構造に保存します。
- グループ名や値名は動的で顧客ごとに定義されています。固定スキーマフィールドを持つのは葉オブジェクトだけです。
- 第一段階のキーは親和群名です(例: "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
"Profile.audiences
名称
種類
概要
例
segmentMembership
配列
プロフィールが属するセグメントや オーディエンス に関する情報。
"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
.000Z"createdAtIso
ストリング
ISO-8601による作成タイムスタンプの表現。データ分割として使用されます。
"2026-01-08"
modifiedAt
タイムスタンプ
セッションが最後に更新されたタイムスタンプ。
"2026-01-08T16:17
.000Z"clientId
ストリング
プロファイルに関連付けられたユーザー識別子。
"123e4567-e89b-12d3-a456-426614174000"
siteId
ストリング
サイトまたはアプリケーション識別子。
"SpinAir"
channel
ストリング
セッションが行われた経路。
"Web"
status
ストリング
セッションの現状。
"Closed"
language
ストリング
閲覧されているサイトやページの言語。イベントから送信・導出できるオプションパラメータ。
"EN"
clientDevice
目的
デバイス情報。
geolocation
目的
位置情報。
utm
目的
UTMの帰属データ。
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
- 価値は顧客によって設定できます。以下にサンプルをご覧ください。
フィールド
種類
概要
例
pageViews
番号
ページビュー数。
5
contentClick
番号
コンテンツのクリック数。
11
search
番号
検索回数。
2
イベント
名称
種類
概要
例
id
ストリング
イベントのシステム生成の一意識別子。
"123e4567-e89b-12d3-a456-426614174000"
sessionId
ストリング
セッション用の一意でシステム生成の識別子。
"123e4567-e89b-12d3-a456-426614174000"
createdAt
タイムスタンプ
イベント作成のタイムスタンプ。
"2026-05-20T14:22
"createdAtIso
ストリング
ISO-8601による作成タイムスタンプの表現。データ分割として使用されます。
"2026-05-20"
modifiedAt
タイムスタンプ
イベントの最後に更新されたタイムスタンプ。
"2026-05-20T14:30
"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
地図
顧客は自身のビジネスニーズに応じてイベントに追加できるパラメータを用意しています。
core
目的
SitecoreはeventTypeによって決定されるキーと値のペアを定義しました。
Events.core
名称
種類
概要
例
pageView
目的
ページビューイベント。
form
目的
インタラクションイベントを形成しましょう。
search
目的
Search インタラクションイベント。
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
目的
プロフィールに関連する連絡先情報を含みます。
identifiers
配列
メールアドレスや電話番号など、プロファイルに関連付けられた識別子の集合。
イベント.アイデンティティ.連絡先
名称
種類
概要
例
firstName
ストリング
個人の名前は空であってはならない。(1〜500文字)
"John"
lastName
ストリング
その人物の姓。(1〜500文字)
"Smith"
ストリング
ローカル部分、 @ 記号、ドメインを含む有効なメールアドレス形式。
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をご覧ください。
address
目的
通り、市、州、郵便番号を含む物理的な場所の構造化された表現。
イベント.アイデンティティ.contact.address
名称
種類
概要
例
street
ストリング
住所だ。(1〜500文字)
"12 Baker Street"
city
ストリング
その都市の名前。(1〜500文字)
"Madrid"
state
ストリング
州名や地域のこと。(1〜500文字)
"Colorado"
postCode
ストリング
郵便番号は国ごとにフォーマットされています。(1〜500文字)
"AB 123"
country
ストリング
国コードだ。 address がいる場合は必須です。フォーマット
3166-1 alpha-2"ES"
イベント・身分・連絡先電話番号
- 相互運用性のためにE.164の使用や、ローカルパターンのドキュメント作成を推奨します。
- マップを開けて。価値は顧客によって設定できます。以下にサンプルをご覧ください。
名称
種類
概要
例
home
ストリング
自宅電話番号はE.164形式、または空の番号でも構いません。
"+34911222333"
work
ストリング
E.164形式の職場電話番号、または空の番号でもいいです。
"+34914445566"
mobile
ストリング
携帯電話番号はE.164形式、または空の番号もあります。
"+353861234567"
Events.identity.identifiers
名称
種類
概要
例
provider
ストリング
識別子の提供元を指定します。
"email"
id
ストリング
指定された providerに従ってフォーマットされた実際の識別子値。
^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b_N6970cc9576a39
、身元情報、個人情報、属性、SitecoreAI好みの記録です。^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b_N6970cca57a253
、サイト訪問者とブランドの継続的なやり取りを表します。^UUID-047340c1-aea9-f89f-7381-15c571a5bb4b_N696f54f334d35
。例えば、ウェブページの閲覧、ボタンのクリック、SitecoreAIフォームの提出、コンテンツ検索、その他追跡したいやり取りなどです。イベントがキャプチャされると、そのすべてのデータはSitecoreAIに送信され、利用可能になります。