1. Universal Trackerの設定

カスタムxConnectモデルの構成

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

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

このセクションは、収集サービスと処理サービスの両方に適用されます。

既定では、.NET Coreはアプリケーション内のすべてのアセンブリ ファイルを直接読み込みません。カスタム タイプ名を含むコンフィギュレーションを追加する場合 (カスタムxConnectモデルを登録する場合など) は、タイプを含むアセンブリをロードするようにアプリケーションを構成する必要があります。

メモ

カスタムxConnectモデルは、xConnectサーバーのようにJSONファイルとしてデプロイされるのではなく、アセンブリとしてデプロイされます。

Sitecoreホスト アプリケーションでxConnectモデルを設定するには、次の手順に従います。

  1. sitecoreruntimeフォルダーに、現在の環境と同じ名前の新しいフォルダーを作成します。デフォルトはProductionです。たとえば、開発環境を構成する場合は、Development.

  2. アセンブリを環境フォルダsitecoreruntime\<environment>にコピーします。

  3. これで、構成を追加してxConnect構成を拡張し、カスタムxConnectモデルを含めることができます。configフォルダ内にファイルを追加し、xConnectModels.xmlなどの名前を付けます。

  4. xConnectModels.xmlファイル内に、次の内容を追加します。

    <Settings>
        <XConnect>
            <Models>
                <Custom>
                    <TypeName>UTDemo.XConnectExtensions.CampaignModel, UTDemo.XConnectExtensions</TypeName>
                    <PropertyName>Model</PropertyName>
                </Custom>
            </Models>
        </XConnect>
    </Settings>

    このコードは、UTDemo.XConnectExtensions.CampaignModelクラスによって提供されるカスタムxConnectモデルを登録します。

呼び出し元がカスタムxConnectモデル イベントを使用できるようにするには、イベントのマッピングを提供する必要があります。デフォルトのマッピングは、\sitecore\Sitecore.Tracking\Config\config.xmlファイルで提供されます。マッピングをパッチファイルに追加する必要があります。

  1. configフォルダに新しいファイルを追加し、eventMappings.xmlなどの名前を付けます。

  2. カスタムイベントマッピングを、\sitecore\Sitecore.Tracking\Config\config.xmlファイルと同じノード構造を使用して設定ファイルに追加します。この例では、cgというカスタムイベントタイプを追加します。

    <Settings>
        <Sitecore.Tracking>
            <TypeMappings>
                <cg>UTDemo.XConnectExtensions.CustomGoal, UTDemo.XConnectExtensions</cg>
            </TypeMappings>
        </Sitecore.Tracking>
    </Settings>

呼び出し元は、イベントのtypecgに設定して、そのイベントの種類を登録できるようになりました。たとえば、クライアントは次のHTTP要求を送信できます。

{
"type":"cg",
"DefinitionId":"ffb4e611-a73d-4a95-b20a-811d295bdfff",
"Timestamp":"2018-08-09T11:54:56.853Z",
"TrackingInteractionId":"6d7f175a-d328-4729-bf35-599b06acc19e"	
}
この記事を改善するための提案がある場合は、 お知らせください!