1. xConnectモデル

コレクションモデルリファレンス

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

コア コレクション モデルは、xDBによって収集された基本エンティティと属性で構成されます。連絡先は、インタラクションが収集される個人を表します。デバイスプロファイルは、コンタクトがブランドと対話したときに使用されたブラウザまたはその他のユーザーエージェントを示します。

xConnect Client APIのコンテキストでモデルを使用する方法については、以下を参照してください。

コアコレクションモデル

The Core Collection Model

コア コレクション モデルは、xDBによって収集された基本エンティティと属性で構成されます。

連絡先は、インタラクションが収集される個人を表します。デバイスプロファイルは、コンタクトがブランドと対話したときに使用されたブラウザまたはその他のユーザーエージェントを示します。

接触

ブランドと対話する個々の人物を指定します。

連絡先は、さまざまなタイプの0個以上のIDを有効にします。例えば、複数の匿名識別子を追加することができます - 1つは連絡先の再訪問を追跡することができ、もう1つはDSPを介して広告を追跡することができます。

識別子の種類 = 既知の識別子が少なくとも1つある連絡先は、システム内で既知の連絡先と見なされます。

ID(グイド)

必須、検索可能

コンタクトの一意のxDB識別子を指定します。

このフィールドはPIIではないため、デバッグ シナリオでログに記録できます。

LastModified (日時)

必須、検索可能

このレコードが最後に変更された時刻を指定します。

連絡先識別子

xDBの外部にあるコンタクトを示すために使用されるエイリアスまたは識別子を指定します。これらの識別子により、連絡先をCRMまたはその他の外部システムにリンクすることができます。

一意性制約: 識別子 + ソースは、すべての連絡先で一意である必要があります。連絡先識別子とソースでは、大文字と小文字が区別されます。

以下はすべての連絡先で有効です: ContactId |識別子|ソース1 |TMIの|dk_activedirectory 1 |参考までに |dk_activitedirectory 1 |920420204 |ツイッター2 |390248032|囀る

以下は、同じ識別子とソースを持つ別の連絡先IDを持つことはできないため、無効です。連絡先ID |識別子 |ソース1 |TMIの|dk_activedirectory 1 |TMIの|apple_network 2 |TMI|apple_network

IdentifierType (識別子タイプ)

必須、検索可能

識別子によって表される識別子の種類を示します。

識別子 (文字列)

PIIセンシティブ、必須

連絡先を外部システムにリンクするIDを指定します。これには、ユーザー名、メール アドレス、Twitterハンドル、またはxDB内のすべてのコンタクトでコンタクトを一意に識別するその他の識別子を指定できます。

値はPIIデータであり、ディスクにログに記録することはできません。

ソース (文字列)

必須、検索可能

識別子を保持するソース・システムを指定します。これは、お客様が使用要件に応じて入力することを目的としています。

相互作用

Webセッション、電話、または連絡先とブランド間のその他のインタラクション中に行われた一連のアクティビティを指定します。

インタラクションは、EventListで指定されたイベントのシーケンスを囲むメタデータを定義します。

StartDateTimeEndDateTimeなどのプロパティは読み取り専用で、値はそれぞれ最初と最後のイベントに基づいて計算されます。

ID(グイド)

必須

インタラクションの一意の識別子を指定します。

デバイスプロファイルID (Nullable<Guid>)

検索

この対話のセッション中に使用されるデバイスのプロファイルを指定します。

キャンペーンID (Nullable<Guid>)

検索

インタラクションにつながったキャンペーンのIDを示します。したがって、Google AdWordsからリンクをクリックすると、この値はAdWordsキャンペーンに関連付けられたキャンペーンIDに設定されます。

キャンペーンの名前や分類などのメタデータは、Marketing Operations API - Campaign Activity Definition Managerから取得できます。

ChannelId (Guid) (チャネルID (GUID))

必須、検索可能

インタラクションのソースを示します。

名前やチャネル グループなどのメタデータは、Marketing Operations API - Channel Taxonomy Managerから取得できます。

会場ID (Nullable<Guid>)

検索

インタラクションの物理的な位置を指定します。

名前やグループなどのメタデータは、Marketing Operations API - Venue Taxonomy Managerから取得できます。

インティエーター (InteractionInitiator)

必須、検索可能

Value = 0 - コンタクトがインタラクションを開始したことを示します。例: 連絡先がWebサイトまたは連絡先の自宅にあるIoTデバイスにアクセスした場合、連絡先に代わって対話データをプッシュした場合。

Value = 1 - ブランドがインタラクションを開始したことを示します。例: 会社の営業担当者が連絡先に電話をかけたり、ExMからメールが送信されたりした場合。

