レンダリングのホスト追跡、分析、パーソナライズを有効にしてください
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要以前にアプリを統合していた場合、それは旧版のASP.NETコアレンダリングSDK(バージョン22以前)を使用しています。このSDKは更新を受け取っていないため、最新のバージョンへのアップグレード をお勧めします。
レンダリングホストの追跡、分析、パーソナライズを有効にするには、レンダリングホストリクエストをSitecoreレイアウトサービス に設定し、訪問者のIPアドレスをX-Forwarded-ForのHTTPヘッダーとして含める必要があります。
プロキシサーバーやロードバランサーを使用している場合は、MicrosoftのASP.NET Coreをプロキシサーバーやロードバランサーと連携させる設定 手順をご参照ください。
追跡および訪問者識別を可能にするために:
-
Sitecoreのインスタンス アナリティクスクッキードメイン がレンダリングホストドメインと一致するか、空に設定されているか確認してください。
-
Visual Studioのレンダリングホストプロジェクトで、Startup.csファイルをダブルクリックします。
-
レンダリングホストがプロキシサーバーの背後にある場合、ConfigureServices方式で訪問者IPアドレス転送のForwardedHeadersOptionsを設定します。
public void ConfigureServices(IServiceCollection services) { services.Configure
(options => { options.ForwardedHeaders = ForwardedHeaders.XForwardedFor; }); } !警告訪問者のIPアドレスを転送する際の脆弱性のなりすましに注意してください。 ExpressプロジェクトではX-Forwarded-Forヘッダーの扱いについて議論があり、Gorouterプロジェクトでは訪問者IPアドレスのスプーフィングについて議論があります。
-
AddSitecoreRenderingEngineサービスにWithTrackingオプションを追加して、Sitecoreレンダリングエンジンでトラッキングを有効にする:
public void ConfigureServices(IServiceCollection services) { services.AddSitecoreRenderingEngine(options => { //Register your components here using options parameter }).WithTracking(); }
-
ロボット検出のサポートを有効にするためにAddSitecoreVisitorIdentificationサービスを追加してください:
public void ConfigureServices(IServiceCollection services) { services.AddSitecoreVisitorIdentification(options => { options.SitecoreInstanceUri = new Uri("https://
"); }); } SitecoreInstanceUriはSitecoreレイアウトサービスをホストしているSitecoreインスタンスを指し示さなければなりません。
-
Configure法では、以下を追加します。
public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseForwardedHeaders(); // enables visitor IP address forwarding app.UseSitecoreVisitorIdentification(); // enables robot detection });
-
Startup.csファイルを保存してください。
-
レイアウトにsc-visitor-identificationタグヘルパーを追加して、セッションとそのリクエストがロボット訪問者として分類されないようにしてください:
このタグヘルパーは、/layouts/system/VisitorIdentification.jsを含むJavaScriptスクリプトタグを生成し、必要な連絡先識別要求を実行します。
-
ビューにSitecore.AspNet.Tracking.VisitorIdentificationタグヘルパーを追加してください:
@addTagHelper *, Sitecore.AspNet.Tracking.VisitorIdentification
!ヒントSitecore Rendering Engine SDKで利用可能な様々なAPIの動作例は、Getting Startedテンプレートを参照してください。