--- title: "コレクションモデル参照" slug: "collection-model-reference" abstract: "コアコレクションモデルの概要。" --- # コレクションモデル参照 コアコレクションモデルは、xDBによって収集された基本エンティティと属性で構成されています。コンタクトは、インタラクションが収集される個人を表します。デバイスプロファイルは、インタラクトがブランドとやり取りした際に使用されたブラウザや他のユーザーエージェントを示します。 xConnect Client APIの文脈でモデルを使用する方法については、以下をご覧ください: - [ファセット](https://doc.sitecore.com/xp/ja/developers/105/sitecore-experience-platform/facets.html "Facets") - [イベント](https://doc.sitecore.com/xp/ja/developers/105/sitecore-experience-platform/events.html "Events") ## コアコレクションモデル ![The Core Collection Model](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/105/sitecore-experience-platform/images/Core-Collection-Model1.png) コアコレクションモデルは、xDBによって収集された基本エンティティと属性で構成されています。 連絡先は、やり取りが収集される個人を表します。デバイスプロファイルは、連絡先がブランドとやり取りした際に使用されたブラウザや他のユーザーエージェントを示します。 ### 連絡先 ブランドと関わる個人を指定します。 このコンタクトは、さまざまなタイプの識別子を0つ以上設定できます。例えば、複数の匿名識別子を追加できます。1つは連絡先の再訪問を追跡でき、もう1つはDSPを通じて広告を追跡できます。 少なくとも1つの識別子タイプ=既知の識別子を持つ連絡先は、当システムでは既知の連絡先とみなされます。 #### id(guid) 必須、検索可能 連絡先の一意xDB識別子を指定します。 このフィールドは個人識別情報(PII)ではないため、デバッグシナリオで記録されることがあります。 #### LastModified (datetime) 必須、検索可能 この記録が最後に修正された時期を明記しています。 ### ContactIdentifier xDB外の連絡先を示すための別名や識別子を指定します。これらの識別子により、連絡先をCRMやその他の外部システムにリンクすることが可能になります。 一意制約:識別子+ソースはすべての接点で一意でなければなりません。接点識別子と送信元は大文字を区別します。 以下はすべての連絡先で有効です:ContactId |識別子|出典1 |TMI |dk\_activedirectory 1 |参考までに |dk\_activitedirectory 1 |920420204 |Twitter 2 |390248032|Twitter 以下の情報は無効です。なぜなら、同じ識別子と出典を持つ別の連絡先IDを持つことはできないからです。ContactID |識別子 |出典1 |TMI |dk\_activedirectory 1 |TMI |apple\_network 2 |TMI|apple\_network #### IdentifierType(IdentifierType) 必須、検索可能 識別子が表す識別子の種類を示します。 #### 識別子(文字列) 個人情報情報(PII)に敏感で必須 連絡先を外部システムにリンクする識別子を指定します。これはユーザー名、メールアドレス、Twitterハンドル、またはxDB内のすべての連絡先間で一意に識別できる他の識別子でも構いません。 値はPIIデータであり、ディスクに記録することはできません。 #### ソース(文字列) 必須、検索可能 識別子を保持するソースシステムを指定します。これは顧客が使用要件に応じて入力することを目的としています。 ### 相互作用 ウェブセッション、電話、または連絡先とブランド間のその他のやり取り中に行われた一連の活動を指定します。 このインタラクションは、EventListで指定されたイベントの順序を取り巻くメタデータを定義します。 StartDateTimeやEndDateTimeのようなプロパティは読み取り専用で、それぞれ最初のイベントと最後のイベントに基づいて計算されます。 #### id(guid) 必須 インタラクションの一意識別子を指定します。 #### DeviceProfileId (Nullable) 検索可能 このセッション中に使用されるデバイスのプロファイルを指定します。 #### CampaignId(無効化可能) 検索可能 この値は、そのやり取りに至ったキャンペーンのIDを示します。例えば、Google AdWordsのリンクをクリックすると、この値はAdWordsキャンペーンに関連付けられたキャンペーンIDに設定されます。 キャンペーンのメタデータ(名前や分類など)は、マーケティングオペレーションAPI - キャンペーンアクティビティ定義マネージャーから取得できます。 #### ChannelId(ガイド) 必須、検索可能 相互作用の発生源を示します。 名前やチャネルグループなどのメタデータは、マーケティングオペレーションAPI - チャネルタクソノミーマネージャーから取得可能です。 #### VenueId(無効化可能) 検索可能 相互作用の物理的な位置を指定します。 名前やグループなどのメタデータは、マーケティングオペレーションAPI - Venue Taxonomy Managerから取得可能です。 #### インティエーター(InteractionInitiator) 必須、検索可能 Value = 0 - 連絡先がやり取りを開始したことを示します。例:連絡先がウェブサイトや自宅のIoTデバイスを訪れると、その連絡先の代わりにインタラクションデータをプッシュします。 Value = 1 - ブランドがインタラクションを開始したことを示します。例:会社の営業担当者が連絡先に電話をかけたり、ExMからメールが送信された場合。 Value = 2 - は相互作用の発信者が不明であることを示します。 上記の値以外は無視すべきです。 #### StartDateTime(DateTime) 必須、検索可能 相互作用が開始された時刻を指定します。このフィールドは、イベントをタイムスタンプ順に順位付けしたシーケンスの最初のイベントに基づいて計算されるべきです。 #### EndDateTime(DateTime) 必須、検索可能 インタラクションがいつ終了したかを指定します。このフィールドはEventListの最後のイベントに基づいて計算されます。 #### EngagementValue(int) 必要検索可能 インタラクション中に累積された総エンゲージメント価値を指定します。これはすべてのイベントからのエンゲージメント価値の合計です。 #### UserAgent(文字列) 必須、検索可能 このやり取りを作成または追跡する際に使用するユーザーエージェントを指定します。 #### イベント(開催) 必要検索可能 相互作用中に発生したすべてのイベントを示します。順序はイベントのDateTimeで示されるため、イベントの保存順序は重要ではありません。 #### ラストモディファイド(DateTime) 必須、検索可能 このやり取りが変更された直近の日付を指定します。 > !注やり取りは編集できないため、この日付は常にレコード作成日を表します。 #### 期間(期間) インタラクションの持続時間を指定します。これはStartDateTimeとEndDateTimeに基づいて計算されたフィールドです。 ### イベント やり取り中に発生した接触のアクティビティを指定します。例としては、ウェブページのボタンをクリックしたり、モバイルアプリで右スワイプしたり、フォームを記入したり、商品を購入したりします。 イベントはタイムスタンプ順に並べられています。 イベントは目標や結果でもあり得ます。 #### カスタムバリューズ(Dictionary) このイベントに保存されたカスタム値を表現します。これはバージョン7.5〜8.2との後方互換性のために存在します。新しいデータを追加する場合は、イベントクラスから継承し、カスタム値のプロパティを追加することを検討してください。 #### データ(文字列) 検索可能 このイベントに保存されたカスタムデータを表現します。これはバージョン7.5〜8.2との後方互換性のために存在します。イベントクラスから継承し、カスタム値のプロパティを追加することを検討してください。 #### DataKey(文字列) 検索可能 このイベントに保存されたカスタムデータを表現します。これはバージョン7.5〜8.2との後方互換性のために存在します。イベントクラスから継承し、カスタム値のプロパティを追加することを検討してください。 #### DefinitionId(Guid) 必須、検索可能 このイベントを表す定義IDを指定します。これらのイベント定義の作成方法については、[マーケティングオペレーションAPI](https://doc.sitecore.com/xp/ja/developers/105/sitecore-experience-platform/marketing-operations-api.html "Marketing Operations API")をご覧ください。 #### 期間(期間) イベントがどれくらいの期間起こったかを示しています。 値が*0*なら、そのイベントは即時であったか、持続時間に意味がありません。 #### EngagementValue(int) 必須、検索可能 このイベントで獲得されたエンゲージメントポイントの数を指定します。注意:この値は必ずしもイベント定義に保存されたスコア値と一致しません。実装者が追跡を選択した場合、この値は設定可能です。 #### id(guid) 必須 このイベントの一意識別子を示します。 #### ParentEventId(Nullable) 検索可能 このイベントの親イベントを指定します。これはページビューイベントとそのページで発生したボタンクリックイベントを関連付ける際に有用です。 #### テキスト(文字列) 検索可能 このイベントのために保存された任意のカスタムテキストを表します。これはバージョン7.5〜8.2との後方互換性のために存在します。イベントクラスから継承し、カスタム値のプロパティを追加することを検討してください。 #### タイムスタンプ(DateTime) 必須、検索可能 イベントの発生時刻を示します。このフィールドで昇順に並べ替えて、出来事の年代順を決めてください。 #### ItemId(ガイド) ### デバイスプロファイル デバイスプロファイルは、特定のユーザーエージェントインスタンスとそれを使った直近の連絡先とのマッピングを指定します。つまり、IDはブラウザ上でクッキーとして保存され、匿名であっても返信した連絡先を識別するために使われます。 #### id(guid) 必須 デバイスプロファイルのIDを指定します。これはクッキーやモバイルデバイスのローカルストレージに保存され、新しいセッション開始時に最新の連絡先を再識別できます。 #### LastKnownContactId(ガイド) 必須 この装置を使用する際の直近の連絡先のIDを指定します。 #### ラストモディファイド(日付時間) 必須 この記録が最後に変更された時期を明記しています。 ### 目的 インタラクション中に接触者が実行する特別なアクションを指定します。 目標の名前や分類などのメタデータは、マーケティングオペレーションAPI - 目標定義マネージャーから取得できます。 ### 結果 通常、資金が移り交わされる重要な出来事を指定します。 アウトカムのメタデータ(名前や分類など)は、マーケティングオペレーションAPI - アウトカム定義マネージャーから取得できます。 #### CurrencyCode(文字列) 必須、検索可能 MonetaryValueで通貨の種類を指定します。値は[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)の有効なコードであるべきです。 #### 貨幣価値(小数点) 必須、検索可能 成果の財務的価値を指定します。例としては、電子商取引の総購入金額や、二つの法人間で締結された契約の価値があります。 ### インタラクションイニシエーター 相互作用の開始者の選択肢を示す列挙 #### コンタクト(int) 連絡先(または顧客)がやり取りを始めたことを示します。 #### ブランド(int) ブランドがやり取りを始めたことを示します。これは顧客に送られたメールや電話などです。 #### 不明(int) 発起人は不明です。 ### ContactIdentifierType 連絡先識別子の分類オプションを指定します。 #### 匿名(int) 関連する識別子が匿名であることを指定します。これは、連絡先を再識別したいが、まだ連絡可能なアドレス(メールアドレス、電話番号)で特定していない場合に役立ちます。 #### 既知(int) 関連する識別子が既知であることを示し、電話番号やメールアドレス、またはその他のアドレスから連絡先に連絡できることを意味します。 ### PageViewEvent 連絡先が特定のウェブページやコンテンツ項目を閲覧したことを示します。これは以前のバージョンでトラッカーにあったレガシーページコレクションに代わるものです。 #### ItemLanguage(文字列) 必須 閲覧するコンテンツの言語を指定します #### ItemVersion (int) 必須 閲覧されるコンテンツのバージョンを指定します #### URL(文字列) このイベント中にページにサービスを提供したリクエストの公開URLを示します。 この値がSitecoreによって設定されると、Analytics.TrackerでURLとQuerystringが保存されます。 #### SitecoreRenderingDevice (SitecoreDeviceData) ## コンタクトモデル - 価値の側面 図は接触モデルとすべてのデフォルト値の面を示しています: ![The value facets of the Contact Model](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/105/sitecore-experience-platform/images/Contact-Model---Value-Facets1.png) ### 同意情報 #### 同意(Dictionary) 個々の同意選択肢をキー(例:ウェブサイト名や処理の種類)と照らして保存します。各ConsentItemは日付と同意の選択肢(*0*または*1*)を定義します。 *1*は同意が与えられたことを示し、0は同意が取り消されたことを意味します。 ### 住所 連絡先の物理的な住所を示します。 #### AddressLine1(文字列) 個人情報・機密 住所の最初の行を指定します。 #### シティ(文字列) 検索可能 住所の都市を指定します。 #### StateOrProvince(文字列) 検索可能 住所の州を指定する。 #### 郵便番号(文字列) 検索可能 住所の郵便番号または郵便番号を指定します。 #### CountryCode(文字列) 検索可能 国別でISO 3166-alpha-2の2桁のISOコードを指定しています。 このコードを使うことで、マーケターは既存の標準を活用して私たちの条件に基づきセグメントを簡単に構築できます。 #### AddressLine2(文字列) 個人情報・機密 アドレスの任意の2行目を指定します。 #### AddressLine3(文字列) 個人情報・機密 アドレスの任意の3行目を指定します。 #### AddressLine4(文字列) 個人情報・機密 アドレスの任意の4行目を指定します。 #### ジオコロケーション(GeoCoordinate) 個人情報・機密 住所の地理座標を指定します。値は任意です。ブランドがそれらを埋め込むかどうかを決め、この値を使う必要があります。 ### アドレスリスト 住所のリストを指定します。 #### その他(Dictionary) 検索可能 この連絡先の他の物理アドレスのリストを指定します。キーは物理アドレスの識別子を定義します。例としては「職場」「自宅」「個人」などがあります #### PreferredAddress(アドレス) 必須、検索可能 #### PreferredKey(文字列) 必須、検索可能 優先アドレスを表すキーを指定します ### 連絡先 ブランドと関わる個人を指定します。 このコンタクトは、さまざまなタイプの識別子を0つ以上設定できます。例えば、複数の匿名識別子を追加できます。1つは連絡先の再訪問を追跡でき、もう1つはDSPを通じて広告を追跡できます。 少なくとも1つの識別子タイプ=既知の識別子を持つ連絡先は、当システムでは既知の連絡先とみなされます。 #### id(guid) 必須、検索可能 連絡先の一意xDB識別子を指定します。 このフィールドは個人識別情報(PII)ではないため、デバッグシナリオで記録されることがあります。 #### LastModified (datetime) 必須、検索可能 この記録が最後に修正された時期を明記しています。 ### ContactIdentifier xDB外の連絡先を示すための別名や識別子を指定します。これらの識別子により、連絡先をCRMやその他の外部システムにリンクすることが可能になります。 一意制約:識別子+ソースはすべての接点で一意でなければなりません。接点識別子と送信元は大文字を区別します。 以下はすべての連絡先で有効です:ContactId |識別子|出典1 |TMI |dk\_activedirectory 1 |参考までに |dk\_activitedirectory 1 |920420204 |Twitter 2 |390248032|Twitter 以下のものは無効です。同じ識別子と出典を持つ別の連絡先IDを持つことはできません。連絡先ID |識別子 |ソース1 |TMI |dk\_activedirectory 1 |TMI |apple\_network 2 |TMI|apple\_network #### IdentifierType(IdentifierType) 必須、検索可能 識別子が表す識別子の種類を示します。 #### 識別子(文字列) 個人情報情報(PII)に敏感で必須 連絡先を外部システムにリンクする識別子を指定します。これはユーザー名、メールアドレス、Twitterハンドル、またはxDB内のすべての連絡先間で一意に識別できる他の識別子でも構いません。 値はPIIデータであり、ディスクに記録することはできません。 #### ソース(文字列) 必須、検索可能 識別子を保持するソースシステムを指定します。これは顧客が使用要件に応じて入力することを目的としています。 ### 連絡先リスト購読 #### ListDefinitionId(ガイド) 必須、検索可能 連絡先が購読した連絡先リストのIDを指定します。このIDはマーケティングオペレーションAPI内のContactListDefinitionManagerによって定義されます #### 追加(日付時間) 必須、検索可能 この連絡先リストのメンバーシップが追加された時期を示しています #### LastModfied (Datetime) 必須、検索可能 このリストのメンバーシップが最後に変更された時期を示しています。 #### IsActive (bool) 必須、エアーカブル このリストのメンバーシップが有効かどうかを示します。 #### SourceDefinitionId(ガイド) 検索可能 連絡先がこのリストに追加された出典を示します。 ### メールアドレス #### SmtpAddress(文字列) 個人情報情報(PII)に敏感で必須 この連絡先にメールを送る際に使用するメールアドレスを指定します。 #### 検証済み(bool) 必須 メールが連絡先によって検証済みであることを示します。 #### BounceCount(int) このメールアドレスが何回不送り通知を受け取ったかを示しています。 ### メールアドレスリスト #### その他(Dictionary) 必須、検索可能 この連絡先のメールアドレス一覧を指定します。キーはそのメールアドレスの識別子を定義します。例としては「仕事用」「自宅」「個人用」などがあります。 #### PreferredEmail(メールアドレス) 個人情報情報(PII)に敏感で必須 連絡先の推奨メールアドレスを指定します。 #### PreferredKey(文字列) 必須、検索可能 エントリリスト内で希望するメールアドレスのキーを指定します。 ### 個人情報 #### 生年月日(無効化) 個人情報・機密 連絡先の生年月日を指定します。 #### ファーストネーム(文字列) 個人情報・機密 #### ジェンダー(文字列) 検索可能 連絡先の性別を指定します。 #### 職種名(文字列) 検索可能 #### ミドルネーム(文字列) 個人情報・機密 #### ニックネーム(文字列) 個人情報・機密 #### PreferredLanguage(文字列) 検索可能 この連絡先が好む言語を示します #### 接尾辞(文字列) 検索可能 含まれるものも含めます #### 姓(文字列) 個人情報・機密 #### タイトル(文字列) 検索可能 ### 電話番号 #### CountryCode(文字列) 必須、検索可能 国コードを示します。 #### 数(文字列) 必須 国コードと内線を除いた電話番号を示します。 #### エクステンション(文字列) 個人情報・機密 延長を示します。 ### 電話番号リスト #### その他(Dictionary) 検索可能 この連絡先のために保存される電話番号のリストを指定します。キーは電話番号の識別子を定義します。例としては「仕事場」「自宅」「モバイル」などがあります #### PreferredKey(文字列) 必須、検索可能 電話番号リスト内で希望する電話番号のキーを指定します #### PreferredPhoneNumber(電話番号) ### アバター 接触のサムネイル写真を示します。ただし、この側面を要求する際に、大きなペイロードで読み込むと接触データの読み込み時間が遅くなることがあります。これは主に接触の標準サイズサムネイルとして設計されています。 #### ピクチャー(バイト) 個人情報情報(PII)に敏感で必須 #### MimeType(文字列) 必須 ### リスト購読 この連絡先が属するすべての連絡先リストを示します #### 購読者数(リスト) 必須、検索可能 ### 自動化計画結果 #### AutomationPlanDefinitionId (Guid) 終了したプランの定義IDを示します #### ExitDateTime(datetime) 連絡先が終了した日付を指定します。 #### ActivityId(Guid) ### 自動化計画退出 連絡先が特定の自動化プランを終了したすべての時刻を記述するコレクションを含みます。 #### 結果(リスト) 検索可能 ### 分類 #### 分類レベル(int) 検索可能 #### オーバーライド分類レベル(int) 検索可能 システムが設定したClassificationLevelプロパティを上書きする明示的に設定された分類です。例えば、ロボットの検出は検出アルゴリズムに基づいて分類レベルを設定しますが、接触が誤って分類された場合はオーバーライド分類を設定することができます。 ### AutomationPlanEnrollmentCache この連絡先のための自動化プランのキャッシュを指定します。これは自動化プラン処理中のみ更新され、パーソナライズのために使用されます。 コンテキストキーはプランのインスタンスを指定し、開発者がMarketingAutomationClientからプランインスタンスの追加情報を検索できるようにするものと同じです。 #### 活動登録(リスト) ### 自動化計画活動登録キャッシュエントリ #### ActivityId(Guid) #### AutomationPlanDefinitionId (Guid) マーケティングオペレーションのAPIから自動化計画の定義IDを指定します #### ContextKey(文字列) #### CustomValues(Dictionary) 与えられた自動化プランのカスタム値。 #### PlanEntryDate(datetime) 連絡先が最初にPlanIDに入った日時を取得または設定します。 #### ActivityEntryDate(datetime) 連絡先がActivityIDを入力した日時を取得または設定します。 ### ジオコロケーション #### 緯度(ダブル) #### 経度(二重) ## 接触モデル - 計算されたファセット ![The calculated facets of the Contact Model](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/105/sitecore-experience-platform/images/Contact-Model---Calculated-Facets1.png) ### 連絡先行動プロフィール #### スコア(Dictionary) この連絡先のために収集されたProfileScoresのセット。鍵はMarketing Operations APIにあるProfile Definition IDです。 #### SourceInteractionStartDateTime (DateTime) は、最新の行動プロファイルが計算されたインタラクションの開始日時刻を示します。つまり、インタラクションが収集された際、この値は受信したインタラクションの開始日時と比較されます。この値が大きい場合は、コンタクト行動プロファイルは再計算されません。 ### 関与措置 #### TotalInteractionCount(整数) 必須、検索可能 この接触の合計インタラクション数を示します。 IContactSystemInfo.VisitCountの代わり。 #### TotalValue (int) 必須、検索可能 IContactSystemInfo.Valueの代わり。 #### 最近の交流開始日(DateTime) 連絡先からの直近のやり取り開始日時を示します。 #### 最近の交流時間(期間) 直近のやり取りの持続時間を示します。 #### 総インタラクション持続時間(時間帯) このコンタクトのすべての相互作用の総時間を示します。 #### 平均インタラクション持続時間(時間帯) このコンタクトの平均的なやり取り時間。 ### キービヘイビアキャッシュ #### キャンペーン(一覧) #### チャンネル(一覧) #### ゴール(リスト) #### 成果(リスト) #### PageEvents(リスト) #### 会場(リスト) #### CustomValues(リスト) キービヘイビアキャッシュに保存するカスタム値を示します。新規顧客にはこの方法の使用を推奨せず、計算されたファセットを使うことが推奨されます。 ### 連絡先 ブランドと関わる個人を指定します。 このコンタクトは、さまざまなタイプの識別子を0つ以上使えます。例えば、複数の匿名識別子を追加できます。1つは連絡先の再訪問を追跡でき、もう1つはDSPを通じて広告を追跡できます 少なくとも1つの識別子タイプ=既知の識別子を持つ連絡先は、当システムでは既知の連絡先とみなされます。 #### id(guid) 必須、検索可能 連絡先の一意xDB識別子を指定します。 このフィールドは個人識別情報(PII)ではないため、デバッグシナリオで記録されることがあります。 #### LastModified (datetime) 必須、検索可能 この記録が最後に修正された時期を明記しています。 ### KeyBehaviorCacheEntry(キービヘイビエーションキャッシュエントリー) KeyBehaviorCacheに単一のエントリを指定する #### データ(文字列) このキャッシュエントリに追加情報を指定します。この値は、開発者がキービビエーションキャッシュの利用を助けるためにあらゆる文脈情報を追加できるように存在します。例えば、キャッシュエントリが検索を表している場合、この情報は検索しているテキスト(例:「aston martin」で検索した場合)である可能性があります #### DateTime(DateTime) #### InteractionId(ガイド) このキャッシュエントリを埋めたインタラクションのIDを指定します。 #### DefinitionId(Guid) エントリのマーケティングオペレーション定義IDを指定します。 #### InteractionStartDateTime(DateTime) このキャッシュエントリに入力されたやり取りの開始日時刻を指定します。 ### プロフィールスコア セッション中にスコア化された行動プロファイルデータを指定します。 #### MatchedPatternId(Nullable) プロファイルでマッチしたパターンカードのIDを示します。このマッチングはトラッキング中または外部システムから行われます。xDBは処理および報告時に使用するためにマッチしたIDのみを保存します。 #### ProfileDefinitionId (Guid) マーケティングオペレーションAPIで定義されたプロファイル定義のIDを指定します。 #### スコア(ダブル) このプロファイルのすべての値の合計スコアを指定します。 #### スコアカウント(int) セッション中にプロファイルがスコアされた回数を指定します #### 価値(Dictionary) プロファイルキーのスコア値を指定します。キーはプロファイルキーID、値はスコアです。 ## インタラクションモデル - ウェブ訪問 ![Interaction-Model---Web-Visit1.png](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/105/sitecore-experience-platform/images/Interaction-Model---Web-Visit1.png) ### SitecoreDeviceData #### id(guid) デバイスを記述するSitecoreアイテムのIDを指定します。 #### 名前(文字列) 装置の名前を指定します。 ### ブラウザデータ #### BrowserVersion(文字列) ブラウザ版を指定しています。 #### BrowserMajorName(文字列) ブラウザの主要名称を指定します。 #### BrowserMinorName(文字列) ブラウザのマイナーネームを指定します。 ### 相互作用 ウェブセッション、電話、または連絡先とブランド間のその他のやり取り中に行われた一連の活動を指定します。 本質的には、このインタラクションはEventListで指定されたイベントの順序を取り巻くメタデータを定義します。 StartDateTime やEndDateTime のようなプロパティは読み取り専用で、それぞれ最初のイベントと最後のイベントに基づいて計算されます。 #### id(guid) 必須 インタラクションの一意識別子を指定します。 #### DeviceProfileId (Nullable) 検索可能 このセッション中に使用されるデバイスのプロファイルを指定します。 #### CampaignId(無効化可能) 検索可能 この値は、そのやり取りに至ったキャンペーンのIDを示します。つまり、Google AdWordsのリンクをクリックすると、この値はAdwordsキャンペーンに関連付けられたキャンペーンIDに設定されます。 キャンペーンのメタデータ(名前や分類など)は、マーケティングオペレーションAPI - キャンペーンアクティビティ定義マネージャーから取得できます。 #### ChannelId(ガイド) 必須、検索可能 相互作用の発生源を示します。 名前やチャネルグループなどのメタデータは、マーケティングオペレーションAPI - チャネルタクソノミーマネージャーから取得可能です。 #### VenueId(無効化可能) 検索可能 相互作用の物理的な位置を指定します。 名前やグループなどのメタデータは、マーケティングオペレーションAPI - Venue Taxonomy Managerから取得可能です。 #### インティエーター(InteractionInitiator) 必須、検索可能 Value = 1 - 連絡先がやり取りを開始したことを示します。例:連絡先がウェブサイトや自宅のIoTデバイスを訪れると、その連絡先の代わりにインタラクションデータをプッシュします。 Value = 2 - ブランドがやり取りを開始したことを示します。例:会社の営業担当者が連絡先に電話をかけたり、EXMからメールが送信された場合。 上記の値以外は無視すべきです。 #### StartDateTime(DateTime) 必須、検索可能 相互作用が開始された時刻を指定します。このフィールドは、イベントをタイムスタンプ順に順位付けしたシーケンスの最初のイベントに基づいて計算されるべきです。 #### EndDateTime(DateTime) 必須、検索可能 インタラクションがいつ終了したかを指定します。このフィールドはEventListの最後のイベントに基づいて計算されます。 #### EngagementValue(int) 必須、検索可能 インタラクション中に累積された総エンゲージメント価値を指定します。これはすべてのイベントからのエンゲージメント価値の合計です。 #### UserAgent(文字列) 必須、検索可能 このやり取りを作成または追跡する際に使用するユーザーエージェントを指定します。 #### イベント(開催) 必須、検索可能 相互作用中に発生したすべてのイベントを示します。順序はイベントのDateTimeで示されるため、イベントの保存順序は重要ではありません。 #### ラストモディファイド(DateTime) 必須、検索可能 このやり取りが変更された直近の日付を指定します。 > !注やり取りは編集できません。したがって、この日付は常にレコードが作成された日付を表します。 #### 期間(期間) インタラクションの持続時間を指定します。これはStartDateTimeとEndDateTimeに基づいて計算されたフィールドです。 ### IpInfo コンタクトのネットワークエントリーポイントを記述するメタデータを指定します。 GeoIPデータから得られています。 これは正式にはGeoIPのWhoisInformationでした。 これはPIIデータです。したがって、ディスクに記録することはできません。 #### AreaCode(文字列) 検索可能 #### BusinessName(文字列) 検索可能 #### シティ(文字列) 検索可能 #### カントリー(文字列) 検索可能 #### Dns(文字列) 検索可能 #### IpAddress(文字列) 個人情報情報(PII)に敏感で必須 #### isp(文字列) 検索可能 #### 緯度(無効化) 個人情報・機密 #### 経度(無効化可能) 個人情報・機密 #### MetroCode(文字列) 検索可能 #### 郵便番号(文字列) 検索可能 #### リージョン(文字列) 検索可能 #### URL(文字列) 検索可能 #### LocationId(Nullable) この相互作用のIpInformationに基づく派生位置を示します ### ウェブ訪問 情報は、私たちがインタラクションを収集した際に収集したものです。 #### 言語(文字列) 検索可能 サイトのコンテキスト言語に設定します。 ブランドは、コンタクトが異なる言語を選択する場合、ウェブセッション中にこの値を設定すべきです。 #### OperatingSystem (OperatingSystemData) 検索可能 #### リファラー(文字列) 検索可能 > !注この分野にPII機密データが存在する可能性もあります。 #### ReferringSite(文字列) 検索可能 (今後のリリースでは時代遅れになる可能性があります。) #### スクリーン(ScreenData) #### Searchキーワード(文字列) 検索可能 検索エンジンや他のサイトからウェブセッション開始時に入力される検索キーワードの種。 #### SiteName(文字列) 検索可能 #### ブラウザ(BrowserData) 検索可能 #### IsSelfReferrer (bool) 訪問が同じ訪問サイトから紹介されているかどうかを示します。 ### ScreenData #### ScreenHeight(直訳) 画面の高さを指定します。 #### ScreenWidth(int) 画面幅を指定します。 ### OperatingSystemData #### メジャーバージョン(文字列) #### マイナーバージョン(文字列) #### 名前(文字列) ### プロフィールスコア セッション中にスコア化された行動プロファイルデータを指定します。 #### MatchedPatternId(Nullable) プロファイルでマッチしたパターンカードのIDを示します。このマッチングはトラッキング中または外部システムから行われます。xDBは処理および報告時に使用するためにマッチしたIDのみを保存します。 #### ProfileDefinitionId (Guid) マーケティングオペレーションAPIで定義されたプロファイル定義のIDを指定します。 #### スコア(ダブル) このプロファイルのすべての値の合計スコアを指定します。 #### スコアカウント(int) セッション中にプロファイルがスコアされた回数を指定します。 #### 価値(Dictionary) 特定のプロファイルのプロファイルキーのスコア値を指定します。キーはプロファイルキーID、値はスコアです。 ### イベント やり取り中に起こる接触から起こる活動を指定します。例えば、ウェブページのボタンをクリックしたり、モバイルアプリで右スワイプしたり、フォームを記入したり、商品を購入したりします。 イベントはタイムスタンプ順に並べられています。 イベントは目標や結果でもあり得ます。 #### CustomValues(Dictionary) このイベントのために保存された任意のカスタム値を表現します。これはバージョン7.5〜8.2との後方互換性のために存在します。新しいデータを追加する場合は、イベントクラスから継承し、カスタム値のプロパティを追加することを検討してください。 #### データ(文字列) 検索可能 このイベントに保存されたカスタムデータを表現します。これはバージョン7.5〜8.2との後方互換性のために存在します。イベントクラスから継承し、カスタム値のプロパティを追加することをおすすめします。 #### DataKey(文字列) 検索可能 このイベントに保存されたカスタムデータを表現します。これはバージョン7.5〜8.2との後方互換性のために存在します。イベントクラスから継承し、カスタム値のプロパティを追加することを検討してください。 #### DefinitionId(Guid) 必須、検索可能 このイベントを表す定義IDを指定します。これらのイベント定義の作成方法については[Marketing Operations API](https://doc.sitecore.com/xp/ja/developers/105/sitecore-experience-platform/marketing-operations-api.html "Marketing Operations API")を参照してください。 #### 期間(期間) イベントがどれくらいの期間起こったかを示しています。 値が*0*なら、そのイベントは即時であったか、持続時間に意味がありません。 #### EngagementValue(int) 必須、検索可能 このイベントで獲得したエンゲージメントポイントの数を指定します。 > !注この値は、イベント定義で格納されたスコア値と必ずしも一致しません。実装者がトラッキングを選択した場合は設定可能です。 #### id(guid) 必須 このイベントの一意識別子を示します。 #### ParentEventId(Nullable) 検索可能 このイベントの親イベントを指定します。これは、ページビューイベントとそのページで発生したボタンクリックイベントを関連付ける際に有用です。 #### テキスト(文字列) 検索可能 このイベントのために保存された任意のカスタムテキストを表します。これはバージョン7.5〜8.2との後方互換性のために存在します。イベントクラスから継承し、カスタム値のプロパティを追加することを検討してください。 #### タイムスタンプ(DateTime) 必須、検索可能 イベントの発生時刻を示します。このフィールドで昇順に並べ替えて、イベントの時系列を決定できます。 #### ItemId(ガイド) ### PageViewEvent 連絡先が特定のウェブページやコンテンツ項目を閲覧したことを示します。これは以前のバージョンでトラッカーにあったレガシーページコレクションに代わるものです。 #### ItemLanguage(文字列) 必須 閲覧するコンテンツの言語を指定します #### ItemVersion (int) 必須 閲覧されるコンテンツのバージョンを指定します #### URL(文字列) このイベント中にページにサービスを提供したリクエストの公開URLを示します。 この値がSitecoreによって設定されると、Analytics.TrackerでURLとQuerystringが保存されます。 #### SitecoreRenderingDevice (SitecoreDeviceData) ### 結果 通常、資金が移り交わされる重要な出来事を指定します。 アウトカムのメタデータ(名前や分類など)は、マーケティングオペレーションAPI - アウトカム定義マネージャーから取得できます。 #### CurrencyCode(文字列) 必須、検索可能 MonetaryValueで通貨の種類を指定します。値は[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)の有効なコードであるべきです。 #### 貨幣価値(小数点) 必須、検索可能 成果の財務的価値を指定します。例としては、電子商取引の総購入金額や、二つの法人間で締結された契約の価値があります。 ### 目的 インタラクション中に接触者が実行する特別なアクションを指定します。 目標の名前や分類などのメタデータは、マーケティングオペレーションAPI - 目標定義マネージャーから取得できます。 ### 連絡先 ブランドと関わる個人を指定します。 このコンタクトは、さまざまなタイプの識別子を0つ以上使えます。例えば、複数の匿名識別子を追加できます。1つは連絡先の再訪問を追跡でき、もう1つはDSPを通じて広告を追跡できます 少なくとも1つの識別子タイプ=既知の識別子を持つ連絡先は、当システムでは既知の連絡先とみなされます。 #### id(guid) 必須、検索可能 連絡先の一意xDB識別子を指定します。 このフィールドは個人識別情報(PII)ではないため、デバッグシナリオで記録されることがあります。 #### LastModified (datetime) 必須、検索可能 この記録が最後に修正された時期を明記しています。 ### UserAgentInfo ユーザーエージェントのプロパティを定義します。 > !注これは意図的に最小限のプロパティセットであり、ディスク容量の使用を最小限に抑えつつセグメンテーションをサポートしています。追加のプロパティが必要な場合は、ユーザーエージェントに基づくデバイス検出クエリを利用できます。 #### デバイスタイプ(文字列) デバイスの種類(例:メディアプレーヤー、携帯電話、タブレット)を指定します。 #### DeviceVendor(文字列) 特定のユーザーエージェントのデバイスベンダーを指定します。 #### DeviceVendorHardwareModel (文字列) デバイスベンダーからの正式なモデル名を指定しています。 #### CanSupportTouchScreen(ブール) デバイスがタッチスクリーンに対応しているかどうかを指定します。 ### プロフィールスコア #### スコア(Dictionary) 必須、検索可能 ### ロケインフォ 相互作用が発生した際の接触場所特有の性質のセットを指定します。 #### ジオコロケーション(GeoCoordinate) 個人情報・機密 相互作用の開始時にGeoCoordinatesを指定します。 #### TimezoneOffset(タイムスパン) 検索可能 接点の時間帯はUTCから分数オフセットされます。これにより、接点がイベントを行った現地時刻を計算できます。 ### ジオコロケーション #### 緯度(ダブル) #### 経度(二重) ### キャンペーンイベント #### キャンペーン定義ID(ガイド) 起動されたキャンペーンを示します。 ### ダウンロードイベント #### ItemId(ガイド) ダウンロードされたコンテンツ項目のIDを示します。 ### SearchEvent #### キーワード(文字列) 検索に使われるキーワードを指定します。