Value = 2 - インタラクションのインスティテーターが不明であることを示します。

上記以外の値は無視してください。

StartDateTime (日付時刻)

必須、検索可能

インタラクションがいつ開始されたかを指定します。このフィールドは、イベントがタイムスタンプの昇順で順序付けられているシーケンスの最初のイベントに基づいて計算する必要があります。

EndDateTime (日付時刻)

必須、検索可能

インタラクションがいつ終了したかを指定します。このフィールドは、EventListの最後のイベントに基づいて計算されます。

EngagementValue (整数)

必須検索可能

インタラクション中に蓄積されたエンゲージメント値の合計を指定します。これは、すべてのイベントのエンゲージメント値の合計です。

UserAgent (文字列)

必須、検索可能

このインタラクションを作成または追跡するときに使用するユーザーエージェントを指定します。

イベント (ICollection<Event>)

必須検索可能

インタラクション中に発生したすべてのイベントを示します。順序はイベントのDateTimeで示されるため、格納されているイベントの順序は重要ではありません。

LastModified (日時)

必須、検索可能

このインタラクションが変更された最新の日時を指定します。

メモ

インタラクションは編集できないため、この日付は常にレコードが作成された日時を表します。

期間(タイムスパン)

インタラクションの継続時間を指定します。これは、StartDateTimeとEndDateTimeに基づく計算フィールドです。

出来事

インタラクション中に発生するコンタクトからのアクティビティを指定します。例としては、Webページ上のボタンのクリック、モバイル アプリの右スワイプ、フォームの入力、製品の購入などがあります。

イベントはタイムスタンプ順に並べられます。

イベントは、目標や結果である場合もあります。

CustomValues (Dictionary<string, string>)

このイベントに格納されているカスタム値を表します。これは、バージョン7.5から8.2との下位互換性を保つために存在します。新しいデータを追加する場合は、イベント クラスから継承し、カスタム値のプロパティを追加することを検討する必要があります。

データ (文字列)

検索

このイベントに格納されている任意のカスタム データを表します。これは、バージョン7.5から8.2との下位互換性を保つために存在します。イベント クラスから継承し、カスタム値のプロパティを追加することを検討する必要があります。

DataKey (文字列)

検索

このイベントに格納されている任意のカスタム データを表します。これは、バージョン7.5から8.2との下位互換性を保つために存在します。イベント クラスから継承し、カスタム値のプロパティを追加することを検討する必要があります。

DefinitionId (Guid) (定義ID (グイド))

必須、検索可能

このイベントを表す定義IDを指定します。これらのイベント定義の作成方法については、Marketing Operations APIを参照してください。

期間(タイムスパン)

イベントが発生した時間を示します。

値が0の場合、イベントは即時であったか、期間に意味がありませんでした。

EngagementValue (整数)

必須、検索可能

このイベントで獲得したエンゲージメントポイントの数を指定します。注: この値は、イベント定義に格納されたスコア値と常に一致するとは限りません。これは、実装者が決定した場合、追跡中に設定できます。

ID(グイド)

必須

このイベントの一意の識別子を示します。

親イベントID (Nullable<Guid>)

検索

このイベントの親イベントを指定します。これは、ページビューイベントをそのページで発生したボタンクリックイベントに関連付ける場合に便利です。

テキスト (文字列)

検索

このイベントに格納されている任意のカスタム テキストを表します。これは、バージョン7.5から8.2との下位互換性を保つために存在します。イベント クラスから継承し、カスタム値のプロパティを追加することを検討する必要があります。

タイムスタンプ (DateTime)

必須、検索可能

イベントが発生した日時を示します。このフィールドで昇順で並べ替えて、イベントの時系列順を決定する必要があります。

ItemId (グイド)

デバイスプロファイル

デバイスプロファイルは、特定のユーザーエージェントインスタンスと、それを使用する最新の連絡先との間のマッピングを指定します。つまり、IDはブラウザにCookieとして保存され、匿名であっても再返信する連絡先を識別するために使用できます。

ID(グイド)

必須

デバイス プロファイルのIDを指定します。これは、モバイルデバイスのCookieまたはローカルストレージに保存して、新しいセッションを開始したときに最新の連絡先を再識別できます。

LastKnownContactId (Guid)

必須

このデバイスを使用する最新の連絡先のIDを指定します。

LastModified (日時)

必須

このレコードが最後に変更された時刻を指定します。

ゴール

インタラクション中に連絡先が実行する特別なアクションを指定します。

目標の名前や分類などのメタデータは、Marketing Operations API - Goal Definition Managerから取得できます。

結果

通常はお金が持ち主を変える重要なイベントを指定します。

