レンダリングホストの追跡、分析、パーソナライゼーションを有効にする

Version: 22.x

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

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

大事な

September 2024より前にASP.NET Coreアプリを統合した場合は、従来の ASP.NET CoreレンダリングSDKバージョン22以前が使用されています。このSDKは更新プログラムを受け取らなくなったため、新しい ASP.NET Core SDKの最新バージョンにアップグレードすることをお勧めします。

レンダリングホストの追跡、分析、およびパーソナライゼーションを有効にするには、Sitecoreレイアウトサービスへのレンダリングホストリクエストを設定して、訪問者のIPアドレスをX-Forwarded-For HTTPヘッダーとして含める必要があります。

プロキシサーバーまたはロードバランサーを使用している場合は、プロキシサーバーおよびロードバランサーと連携するためのASP.NET Coreの構成に関するMicrosoftのドキュメントで追加の手順を参照してください。

トラッキングと訪問者の識別を有効にするには:

Sitecoreインスタンス分析Cookieドメインがレンダリングホストドメインと一致するか、空に設定されていることを確認します。
Visual Studioのレンダリングホストプロジェクトで、Startup.csファイルをダブルクリックします。
レンダリングホストがプロキシサーバーの背後にある場合は、ConfigureServicesメソッドで、ビジター IPアドレス転送のForwardedHeadersOptionsを設定します。
RequestResponse
```
public void ConfigureServices(IServiceCollection services)
{
  services.Configure<ForwardedHeadersOptions>(options =>
    {
      options.ForwardedHeaders = ForwardedHeaders.XForwardedFor;
    });
}
```
警告

訪問者のIPアドレスを転送する際のなりすましの脆弱性に注意してください。expressプロジェクトではX-Forwarded-Forヘッダーの取り扱いについて、Gorouterプロジェクトでは訪問者のIPアドレスのスプーフィングについて議論しています。

AddSitecoreRenderingEngineサービスにWithTrackingオプションを追加して、レンダリングエンジンでのトラッキングを有効にしますSitecore。

RequestResponse

public void ConfigureServices(IServiceCollection services)
{
  services.AddSitecoreRenderingEngine(options =>
    {
      //Register your components here using options parameter
    }).WithTracking();
}

AddSitecoreVisitorIdentificationサービスを追加して、ロボット検出のサポートを有効にします。
RequestResponse
```
public void ConfigureServices(IServiceCollection services)
{
  services.AddSitecoreVisitorIdentification(options =>
    {
      options.SitecoreInstanceUri = new Uri("https://<sitecore instance>");
    });
}
```
SitecoreInstanceUriは、Sitecore Layout ServiceをホストしているSitecoreインスタンスを指している必要があります。

Configureメソッドで、以下を追加します。

RequestResponse

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
  app.UseForwardedHeaders();                 // enables visitor IP address forwarding
  app.UseSitecoreVisitorIdentification();     // enables robot detection
});

Startup.csファイルを保存します。
レイアウトにsc-visitor-identification タグヘルパーを追加して、セッションとそのリクエストがロボット訪問者として分類されないようにします。
RequestResponse
```
<!DOCTYPE html>
<html>
  <head>
    <sc-visitor-identification />
  </head>
  <body>
  </body>
</html>
```
このタグヘルパーは、必要な連絡先識別要求を実行する /layouts/system/VisitorIdentification.jsを含むJavaScriptスクリプトタグをレンダリングします。
ビューにSitecore.AspNet.Tracking.VisitorIdentificationタグヘルパーを追加します。
RequestResponse
```
@addTagHelper *, Sitecore.AspNet.Tracking.VisitorIdentification
```

先端

SitecoreレンダリングエンジンSDKで利用可能なさまざまなAPIの実例については、入門テンプレートを参照してください。

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、

レンダリング ホストの追跡、分析、パーソナライゼーションを有効にする

レンダリングホストの追跡、分析、パーソナライゼーションを有効にする