ユニバーサルトラッカー構成

処理サービスの設定

Version:

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

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

処理サービスがどのようにインタラクションを処理するかを設定できます。例えば、2つ以上の処理サービスインスタンスがある場合、それぞれに異なるチャネルを選択して処理することができます。

!注Sitecoreユニバーサル処理サービスのウェブアプリケーションを開始するには、ウェブアプリケーションにリクエストが送信されていることを確認してください。処理サービスの状況を確認するには、ブラウザを開き <instance_name>/statusに移動します。

Universal Tracker(UT)には処理サービスの設定が5つあります。

!注パッチファイルを使って設定を変更してください。設定ファイルを直接編集しないでください。

設定ファイルは以下の通りです:

<website_name>\sitecore\Sitecore.Tracking.Processing.ChannelManagement\PipelinesConfig\channelTypes.json

この設定ファイルにはSitecoreで定義されたチャネルが含まれています。UT処理サービスはこれらのチャネルからのやり取りのみを処理します。

各チャンネルは以下の構造を持っています:
- Id - チャンネルのSitecoreアイテム固有の識別子。IDはSitecoreのマーケティングコントロールパネルで見つけられます。
  
  !注channelTypes.jsonのデフォルトのチャンネルIDが、実際のインストールIDと一致しない場合があります。チャネルを有効にするには、マーケティングコントロールパネルを開き、チャンネルのIDをコピーしてchannelTypes.jsonのチャンネルに貼り付けて正しいIDを入力してください。
- Name - チャンネル名。Sitecoreで設定されているチャンネル名とは異なる場合があります。
- TimeOut - 収集サービスがインタラクションをクローズドとしてマークした時を定義します。 TimeOutで定められた期間、アクティブなインタラクションが更新されない場合、コレクションサービスはインタラクションをクローズドとしてマークし、ストレージから取得して処理に送ります。
- Type - チャンネルタイプの完全限定名。
<website_name>\sitecore\Sitecore.Tracking.Processing.ChannelManagement\PipelinesConfig\channelTypeDefinitions.json

この構成ファイルには、特定のチャネルに対するプリフィルタ、エンリッチメント、ポストフィルタのパイプラインを定義するための拡張ポイントが含まれています。このファイルは以下の構造を持っています:
- Channels - パイプラインやプロセッサを持つ複数のチャネルグループ。グループは複数のチャネルに同時に設定を適用できます。これはチャネルIDをグループに追加することで行います。
- GroupName - チャンネルグループ名。グループに デフォルト名を付けると、グループ内の定義はグループに含まれていないチャンネルに使われます。グループ名を他にすると、その定義はグループの IDs 配列に含まれるチャンネルにのみ使われます。
- IDs - チャネルIDの配列。IDはchannelTypes.json ファイル内で定義されています。
- Type - 完全限定チャネルパイプライン名を使用するベースチャネルタイプ定義。
- PreFilters - 処理エンジンが実行する最初のパイプライン。パイプラインは2つのセクションで構成されています。
  - Type - 事前フィルタリングのパイプラインオブジェクトの完全修飾名。
  - Processors - プレフィルタリングパイプライン内で動作するプロセッサの配列。この配列をJSONで完全修飾名で含めることで拡張できます。
- Enrichment - 処理エンジンが実行する2番目のパイプライン。PreFilters パイプラインと同じセクションを含みます。
- PostFilters - 処理エンジンが実行する最終パイプライン。PreFilters パイプラインと同じセクションを含みます。
<website_name>\sitecore\Sitecore.Tracking.Processing.Engine\Config\config.xml

この設定ファイルには、処理エンジンを制御する基本的な設定が含まれています。設定は以下の通りです:
- Tracking.Processing.ProcessingInterval - 処理サービスがインタラクションを処理するかどうかを確認するまでの間隔の長さ(秒数)
- Tracking.Processing.InteractionTimeoutIncrement - チェックアウトされたインタラクションの処理試行間の分単位のバッファ。処理失敗が発生した場合、サービスはInteractionTimeoutIncrementが通過するまで再びインタラクションを処理しようとしません。
- Tracking.Processing.MaxConcurrency - プール内の労働者数。
- Tracking.Processing.BatchSize - 1回の反復で処理に含まれるインタラクションの数。
- Tracking.Processing.ProcessingThresholdPercent - 新しいバッチが開始されるインタラクション完了数の割合。
- xConnect.ServiceUrl - xConnectサービスへの接続文字列。xConnectサービスのホスト名を指定します。スケール環境では、代わりにxConnectの収集サイトを指定します。例えば、https://sc910xp1\_collection.
- xConnect.ClientCertificate - xConnectのクライアント証明書。例えば:
  
  StoreName=My;StoreLocation=LocalMachine;FindType=FindByThumbprint;FindValue=FF4637E7A2CACE7C0754E6B3C3552133E8E85614
  
  xConnectの証明書については、Sitecore Experience Platformインストールガイドで詳しく読むことができます。
  
  Azure展開の場合は、SSL設定のプライベート証明書セクションで証明書をアップロードする必要があります。自己署名証明書を使用する場合は、接続文字列にAllowInvalidClientCertificates=trueを加えてください:
  
  StoreName=My;StoreLocation=LocalMachine;FindType=FindByThumbprint;FindValue=756432701B71E1622C9CAA308DB39579ABC9C6C7;AllowInvalidClientCertificates=true
- xConnect.RequestTimeout - xConnectサーバーへのリクエストのタイムアウト。デフォルト値は2分です。
<website_name>\sitecore\Sitecore.Tracking.Processing.ChannelManagement\Config\config.xml.

この設定ファイルはChannelTypesConfigファイルとChannelDefinitionsConfigファイルのパスリンクを定義します。
<website_name>\sitecore\Sitecore.Tracking.SqlServer\Config\config.xml.

この設定ファイルはUT SQLの一部です。UT SQLデータベースへの接続を指定するConnectionStringが含まれています。

!注処理および回収サービスに関しては同じConnectionStringでなければなりません。

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