結果のメタデータ (名前や分類など) は、Marketing Operations API - Outcome Definition Managerから取得できます。

CurrencyCode (文字列)

必須、検索可能

MonetaryValueの通貨の種類を指定します。値は、ISO 4217の有効なコードである必要があります。

MonetaryValue (10進数)

必須、検索可能

結果の財務的価値を指定します。例としては、電子商取引の合計購入額や、2つの法人間で締結された契約の価値などがあります。

インタラクションイニシエーター

インタラクションの開始側のオプションを示す列挙体

連絡先 (int)

コンタクト (または顧客) がインタラクションを開始したことを示します。

ブランド (int)

ブランドがインタラクションを開始したことを示します。これは、顧客に送信される電子メールまたは電話である可能性があります。

不明 (int)

イニシエータが不明です。

ContactIdentifierType (連絡先識別子タイプ)

連絡先識別子を分類するためのオプションを指定します。

匿名 (int)

関連付けられた識別子が匿名であることを指定します。これは、連絡先を再識別したい場合に役立ちますが、まだ到達可能なアドレス(メールアドレス、電話番号など)を特定していません。

既知 (int)

関連付けられた識別子が既知であることを示し、電話番号、電子メールアドレス、またはその他のアドレスを介して連絡先に連絡できることを意味します。

ページビューイベント

連絡先が特定のWebページまたはコンテンツ項目をいつ表示したかを示します。これは、以前のバージョンのトラッカーにあった従来のページコレクションに代わるものです。

ItemLanguage (文字列)

必須

表示するコンテンツ項目の言語を指定します

ItemVersion (整数)

必須

表示されるコンテンツアイテムのバージョンを指定します

URL (文字列)

このイベント中にページを提供した要求の公開URLを示します。

この値がSitecoreによって設定されている場合。Analytics.Trackerの場合、URLとクエリ文字列が保存されます。

SitecoreRenderingDevice (SitecoreDeviceData)

コンタクトモデル - バリューファセット

この図は、問い合わせモデルとすべてのデフォルト値ファセットを示しています。

The value facets of the Contact Model

同意事項

同意事項 (Dictionary<string, ConsentItem>)

キー (Webサイトの名前や処理の種類など) に対する個々の同意の選択肢を格納します。各ConsentItemは、日付と同意の選択肢 (0または1) を定義します。 1は同意が与えられたことを意味し、0は同意が取り消されたことを意味します。

住所

連絡先の物理アドレスを示します。

AddressLine1 (文字列)

PIIセンシティブ

アドレスの最初の行を指定します。

市区町村 (文字列)

検索

住所の市区町村を指定します。

StateOrProvince (文字列)

検索

住所の都道府県を指定します。

PostalCode (文字列)

検索

住所の郵便番号を指定します。

CountryCode (文字列)

検索

国のISO 3166-alpha-2の2桁のISOコードを指定します。

このコードを使用すると、マーケターは既存の標準を使用して、当社の条件でセグメントを簡単に構築できます。

AddressLine2 (文字列)

PIIセンシティブ

アドレスの2行目 (オプション) を指定します。

AddressLine3 (文字列)

PIIセンシティブ

アドレスの3行目 (オプション) を指定します。

AddressLine4 (文字列)

PIIセンシティブ

アドレスの4行目 (オプション) を指定します。

GeoCoordinate (ジオコーディネート)

PIIセンシティブ

住所の地理座標を指定します。値はオプションです。ブランドは、この値を入力して使用するかどうかを決定する必要があります。

アドレスリスト

アドレスの一覧を指定します。

その他(辞書<文字列、住所>)

検索

この連絡先のその他の物理アドレスの一覧を指定します。キーは、物理アドレスの識別子を定義します。例としては、「仕事」、「自宅」、「個人」などがあります

PreferredAddress (アドレス)

必須、検索可能

PreferredKey (文字列)

必須、検索可能

優先アドレスを表すキーを指定します

接触

ブランドと対話する個々の人物を指定します。

連絡先は、さまざまなタイプの0個以上のIDを有効にします。例えば、複数の匿名識別子を追加することができます - 1つは連絡先の再訪問を追跡することができ、もう1つはDSPを介して広告を追跡することができます。

識別子の種類 = 既知の識別子が少なくとも1つある連絡先は、システム内で既知の連絡先と見なされます。

ID(グイド)

必須、検索可能

コンタクトの一意のxDB識別子を指定します。

このフィールドはPIIではないため、デバッグ シナリオでログに記録できます。

LastModified (日時)

必須、検索可能

このレコードが最後に変更された時刻を指定します。

連絡先識別子

