Microsoft IIS(Windows Server 2008 以降)

重要

Data Workbench 提供終了のお知らせ.

Microsoft Windows Server 2008 以降で実行しているMicrosoft IIS 7.x または 8.x 用のセンサーをインストールし、設定します。

Sensor のプログラムファイルは、インストールファイルにパッケージ化され、Adobeダウンロードサイトから入手できます。 ご使用の Web サーバー用の Sensor インストールファイルがまだない場合は、次の手順を開始する前に、そのファイルをダウンロード ( またはAdobe担当者から入手 ) してください。

Sensor をインストールして設定するには、次の大まかな手順を実行する必要があります。

  1. プログラムファイルをインストールする
  2. Sensor 設定ファイルを編集します。
  3. トランスミッターを起動し、ディスクキューを作成します。
  4. Web サーバーにコレクターを追加する
  5. 追加データのキャプチャ

プログラムファイルをインストールする

Windows IIS で Sensor を実行する場合、プログラムファイルとディスクキューファイルは同じディレクトリに存在する必要があります。

プログラムファイルをインストールする前に、まず、ディスクキューを保持する場所を決定します。これは、プログラムファイルをインストールする必要がある場所です。

次の手順を実行して、Sensor 用のプログラムファイルを抽出し、インストールします。

  1. Windows マシン上に、Sensor プログラムファイルをインストールするディレクトリを作成します。 ディスクキューもこのディレクトリに存在するので、選択したデバイスに必要なサイズのキューを保持するのに十分な空き容量があることを確認してください。

    例:C:\VisualSensor

  2. 作成したディレクトリに、インストールファイルの内容を抽出します。 この手順の間、Sensor は以下のファイルをインストールします。

ファイル 説明
EventMessages.dll イベントビューアメッセージ
qlog.dll コレクタモジュール(ISAPI フィルタ)。
TestExperiment.xls

アーキテクトが対照実験の設定に使用できる Excel スプレッドシートファイル。

センサーはこのファイルを使用しません。

trust_ca_cert.pem 接続プロセス中に Insight サーバーが提示する電子証明書を検証するために使用される証明書です。
TXLog.exe トランスミッタープログラム。
txlogd.conf Sensor 設定ファイル。
メモ

インストールパッケージには、TestExperiment.xls という名前のスプレッドシートファイルが含まれています。 このスプレッドシートは、アーキテクトが対照実験の設定に使用するツールです。 センサー自体はこのファイルを使用しないので、Sensor が実行されているマシンにファイルをインストールする必要はありません(ただし、インストールすることは可能です)。 代わりに、アーキテクトがアクセスできる場所にファイルをコピーするか、必要に応じてインストールパッケージからファイルを抽出します。 対照実験の詳細については、『 Insight 対照実験ガイド』を参照してください。

Sensor 設定ファイルを編集します。

txlogd.conf ファイルには、Sensor の設定パラメーターが含まれています。

ファイルを編集して、ディスクキューのサイズ、Insight サーバーのアドレス、このセンサーによって生成されるデータに添付される ID を指定する必要があります。 設定ファイルには、必須のパラメーターとオプションのパラメーターが含まれています。

  • 必須パラメーター は、Sensor をインストールする際に指定する必要がある設定です。 これらの設定がないと、センサーは正常に動作しません。
  • オプションのパラメーター は、事前定義済みの値(変更可能)をデフォルトにする設定またはオプション機能を有効にする設定です。

Sensor 設定ファイルを編集するには

  1. を開きます。 <SensorDirectory>/txlogd.conf ファイルを編集し、必要なパラメーターと必要なオプションパラメーターを設定します。

    詳しくは、 txlogd.conf パラメータ, 「 センサーの txlogd.conf ファイルのパラメーター.

  2. ファイルを保存して閉じます。

トランスミッターを起動し、ディスクキューを作成します。

設定後、 txlogd.confファイルを開くと、トランスミッタープログラムを起動し、Windows サービスとして登録し、ディスクキューを作成できます。

  1. Windows の [ スタート ] メニューから、[ アクセサリ ] > [ コマンドプロンプト ] を選択します。

  2. コマンドプロンプトウィンドウで、Sensor をインストールしたディレクトリに移動し、次のコマンドを実行します。

    txlog /regserver
    

    このコマンドは、トランスミッターを起動し、ディスクキューを作成し、Sensor を Windows サービスとして登録します。

  3. トランスミッターが正しく実行されていることを確認するには、スタート/Campaign コントロールパネル/管理ツール/サービスをクリックします。

    メモ

    このコマンドの順序は、使用している Windows のバージョンによって異なる場合があります。

    1. サービスリストで、Sensor のエントリを探し、そのステータスが「開始済み」で、起動タイプが「自動」であることを確認します。
    2. [ サービス ] コントロールパネルを閉じます。
  4. 起動中にトランスミッターでエラーが発生したかどうかを確認するには、スタート/Campaign コントロールパネル/管理ツール/イベントビューアをクリックして、イベントビューアを開きます。

    メモ

    このコマンドの順序は、使用している Windows のバージョンによって異なる場合があります。

    1. [Event Viewer] ウィンドウの左ペインで、[Applications] ログを選択します。
    2. 右側のウィンドウで、「ソース」列に「Adobe」があるイベントを探します。
    3. 「Adobe」からエラーが見つかった場合は、そのエラーをダブルクリックして「イベントのプロパティ」ウィンドウを表示します。 このウィンドウには、エラーに関する詳細情報が表示されます。
  5. アプリケーションログの調査が終了したら、イベントビューアを閉じます。

  6. トランスミッターが Sensor プログラムファイルをインストールしたディレクトリにディスクキュー (Diskq2008.log) を作成し、txlogd.conf ファイルの QueueSize パラメーターで指定したサイズであることを確認します。

    キューが正しく作成されていない場合:

    1. txtlogd.conf ファイルを調べ、QueueSize パラメーターが正しく設定されていることを確認します。

    2. Sensor をインストールしたデバイスに、QueueSize パラメータで指定したサイズのファイルを保持するのに十分な空き容量があることを確認します。

    3. Windows のサービスコントロールパネルで、トランスミッターを停止します。

    4. キューファイルを削除します。

    5. センサーを Windows サービスとして再登録:Windows の [ スタート ] メニューから、[ アクセサリ ] > [ コマンドプロンプト ] を選択します。 コマンドプロンプトウィンドウで、Sensor をインストールしたディレクトリに移動し、次のコマンドを実行します。

      txlog /regserver
      

