1. Universal Trackerの設定

処理サービスを構成する

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

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

処理サービスがインタラクションを処理する方法を構成できます。たとえば、2つ以上の処理サービス・インスタンスがある場合、処理するチャネルごとに異なるチャネルを選択できます。

メモ

Sitecore Universal Processing Service Webアプリケーションを起動するには、リクエストがWebアプリケーションに送信されていることを確認してください。処理サービスのステータスを確認するには、ブラウザーを開いて <instance_name>/statusに移動します。

Universal Tracker (UT) の処理サービスの設定を含む5つの設定ファイルがあります。

手記

パッチファイルを使用して構成を変更します。設定ファイルを直接編集しないでください。

設定ファイルは次のとおりです。

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

    この設定ファイルには、Sitecoreで定義されているチャネルが含まれています。UT処理サービスは、これらのチャネルからのインタラクションのみを処理します。

    各チャネルの構造は次のとおりです。

    • Id - チャネルのSitecoreアイテムの一意の識別子。IDはSitecoreマーケティング コントロール パネルにあります。

      手記

      channelTypes.jsonのデフォルトのチャネルIDは、インストールの実際のIDと一致しない場合があります。チャネルを有効にするには、マーケティングコントロールパネルを開き、チャネルのIDをコピーして、channelTypes.jsonのチャネルにIDを貼り付けて、正しいIDを入力する必要があります。

    • Name - チャンネル名。Sitecoreでチャネルに設定されている名前とは異なる場合があります。

    • TimeOut - コレクションサービスがインタラクションをクローズとしてマークするタイミングを定義します。アクティブなインタラクションがTimeOutで定義された期間更新されない場合、コレクション サービスはインタラクションをクローズとしてマークし、ストレージから取得して処理に送信します。

    • Type - チャネルタイプの完全修飾名。

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

    この構成ファイルには、特定のチャネルのプレフィルター、エンリッチメント、およびポストフィルターパイプラインを定義するための拡張ポイントが含まれています。ファイルの構造は次のとおりです。

    • Channels - チャネル グループとそのパイプラインとプロセッサの配列。グループを使用すると、一度に複数のチャネルに構成を適用できます。これを行うには、チャネルIDをグループに追加します。

    • GroupName - チャネル グループの名前。グループにdefaultという名前を付けると、グループ内の定義は、どのグループにも含まれていないチャネルに使用されます。グループに他の名前を付けた場合、その定義は、グループのIDs配列に含まれるチャネルにのみ使用されます。

    • IDs - チャネルIDの配列。IDはchannelTypes.jsonファイルで定義されます。

    • Type - 完全修飾チャネル パイプライン名を使用する基本チャネルの種類の定義。

    • PreFilters - 処理エンジンが実行する最初のパイプライン。パイプラインには、次の2つのセクションがあります。

      • Type - 事前フィルタリング パイプライン オブジェクトの完全修飾名。

      • Processors - 事前フィルタリング パイプライン内で実行されるプロセッサの配列。この配列を独自の型で拡張するには、完全修飾名でJSONに含めます。

    • Enrichment - 処理エンジンが実行する2番目のパイプライン。これには、PreFiltersパイプラインと同じセクションが含まれています。

    • PostFilters - 処理エンジンが実行する最後のパイプライン。これには、PreFiltersパイプラインと同じセクションが含まれています。

  3. <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コレクション サイトを指定します。たとえば、<ServiceUrl>https://sc910xp1_collection</ServiceUrl>.

    • xConnect.ClientCertificate - xConnectのクライアント証明書。例えば:

      <ClientCertificate>StoreName=My;StoreLocation=LocalMachine;FindType=FindByThumbprint;FindValue=FF4637E7A2CACE7C0754E6B3C3552133E8E85614</ClientCertificate>

      xConnect証明書の詳細については、『Sitecore Experience Platformインストール ガイド』を参照してください。

      Azureデプロイの場合は、SSL設定の プライベート証明書 セクションで証明書をアップロードする必要があります。自己署名証明書を使用する場合は、接続文字列にAllowInvalidClientCertificates=trueを追加します。

      <ClientCertificate>StoreName=My;StoreLocation=LocalMachine;FindType=FindByThumbprint;FindValue=756432701B71E1622C9CAA308DB39579ABC9C6C7;AllowInvalidClientCertificates=true</ClientCertificate>
    • xConnect.RequestTimeout - xConnectサーバーへのリクエストのタイムアウト。デフォルト値は2分です。

  4. <website_name>\sitecore\Sitecore.Tracking.Processing.ChannelManagement\Config\config.xml.

    この構成ファイルは、ChannelTypesConfigファイルとChannelDefinitionsConfigファイルのパス リンクを定義します。

  5. <website_name>\sitecore\Sitecore.Tracking.SqlServer\Config\config.xml.

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

    手記

    ConnectionStringは、処理サービスと収集サービスで同じでなければなりません。

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