xDBの外部にあるコンタクトを示すために使用されるエイリアスまたは識別子を指定します。これらの識別子により、連絡先をCRMまたはその他の外部システムにリンクすることができます。

一意性制約: 識別子 + ソースは、すべての連絡先で一意である必要があります。連絡先識別子とソースでは、大文字と小文字が区別されます。

以下はすべての連絡先で有効です: ContactId |識別子|ソース1 |TMIの|dk_activedirectory 1 |参考までに |dk_activitedirectory 1 |920420204 |ツイッター2 |390248032|囀る

以下は、同じ識別子とソースを持つ別の連絡先IDを持つことはできないため、無効です。連絡先ID |識別子 |ソース1 |TMIの|dk_activedirectory 1 |TMIの|apple_network 2 |TMI|apple_network

IdentifierType (識別子タイプ)

必須、検索可能

識別子によって表される識別子の種類を示します。

識別子 (文字列)

PIIセンシティブ、必須

連絡先を外部システムにリンクするIDを指定します。これには、ユーザー名、メール アドレス、Twitterハンドル、またはxDB内のすべてのコンタクトでコンタクトを一意に識別するその他の識別子を指定できます。

値はPIIデータであり、ディスクにログに記録することはできません。

ソース (文字列)

必須、検索可能

識別子を保持するソース・システムを指定します。これは、お客様が使用要件に応じて入力することを目的としています。

ContactListサブスクリプション

ListDefinitionId (Guid)

必須、検索可能

連絡先が購読している連絡先リストのIDを指定します。このIDは、Marketing Operations APIにあるContactListDefinitionManagerによって定義されます

追加 (日時)

必須、検索可能

この連絡先リストのメンバーシップがいつ追加されたかを示します

LastModfied (日時)

必須、検索可能

このリストのメンバーシップが最後に変更された時刻を示します。

IsActive (ブール)

必須、アーカイブ可能

このリスト メンバーシップがアクティブかどうかを示します。

SourceDefinitionId (Guid) (英語)

検索

連絡先がこのリストに追加されたソースを示します。

メールアドレス

SmtpAddress (文字列)

PIIセンシティブ、必須

この連絡先にメールを送信するときに使用するメールアドレスを指定します。

検証済み (bool)

必須

Eメールが連絡先によって検証されたことを示します。

バウンスカウント (int)

このメールアドレスがバウンス通知を受信した回数を示します。

メールアドレスリスト

その他 (Dictionary<string,EmailAddress>)

必須、検索可能

この連絡先のメールアドレスの一覧を指定します。キーは、そのメールアドレスの識別子を定義します。例としては、「仕事」、「自宅」、「個人」などがあります

PreferredEmail (メールアドレス)

PIIセンシティブ、必須

連絡先の優先メールアドレスを指定します。

PreferredKey (文字列)

必須、検索可能

エントリのリスト内の優先メールアドレスのキーを指定します。

個人情報

生年月日 (Nullable<Datetime>)

PIIセンシティブ

連絡先の生年月日を指定します。

FirstName (文字列)

PIIセンシティブ

性別 (文字列)

検索

連絡先の性別を指定します。

JobTitle (文字列)

検索

MiddleName (文字列)

PIIセンシティブ

ニックネーム (文字列)

PIIセンシティブ

PreferredLanguage (文字列)

検索

この連絡先が好む言語を示します

サフィックス (文字列)

検索

以下を含めることができます

姓 (文字列)

PIIセンシティブ

タイトル (文字列)

検索

電話番号

CountryCode (文字列)

必須、検索可能

国コードを示します。

数値 (文字列)

必須

国番号と内線番号を除いた電話番号を示します。

拡張子 (文字列)

PIIセンシティブ

拡張子を示します。

電話番号リスト

その他 (辞書<文字列、電話番号>)

検索

この連絡先に保存されている電話番号の一覧を指定します。キーは、電話番号の識別子を定義します。たとえば、「仕事」、「自宅」、「モバイル」などです

PreferredKey (文字列)

必須、検索可能

電話番号のリスト内で優先する電話番号のキーを指定します

PreferredPhoneNumber (電話番号)

アバター

連絡先のサムネイル写真を示します。これを大きなペイロードでロードすると、このファセットをリクエストするときに連絡先データの読み込み時間が遅くなる可能性があることに注意してください。これは主に、連絡先の標準サイズのサムネイルとして設計されています。

画像 (byte)

PIIセンシティブ、必須

MimeType (文字列)

必須

リストサブスクリプション

この連絡先が属するすべての連絡先リストを示します

サブスクリプション (List<ContactListSubscription>)

必須、検索可能

AutomationPlanResult (オートメーションプランの結果)