トランスミッターは、連続的に実行するように設計されています。 コンピューターを再起動すると、トランスミッターが自動的に再起動します。 トランスミッターを手動で起動および停止する必要がある場合は、Windows の [ サービス ] コントロールパネルを使用して実行できます。

Web サーバーにコレクターを追加する

IIS の場合、コレクターは IIS の Web サーバーに追加する ISAPI フィルターです。

  1. 次を使用して IIS Manager を開きます。 スタート/管理ツール/インターネットインフォメーションサービス (IIS) マネージャー.

  2. を展開します。 ローカルコンピュータ および サイト ノード。

  3. Web サイトを選択し、右側のウィンドウでダブルクリックします。 ISAPI フィルタ.

  4. 以下 アクション ウィンドウで、 追加.

  5. フィルター名 「 」フィールドで、フィルターの表示名を入力します。 推奨されるフィルター名は「Sensor」です。

  6. クリック 参照​をクリックし、qlog.dll ファイル(Sensor をインストールしたディレクトリ内)を選択して、 OK.

  7. クリック OK をクリックしてフィルターを追加します。

    フィルターを追加すると、コレクターが直ちに動作し、データを収集する準備が整います。

コレクターにトラフィックが流れた後に緑色の矢印が表示されない場合は、次の手順に従います。

  1. スタート/管理ツール/イベントビューアをクリックして、イベントビューアでエラーを確認します。

    メモ

    このコマンドの順序は、使用している Windows のバージョンによって異なる場合があります。

  2. [ イベントビューア ] ウィンドウの左ペインで、 アプリ ログ。

  3. 右側のウィンドウで、「Adobe」が ソース 列。

  4. エラーが見つかった場合は、エラーをダブルクリックして、 イベントのプロパティ ウィンドウ

追加データのキャプチャ

Web ページは、多くの場合、ASP(Active Server Pages) プログラミング言語を使用して構造化されます。

ASP は、IIS 内で動作するMicrosoftテクノロジーです。 ブラウザが ASP ファイルを要求すると、IIS はその要求を ASP エンジンに渡します。 ASP エンジンは、ASP ファイルを 1 行ずつ読み取り、ファイル内のスクリプトを実行します。 最後に、ASP ファイルがプレーンHTMLとしてブラウザに返されます。 ASP は、RESPOND または REQUEST オブジェクトを提供し、他の利用方法に加えて、HTML・フォームから送信されたユーザー・クエリやデータの応答やリクエストを許可します。

場合によっては、ユーザーのブラウザーのアドレスバー内に表示される URL や、HTMLコード自体に表示可能な URL に、フォームに入力された値を追加したくないことがあります。 簡単なサーバー側 ASP スクリプトを使用すると、フォームフィールド名とそれぞれの値を、ユーザーのブラウザー内で使用したり、HTMLファイルに埋め込んだりしなくても、ログファイルに追加できます。 Web サイト内の特定のフォームに入力された実際のフォーム値を取り込むには、数行のコードを追加して、フォーム値をログリクエストに追加する必要があります。

フォームの処理ページ内で、次のコードを追加して、入力したフォームの値を(送信したフォームの値を外部データベースやその他の場所に書き込むのに加えて)要求データに追加します。

var sName= Request.Form("Name");
var sCity= Request.Form("City");
var sState= Request.Form("State");
var sZip= Request.Form("Zip");

Response.AppendToLog("&v_1=" +  sName);
Response.AppendToLog("&v_2=" +  sCity);
Response.AppendToLog("&v_3=" +  sState);
Response.AppendToLog("&v_4=" +  sZip);

このプロセスは、フォーム処理ページのリクエストデータに定義されたとおりのフォーム値を追加します。 ログデータ内では、追加された値がフォーム処理ページのクエリ文字列として使用できます(下図を参照)。 例えば、v_1、v_2、v_3 および v_4 は、適切なフォームフィールドに入力されたデータを含むクエリ文字列になります。 前の例で説明した構文は、取り込む追加のフォームフィールドおよび値に対して複製できます。

https://www.myserver.com/path/to/formprocessingpage.asp?v_1=John+Smith&v_2=Los+Angeles&v_3=California&v_4=90210

すべてのフォームフィールドと値を取り込んで分析に使用する場合は、次の構文を使用できます。

var formvalues = Response.Form;
Response.AppendToLog(formvalues);

次の例では、HTML内に存在するすべてのフォームフィールドとそれぞれの値を取り込み、クエリ文字列としてフォーム処理ページのログエントリに追加します。 これには、フォーム内に存在する非表示のフィールドが含まれます。

ログデータは、次の表で詳しく説明するように拡張されます。

収集されたデータ 説明
v_1 NAME クエリ文字列に関連付けられた値 v_1=John Smith
v_2 CITY クエリ文字列に関連付けられた値 v_2=ロサンゼルス
v_3 STATE クエリ文字列に関連付けられた値 v_3=カリフォルニア
v_4 ZIP クエリ文字列に関連付けられた値 v_4=90210

このページ