logモジュール：基本設定
概要
logモジュールは、エンドユーザーの操作・挙動を記録します。
ログの記録は全てAPIを介して行います。
記録するログのイベントトリガーは柔軟に定義可能。
全権限（管理者、マネージャー、ユーザー、一般）のログを生成することができます。
※管理画面の操作ログを記録する機能はありません
- アイテム一覧ページで検索された項目を記録。「会員・非会員」といった特定権限者の確認も
- コンテンツ内の広告や特定の情報などが画面上に表示された時に、位置を特定するユニークなキーを記録
- 外部動画サービスの埋め込みコンテンツにおいて、動画サービスが提供しているAPIから取得した閲覧ユーザーの操作履歴を記録
- IoTの活用など、外部システムやモノのログを記録
データ構造
logモジュールは、以下の項目を利用して作成されたイベントトリガーのログを取得できます。
| フィールド名 | 項目名 | 用途 |
|---|---|---|
| id | システムID | ログのシステムID |
| log_sheet | ログシート | ログシートの情報（シートID） |
| user_type | 登録者権限 | ログ登録者の権限 一般 / ユーザー / マネージャー / 管理者 |
| user_sheet_id | 登録者シート | 登録者シート情報（シートID） ※一般、管理者は空 |
| user_t_id | 登録者 | 登録者情報（システムID） ※一般、管理者は空 |
| param1～6 | param1～6 | 操作を特定したり、連携を行ったりするための自由な入力欄 ※文字列として64文字まで格納可能 |
| param_json | 汎用データ | パラメータが6項目以上ある場合に利用 ※Json形式で記述 |
| log_unix | 登録日時 | ログの登録日時 |
モジュールの構築
モジュール導入からコンテンツ作成までの主な流れは以下です。
シート作成
モジュール管理 > keep｜シート作成から進みます。
必要項目を入力・設定し、確認 ⇒ 登録でシートが作成されます。
共通設定
ログ名称
シート名称。サイドメニューや他シートから参照する際の表示名になります。
レコード削除設定
保持期間
レコードの保持期間を設定します。
「無制限」以外を選択すると、毎日00:00:00に、指定日数が経過したレコードを削除します。
7日 / 30日 / 60日 / 90日 / 180日 / 360日 / 720日 / 無制限
メニュー作成
メニュー設定を行い、サイドバーに表示します。
アクセス権限設定
logシートにアクセス権限を設定します。
管理画面からのログ登録
運用都合や何らかの事情でログが記録されなかった場合、管理者の管理画面から登録することができます。
ログシート左上の「新規作成」から行います。
基本情報
登録者権限
登録者権限を選択します。
一般 / ユーザー / マネージャー / 管理者から選択します。
登録者シート
登録者が管理されているシートを選択します。
登録者権限が「ユーザー」か「マネージャー」の場合のみ表示されます。
登録者
登録者を選択します。
登録者シートを選択した場合のみ表示されます。
登録日時
ログの登録日時を過去日時で設定します。
未入力時は現在日時が適用されます。
パラメータ情報
param1～6
パラメータ情報を付与する場合に入力します。
汎用データ
パラメータが6項目以上ある場合に利用します。
記述はJSON形式で行います。
操作・閲覧権限と内容
管理者は管理画面上でログ情報の登録・削除が可能です（アクセス権限設定による）。
権限（管理者／マネージャー／ユーザー／一般）ごとの操作（閲覧）内容は以下のとおりです。
| 機能 | 権限 | 内容 |
|---|---|---|
| CSV | 管理者 | ダウンロード |
| API | 管理者 | 登録（POST）、取得：複数件、1件（GET） |
| マネージャー | 登録（POST） | |
| ユーザー | 登録（POST） | |
| 一般 | 登録（POST） |