AutomationPlanDefinitionId (Guid)

終了したプランの定義IDを示します

ExitDateTime (日付時刻)

連絡先が終了した日時を指定します。

ActivityId (Guid) (アクティビティID (GUID))

オートメーションプラン終了

連絡先が特定の自動化プランから退出するたびに説明するコレクションが含まれます。

結果 (List<AutomationPlanResult>)

検索

分類

ClassificationLevel (整数)

検索

OverrideClassificationLevel (整数)

検索

システムによって設定されたClassificationLevelプロパティをオーバーライドする、明示的に設定された分類。たとえば、ロボット検出は検出アルゴリズムに基づいて分類レベルを設定しますが、接触が誤って分類された場合はオーバーライド分類を設定できます。

AutomationPlanEnrollmentCache

この連絡先の自動化プランのキャッシュを指定します。これは、自動化計画の処理中にのみ更新され、パーソナライゼーションに使用されます。

コンテキスト キーは、プランのインスタンスを指定するものと同じで、開発者はMarketingAutomationClientからプラン インスタンスの追加の詳細を検索できます。

アクティビティ登録 (List<AutomationPlanActivityEnrollmentCacheEntry>)

AutomationPlanActivityEnrollmentCacheEntry

ActivityId (Guid) (アクティビティID (GUID))

AutomationPlanDefinitionId (Guid)

マーケティング操作APIからオートメーション計画定義IDを指定します

ContextKey (文字列)

CustomValues (Dictionary<string,string>)

特定のオートメーション プランのカスタム値。

PlanEntryDate (日時)

連絡先が最初にPlanIdを入力した日時を取得または設定します。

ActivityEntryDate (日時)

連絡先がActivityIdを入力した日時を取得または設定します。

ジオコーディネート

緯度 (倍精度)

経度(倍精度)

コンタクトモデル - 計算済みファセット

The calculated facets of the Contact Model

ContactBehaviorProfile (連絡先行動プロファイル)

スコア (Dictionary<Guid, ProfileScore>)

この連絡先に対して収集されたProfileScoresのセット。キーは、Marketing Operations APIにあるプロファイル定義IDです。

SourceInteractionStartDateTime (日時)

インタラクションの開始日時で、最新の行動プロファイルが計算された時刻を示します。つまり、インタラクションが収集されると、この値は受信インタラクションの開始日時と比較されます。この値が大きい場合、問い合わせ行動プロファイルは再計算されません。

エンゲージメント対策

TotalInteractionCount (整数)

必須、検索可能

この連絡先の合計インタラクション数を示します。

IContactSystemInfo.VisitCountを置き換えます。

TotalValue (整数)

必須、検索可能

IContactSystemInfo.Valueを置き換えます。

MostRecentInteractionStartDateTime (日付時刻)

連絡先からの最新のインタラクションの開始日時を示します。

MostRecentInteractionDuration (タイムスパン)

最新のインタラクションの時間を示します。

TotalInteractionDuration (タイムスパン)

この連絡先のすべてのインタラクションの合計時間を示します。

AverageInteractionDuration (タイムスパン)

すべてのインタラクションにおけるこの連絡先の平均インタラクション時間。

キービヘイビアキャッシュ

キャンペーン (List<KeyBehaviorCacheEntry>)

チャンネル (List<KeyBehaviorCacheEntry>)

ゴール (List<KeyBehaviorCacheEntry>)

アウトカム (List<KeyBehaviorCacheEntry>)

ページイベント (List<KeyBehaviorCacheEntry>)

会場 (List<KeyBehaviorCacheEntry>)

カスタム値 (List<KeyBehaviorCacheEntry>)

キー動作キャッシュに格納されるカスタム値を示します。新規のお客様はこれを使用することはお勧めしませんが、計算されたファセットを使用することはお勧めしません。

接触

ブランドと対話する個々の人物を指定します。

連絡先は、さまざまなタイプの0個以上のIDを有効にします。例えば、複数の匿名識別子を追加することができます - 1つは連絡先の再訪問を追跡することができ、もう1つはDSPを介して広告を追跡することができます

識別子の種類 = 既知の識別子が少なくとも1つある連絡先は、システム内で既知の連絡先と見なされます。

ID(グイド)

必須、検索可能

コンタクトの一意のxDB識別子を指定します。

このフィールドはPIIではないため、デバッグ シナリオでログに記録できます。

LastModified (日時)

必須、検索可能

このレコードが最後に変更された時刻を指定します。

KeyBehaviorCacheEntry

KeyBehaviorCacheの1つのエントリを指定します

データ (文字列)

