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

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

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

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

大事な

前に アプリを統合した場合は、従来の ASP.NET Core Rendering SDKバージョン22以前を使用しています。このSDKは更新を受け取っていないため、新しい の最新バージョンにアップグレードすることをお勧めします。

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

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

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

  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レイアウト サービスをホストする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の実例については、入門テンプレートを参照してください。

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