Bot Builder v4 : Bot Connector のボット利用状況分析

この記事では Bot Connector が提供するボットの分析機能について紹介します。

[参考: ボットの分析](https://docs.microsoft.com/ja-jp/azure/bot-service/bot-service-manage-analytics?view=azure-bot-service-4.0)

# 分析のセットアップ

分析機能は Application Insight を構成することで利用できます。

## ボット作成時に Application Insight を設定する場合

1\. https://portal.azure.com より「Web App Bot」を作成。ここでは「基本ボット (C#)」を選択。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/002dd881-209c-c311-069a-c51d6d7ecf4f.png)

2\. Application Insight を有効にして「作成」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/5bf2153f-5cc2-c6a5-50f8-17c3e8deedc6.png)

## 既存のボットに Application Insight を設定する場合

1\. リソースの追加より「Application Insight」を選択。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/124f6330-2544-1ff9-54da-6d8f585b793b.png)

2\. インスタンスの詳細を入力して作成。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/1468522e-7aff-324e-b893-5b78e5f25d5b.png)

3\. 作成した Application Insights を開き、概要よりインストルメンテーションキーを取得。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/56c1c79e-7694-7c46-ffe2-674f7c613c21.png)

4\. API アクセスより「API キーの作成」をクリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/126f13f0-5dbd-5e9e-f4b8-fa680afc79c6.png)

5\.「利用統計情報の読み取り」にチェックをいれてキーを生成。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/df895e24-fe3c-2913-9b50-5cdd2650e247.png)

6\. 生成されたキーをコピー。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/6aa875c5-8417-ede2-19b5-33c0e8b145e5.png)

7\. ボット登録を開き、「設定」をクリック。分析項目に上記で取得した値を設定して「保存」。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/14f92c2b-40d6-c3d2-fd23-54fd7f7391d8.png)

# 分析の利用

構成が終わっている場合、ボット登録の「分析」をクリックすると利用状況が確認できます。

## 分析レポートのフィルタ

分析結果は「過去 1 時間」「過去 24 時間」「先週」「先月」「過去 90 日」から選択できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/a960b461-eb18-70c4-9703-205e0c57b985.png)

またどのチャネルを分析するか指定できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/a0491ddd-a36b-061a-40c7-573cd11da940.png)

## 総計

ユーザー数やアクティビティの合計を表示します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/34dc1bca-e76d-3198-4e8b-b7c897e0f6a2.png)

## リテンション 

どの程度ユーザーがボットを再利用しているかを示します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/3321fef3-b69b-9a76-a0df-ed0a2dbe2b70.png)

## ユーザー

チャネル毎のユーザーの増減を示します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/cae7e867-835c-c474-1672-baf53febe4fc.png)


## アクティビティ 

各チャネルを使用して送受信されたアクティビティの数を示します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/214116/f1f515c9-da06-459b-6739-875c79c4ed95.png)


# まとめ

分析を使うことでチャネル毎の利用状況は分かりますが、ボットの機能レベルの分析はできません。より詳細な分析については別の記事で紹介します。

[目次に戻る](https://qiita.com/kenakamu/items/6dc043cfc1f199032883)

# 参考

[記事: ボットの分析](https://docs.microsoft.com/ja-jp/azure/bot-service/bot-service-manage-analytics?view=azure-bot-service-4.0)
[記事: Application Insights キー](https://docs.microsoft.com/ja-jp/azure/bot-service/bot-service-resources-app-insights-keys?view=azure-bot-service-4.0)