このキャッシュ・エントリーの追加情報を指定します。この値は、開発者がキー動作キャッシュの使用を支援するために、あらゆる種類のコンテキスト情報を追加できるようにするために存在します。たとえば、キャッシュエントリが検索を表している場合、この情報は検索対象のテキストである可能性があります(つまり、ユーザーが「aston martin」を検索した)

DateTime (日付時刻)

InteractionId (Guid)

このキャッシュエントリを入力したインタラクションのIDを指定します。

DefinitionId (Guid) (定義ID (グイド))

エントリのマーケティング操作定義IDを指定します。

InteractionStartDateTime (日付時刻)

このキャッシュエントリを入力したインタラクションの開始日時を指定します。

プロフィールスコア

セッション中にスコアリングされる行動プロファイル データを指定します。

マッチパターンID (Nullable<Guid>)

プロファイルに一致したパターンカードのIDを示します。この照合は、追跡中または外部システムから行われます。xDBは、処理およびレポート作成時に使用するために、一致したIDのみを保存します。

ProfileDefinitionId (Guid)

Marketing Operations APIで定義されたプロファイル定義のIDを指定します。

スコア(ダブル)

このプロファイルのすべての値の合計スコアを指定します。

ScoreCount (整数)

セッション中にプロファイルがスコアリングされた回数を示します

値 (Dictionary<Guid, double>)

特定のプロファイルのプロファイル キーのスコア値を指定します。キーはプロファイル キー IDで、値はスコアです。

インタラクションモデル - Web Visit

SitecoreDeviceData (サイトコアデバイスデータ)

ID(グイド)

デバイスを説明するSitecoreアイテムのIDを指定します。

名前 (文字列)

デバイスの名前を指定します。

ブラウザデータ

BrowserVersion (文字列)

ブラウザのバージョンを指定します。

BrowserMajorName (文字列)

ブラウザのメジャー名を指定します。

BrowserMinorName (文字列)

ブラウザのマイナー名を指定します。

相互作用

Webセッション、電話、または連絡先とブランド間のその他のインタラクション中に行われた一連のアクティビティを指定します。

基本的に、インタラクションは、EventListで指定されたイベントのシーケンスを囲むメタデータを定義します。

StartDateTime EndDateTime などのプロパティは読み取り専用で、値はそれぞれ最初と最後のイベントに基づいて計算されます。

ID(グイド)

必須

インタラクションの一意の識別子を指定します。

デバイスプロファイルID (Nullable<Guid>)

検索

この対話のセッション中に使用されるデバイスのプロファイルを指定します。

キャンペーンID (Nullable<Guid>)

検索

インタラクションにつながったキャンペーンのIDを示します。つまり、Google Adwordsからのリンクをクリックすると、この値はAdwordsキャンペーンに関連付けられたキャンペーンIDに設定されます。

キャンペーンの名前や分類などのメタデータは、Marketing Operations API - Campaign Activity Definition Managerから取得できます。

ChannelId (Guid) (チャネルID (GUID))

必須、検索可能

インタラクションのソースを示します。

名前やチャネル グループなどのメタデータは、Marketing Operations API - Channel Taxonomy Managerから取得できます。

会場ID (Nullable<Guid>)

検索

インタラクションの物理的な位置を指定します。

名前やグループなどのメタデータは、Marketing Operations API - Venue Taxonomy Managerから取得できます。

インティエーター (InteractionInitiator)

必須、検索可能

Value = 1 - コンタクトがインタラクションを開始したことを示します。例: 連絡先がWebサイトまたは連絡先の自宅にあるIoTデバイスにアクセスした場合、連絡先に代わって対話データをプッシュした場合。

Value = 2 - ブランドがインタラクションを開始したことを示します。例: 会社の営業担当者が連絡先に電話をかけたり、EXMからメールが送信されたりした場合。

上記以外の値は無視してください。

StartDateTime (日付時刻)

必須、検索可能

インタラクションがいつ開始されたかを指定します。このフィールドは、イベントがタイムスタンプの昇順で順序付けられているシーケンスの最初のイベントに基づいて計算する必要があります。

EndDateTime (日付時刻)

必須、検索可能

インタラクションがいつ終了したかを指定します。このフィールドは、EventListの最後のイベントに基づいて計算されます。

EngagementValue (整数)

必須、検索可能

インタラクション中に蓄積されたエンゲージメント値の合計を指定します。これは、すべてのイベントのエンゲージメント値の合計です。

UserAgent (文字列)

必須、検索可能

このインタラクションを作成または追跡するときに使用するユーザーエージェントを指定します。

イベント (ICollection<Event>)

必須、検索可能

インタラクション中に発生したすべてのイベントを示します。順序はイベントのDateTimeで示されるため、格納されているイベントの順序は重要ではありません。

