1. Sitecore ASP.NETレンダリングSDK (レガシー)

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

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

このページの翻訳は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のドキュメント で追加の手順を参照してください。

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

  1. Sitecoreインスタンス 分析Cookieドメイン がレンダリング ホスト ドメインと一致するか、空に設定されていることを確認します。

  2. Visual Studioのレンダリング ホスト プロジェクトで、Startup.csファイルをダブルクリックします。

  3. レンダリング ホストがプロキシ サーバーの背後にある場合は、ConfigureServicesメソッドで、ビジター IPアドレス転送のForwardedHeadersOptionsを設定します。

    public void ConfigureServices(IServiceCollection services)
{
  services.Configure<ForwardedHeadersOptions>(options =>
    {
      options.ForwardedHeaders = ForwardedHeaders.XForwardedFor;
    });
}
    警告

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

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

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

  5. AddSitecoreVisitorIdentificationサービスを追加して、ロボット検出のサポートを有効にします。

    public void ConfigureServices(IServiceCollection services)
{
  services.AddSitecoreVisitorIdentification(options =>
    {
      options.SitecoreInstanceUri = new Uri("https://<sitecore instance>");
    });
}

    SitecoreInstanceUriは、Sitecore Layout ServiceをホストしているSitecoreインスタンスを指している必要があります。

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

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

  7. Startup.csファイルを保存します。

  8. レイアウトにsc-visitor-identification タグ ヘルパー を追加して、セッションとそのリクエストがロボット訪問者として分類されないようにします。

    <!DOCTYPE html>
<html>
  <head>
    <sc-visitor-identification />
  </head>
  <body>
  </body>
</html>

    このタグ ヘルパーは、必要な連絡先識別要求を実行する /layouts/system/VisitorIdentification.jsを含むJavaScriptスクリプト タグをレンダリングします。

  9. ビューにSitecore.AspNet.Tracking.VisitorIdentificationタグ ヘルパーを追加します。

    @addTagHelper *, Sitecore.AspNet.Tracking.VisitorIdentification
先端

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

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