プロキシリクエスト

SDKの目的の1つは、Webサイト経由でFintezaにリクエストをプロキシすることです。詳細については、「スクリプトとリクエストのプロキシ」セクションをご覧ください。

プロキシを有効にするには、ConfigureServices初期化メソッドのメインパラメータに加えて、関連するプロキシパラメータを設定します。

services.AddFintezaAnalytics(options =>
{
    options.WebsiteId = "{WEBSITE_ID}";
    options.Token = "{Token}";
    options.Path = "{Path}";
...
});

パラメータ	タイプ	詳細
Token *	string	X-Forwarder-Forヘッダに署名するためのトークン。この値は、FintezaパネルのWebサイト設定で取得できます。カウンタセクションを開き、[スクリプトとリクエストのプロキシ]オプションを有効にし、[プロキシトークン]フィールドから値をコピーします。プロキシする場合、Fintezaへのすべてのリクエストは、クライアントから直接ではなく、Webサイトのサーバーから物理的に送信されます。（サイトアドレスだけでなく）クライアントの実際のIPアドレスをFintezaに渡すために、SDKはX-Forwarder-Forヘッダを使用します。リクエストのなりすましによるトラフィックの増加を防ぎ、Webサイトへのアクセスに関する実際のデータのみを提供するために、Fintezaはリクエストのヘッダ署名をチェックします。ヘッダが一意のWebサイトトークンで署名されている場合、システムはその値を信頼します。それ以外の場合、トラフィックは「インフレ」していると見なされます（トラフィックレポートは、FintezaパネルのQuality Webサイトセクションで利用できます）。
パス	string	プロキシされるリクエストのパスの始まり。パラメータが指定されていない場合は、デフォルトの/fzの値が使用されます。以下は必要なトラッキングコードの変更です。Fintezaへのすべてのリクエストは、指定された先頭のパスに沿って実行されます。

パラメータ

タイプ

詳細

Token *

string

X-Forwarder-Forヘッダに署名するためのトークン。この値は、FintezaパネルのWebサイト設定で取得できます。カウンタセクションを開き、[スクリプトとリクエストのプロキシ]オプションを有効にし、[プロキシトークン]フィールドから値をコピーします。

プロキシする場合、Fintezaへのすべてのリクエストは、クライアントから直接ではなく、Webサイトのサーバーから物理的に送信されます。（サイトアドレスだけでなく）クライアントの実際のIPアドレスをFintezaに渡すために、SDKはX-Forwarder-Forヘッダを使用します。

リクエストのなりすましによるトラフィックの増加を防ぎ、Webサイトへのアクセスに関する実際のデータのみを提供するために、Fintezaはリクエストのヘッダ署名をチェックします。ヘッダが一意のWebサイトトークンで署名されている場合、システムはその値を信頼します。それ以外の場合、トラフィックは「インフレ」していると見なされます（トラフィックレポートは、FintezaパネルのQuality Webサイトセクションで利用できます）。

パス

string

プロキシされるリクエストのパスの始まり。パラメータが指定されていない場合は、デフォルトの/fzの値が使用されます。

以下は必要なトラッキングコードの変更です。Fintezaへのすべてのリクエストは、指定された先頭のパスに沿って実行されます。

* —必須パラメータ。

例：

services.AddFintezaAnalytics(options =>
{
    options.WebsiteId = "opemapikpuymgukzpihgweylppotinamyf";
    options.Token = "joanmxozikjgeqlgguazmzoplankaqlg";
    options.Path = "/fz";
...
});

その後、StartupクラスのConfigureメソッドに次の行を追加します。

app.UseFintezaAnalyticsProxy();

UseFintezaAnalyticsProxyメソッドは特別なミドルウェアを作成します。ミドルウェアは、受信リクエストを個別にルーティングし、分析リクエストのみをFintezaにプロキシします。

注: プロキシを構成した後トラッキングコードを変更します。