LastModified (日時)

必須、検索可能

このインタラクションが変更された最新の日時を指定します。

手記

インタラクションは編集できません。したがって、この日付は常にレコードが作成された日時を表します。

期間(タイムスパン)

インタラクションの継続時間を指定します。これは、StartDateTimeとEndDateTimeに基づく計算フィールドです。

イップインフォ

連絡先のネットワーク エントリ ポイントを記述するメタデータを指定します。

GeoIPデータから取得されます。

これは正式にはGeoIPからのWhoisInformationでした。

これはPIIデータです。したがって、ディスクにログを記録することはできません。

AreaCode (文字列)

検索

BusinessName (文字列)

検索

市区町村 (文字列)

検索

国 (文字列)

検索

Dns (文字列)

検索

IpAddress (文字列)

PIIセンシティブ、必須

isp (文字列)

検索

緯度 (Nullable<double>)

PIIセンシティブ

経度 (Nullable<double>)

PIIセンシティブ

MetroCode (文字列)

検索

PostalCode (文字列)

検索

地域 (文字列)

検索

URL (文字列)

検索

ロケーションID (Nullable<Guid>)

このインタラクションのIpInformationに基づいて派生した位置を示します

ウェブ訪問

インタラクションを収集する際に収集された情報。

言語 (文字列)

検索

サイトのコンテキスト言語に設定します。

ブランドは、コンタクトが別の言語を選択した場合、ウェブセッション中にこの値を設定する必要があります。

OperatingSystem (OperatingSystemData)

検索

リファラー (文字列)

検索

手記

このフィールドにはPII機密データが含まれている可能性があります。

ReferringSite (文字列)

検索

