追跡サービス

トラッキング サービスはインストールされますが、Sitecoreヘッドレス サービスのインストール時にdisabled by defaultされます。

Trackerを有効にするには、次のように、設定パッチファイルでSitecore.JSS.TrackerServiceEnabled設定をtrueに設定します。

<configuration>
  <sitecore>
    <settings>
      <setting name="Sitecore.JSS.TrackerServiceEnabled" value="true" />
    </settings>
  </sitecore>
</configuration>

トラッカーは、他のサービスと同様にSSC APIキー を利用します。APIキーは、トラッカーのCORSサポートを有効にするのに役立ちます。アプリごとに1つのAPIキーを使用することをお勧めしますが、すべてのサービスに同じAPIキーを使用することもできます。

エンドポイント /sitecore/api/jss/track/event?sc_apikey=keyを使用してイベントを追跡できます。

エンドポイントは、JSONペイロードを含むPOSTリクエストを受け入れます。

次の表は、追跡できるイベントのタイプと、トラッキングサービスエンドポイントに送信する必要があるペイロードを示しています。

{
    "goalId": "<goal ID>"
}

{
    "outcomeId": "<goal ID>", 
    "currencyCode": "<currency code>",
    "monetaryValue": "<monetary value>"
}

{
    "pageId": "<page ID>",
    "url": "<page URL>"
}

{
    "campaignId": "<campaign ID>"
}

{
    "eventId": "<event-value>"
}

トラッキングコードによってプッシュされたデータは、エクスペリエンスプロファイルで確認できます。

デフォルトでは、Sitecoreは匿名のコンタクト データをインデックス化しないため、識別されていないユーザーのデータはエクスペリエンス プロファイルに含まれません。テスト結果をより効率的に表示するために、匿名連絡先のインデックス作成を有効にすることができます。

Tracker Serviceは、すぐに 使用できる連絡先の識別 をサポートしていませんが、拡張できます。

Sitecoreは、ユーザー セッションの終了前に追跡データをエクスペリエンス プロファイルに保存またはインデックス化しません。ユーザー・セッションを終了するには、エンドポイント /sitecore/api/jss/track/flushを呼び出します。

トラッカーはトラッキングデータの導管であり、必要に応じて拡張します。App_Config\Sitecore\JavaScriptServices\Sitecore.JavaScriptServices.Tracker.configで定義されているtrackEventパイプラインは、受信追跡要求の処理を担当します。

構成パッチを使用して、新しいパイプライン プロセッサまたは交換されたパイプライン プロセッサを含めることができます。

プロセッサはSitecore.JavaScriptServices.Tracker.Pipelines.TrackEvent<T>から派生させる必要があります。ここで、Tは受信JSONを逆シリアル化するためのC# 型です。

パイプライン プロセッサ メソッドではTrackEvent次のことを行う必要があります。