(将来のリリースで廃止される可能性があります。

画面(ScreenData)

SearchKeywords (文字列)

検索

検索エンジンまたは他のサイトから受信する検索キーワードをWebセッションの開始時に種分けします。

SiteName (文字列)

検索

ブラウザ (BrowserData)

検索

IsSelfReferrer (ブール)

Web訪問が、訪問を提供しているのと同じWebサイトから参照されたかどうかを示します。

スクリーンデータ

ScreenHeight (整数)

画面の高さを指定します。

ScreenWidth (整数)

画面の幅を指定します。

オペレーティングシステムデータ

MajorVersion (文字列)

MinorVersion (文字列)

名前 (文字列)

プロフィールスコア

セッション中にスコアリングされる行動プロファイル データを指定します。

マッチパターンID (Nullable<Guid>)

プロファイルに一致したパターンカードのIDを示します。この照合は、追跡中または外部システムから行われます。xDBは、処理およびレポート作成時に使用するために、一致したIDのみを保存します。

ProfileDefinitionId (Guid)

Marketing Operations APIで定義されたプロファイル定義のIDを指定します。

スコア(ダブル)

このプロファイルのすべての値の合計スコアを指定します。

ScoreCount (整数)

セッション中にプロファイルがスコアリングされた回数を指定します。

値 (Dictionary<Guid,double>)

特定のプロファイルのプロファイル キーのスコア値を指定します。キーはプロファイル キー IDで、値はスコアです。

出来事

インタラクション中に発生するコンタクトからのアクティビティを指定します。たとえば、Webページ上のボタンをクリックしたり、モバイル アプリを右にスワイプしたり、フォームに入力したり、製品を購入したりします。

イベントはタイムスタンプ順に並べられます。

イベントは、目標や結果である場合もあります。

CustomValues (Dictionary<string,string>)

このイベントに格納されているカスタム値を表します。これは、バージョン7.5から8.2との下位互換性を保つために存在します。新しいデータを追加する場合は、イベント クラスから継承し、カスタム値のプロパティを追加することを検討する必要があります。

データ (文字列)

検索

このイベントに格納されている任意のカスタム データを表します。これは、バージョン7.5から8.2との下位互換性を保つために存在します。イベント クラスから継承し、カスタム値のプロパティを追加することを検討することをお勧めします。

DataKey (文字列)

検索

このイベントに格納されている任意のカスタム データを表します。これは、バージョン7.5から8.2との下位互換性を保つために存在します。イベント クラスから継承し、カスタム値のプロパティを追加することを検討する必要があります。

DefinitionId (Guid) (定義ID (グイド))

必須、検索可能

このイベントを表す定義IDを指定します。これらのイベント定義の作成方法については、Marketing Operations APIを参照してください。

期間(タイムスパン)

イベントが発生した時間を示します。

値が0の場合、イベントは即時であったか、期間に意味がありませんでした。

EngagementValue (整数)

必須、検索可能

このイベントで獲得したエンゲージメントポイントの数を指定します。

手記

この値は、イベント定義に格納されているスコア値と常に一致するとは限りません。これは、実装者が決定した場合、追跡中に設定できます。

ID(グイド)

必須

このイベントの一意の識別子を示します。

親イベントID (Nullable<Guid>)

検索

このイベントの親イベントを指定します。これは、ページビューイベントをそのページで発生したボタンクリックイベントに関連付ける場合に便利です。

テキスト (文字列)

検索

このイベントに格納されている任意のカスタム テキストを表します。これは、バージョン7.5から8.2との下位互換性を保つために存在します。イベント クラスから継承し、カスタム値のプロパティを追加することを検討する必要があります。

タイムスタンプ (DateTime)

必須、検索可能

イベントが発生した日時を示します。このフィールドで昇順に並べ替えて、イベントの時系列順を決定できます。

ItemId (グイド)

ページビューイベント

連絡先が特定のWebページまたはコンテンツ項目をいつ表示したかを示します。これは、以前のバージョンのトラッカーにあった従来のページコレクションに代わるものです。

ItemLanguage (文字列)

必須

表示するコンテンツ項目の言語を指定します

ItemVersion (整数)

必須

表示されるコンテンツアイテムのバージョンを指定します

URL (文字列)

このイベント中にページを提供した要求の公開URLを示します。

この値がSitecoreによって設定されている場合。Analytics.Trackerの場合、URLとクエリ文字列が保存されます。

SitecoreRenderingDevice (SitecoreDeviceData)

結果

通常はお金が持ち主を変える重要なイベントを指定します。

結果のメタデータ (名前や分類など) は、Marketing Operations API - Outcome Definition Managerから取得できます。

CurrencyCode (文字列)

必須、検索可能

MonetaryValueの通貨の種類を指定します。値は、 ISO 4217の有効なコードである必要があります。

MonetaryValue (10進数)

必須、検索可能

結果の財務的価値を指定します。例としては、電子商取引の合計購入額や、2つの法人間で締結された契約の価値などがあります。

ゴール

インタラクション中に連絡先が実行する特別なアクションを指定します。

目標の名前や分類などのメタデータは、Marketing Operations API - Goal Definition Managerから取得できます。

接触

ブランドと対話する個々の人物を指定します。

連絡先は、さまざまなタイプの0個以上のIDを有効にします。例えば、複数の匿名識別子を追加することができます - 1つは連絡先の再訪問を追跡することができ、もう1つはDSPを介して広告を追跡することができます

識別子の種類 = 既知の識別子が少なくとも1つある連絡先は、システム内で既知の連絡先と見なされます。

ID(グイド)

必須、検索可能

コンタクトの一意のxDB識別子を指定します。

このフィールドはPIIではないため、デバッグ シナリオでログに記録できます。

LastModified (日時)

必須、検索可能

このレコードが最後に変更された時刻を指定します。

ユーザーエージェント情報

ユーザーエージェントのプロパティを定義します。

手記

これは、セグメンテーションをサポートしながらディスク領域の使用量を最小限に抑えるための最小限のプロパティ セットです。追加のプロパティが必要な場合は、ユーザー エージェントに基づいてデバイス検出をクエリできます。

DeviceType (文字列)

デバイスのタイプ(メディアプレーヤー、携帯電話、タブレットなど)を指定します。

DeviceVendor (文字列)

指定されたユーザーエージェントのデバイスベンダーを種分けします。

DeviceVendorHardwareModel (文字列)

デバイスのベンダーからの完全なモデル名を指定します。

CanSupportTouchScreen(ブール)

デバイスがタッチ スクリーンをサポートするかどうかを指定します。

プロフィールスコア

スコア (Dictionary<Guid,ProfileScore>)

必須、検索可能

ロケール情報

インタラクションが発生したときの連絡先のロケールに固有のプロパティのセットを指定します。

GeoCoordinate (ジオコーディネート)

PIIセンシティブ

インタラクションの開始時のGeoCoordinatesを指定します。

TimezoneOffset (タイムスパン)

検索

連絡先のタイムゾーンがUTCからオフセットされている分数。これを使用して、連絡先がイベントを実行した現地時間を計算することができます。

ジオコーディネート

緯度 (倍精度)

経度(倍精度)

キャンペーンイベント

CampaignDefinitionId (グイド)

トリガーされたキャンペーンを示します。

ダウンロードイベント

ItemId (グイド)

ダウンロードされたコンテンツ項目IDを示します。

SearchEvent (検索イベント)

キーワード (文字列)

検索に使用するキーワードを指定します。

この記事を改善するための提案がある場合は、 お知らせください!