Google Analytics スキルセットガイド

概要

illustration of Google Analytics skillset

Google Analytics スキルセット は、Google Analytics アカウントに接続されたツールのコレクションです。このスキルセットを有効にすることで、AI エージェントは Google Analytics を通じてウェブサイトデータを取得し、分析レポートを生成して、ウェブサイトの行動をより簡単に理解できるようになります。

現在のスキルセットには以下のスキルが含まれます：

カスタムレポートの取得(Get Custom Report)：指標とディメンションを指定してカスタマイズ可能な Google Analytics レポートを取得します
- パラメータ説明：
  - propertyId(必須): Google Analytics プロパティ ID (例: 42XXXXX01)
  - startDate(必須): 開始日 (形式: YYYY-MM-DD)
  - endDate(必須): 終了日 (形式: YYYY-MM-DD)
  - dimensions (任意): クエリするディメンション (例: country, city, pagePath, sessionSource)
  - metrics(必須): クエリする指標 (例: activeUsers, active1DayUsers, active7DayUsers, active28DayUsers)
  - limit(任意): 結果数の制限、デフォルトは50

📌 ヒント：詳細なディメンションと指標については Google Analytics API ドキュメントを参照してください。

アクティブユーザー数データの取得(Get Active Users Data)：アクティブユーザー数データ（1日、7日、28日）を取得します
- パラメータ説明：
  - propertyId(必須): Google Analytics プロパティ ID (例: 42XXXXX01)
  - startDate(必須): 開始日 (形式: YYYY-MM-DD)
  - endDate(必須): 終了日 (形式: YYYY-MM-DD)
  - limit(任意): 結果数の制限、デフォルトは50

設定手順

Google Analytics スキルセットは Google Cloud サービスアカウント認証情報(Google Credentials)に依存しています。以下の手順に従って設定してください：

ステップ 1：Google Analytics 認証情報の取得

Google Cloud コンソールにアクセスしてログインするか、アカウントを作成してください。
新しいプロジェクトを作成するか、既存のプロジェクトを選択してください。
Analytics Data API の有効化：
- Google Cloud コンソールで "APIs & Services" > "Library" に移動
- "Analytics Data API" を検索
- クリックして "Enable" を開始
サービスアカウントの作成：
- "IAM & Admin" > "Service Accounts" に移動
- "Create Service Account" をクリック
- "bika-analytics" のような名前を付けて "Create" をクリック
- "Viewer" ロールを割り当て、"Continue" をクリックして "Done"
認証情報の作成とダウンロード：
- 新しいサービスアカウントをクリック
- "Keys" タブに移動
- "Add Key" > "Create new key" をクリック
- "JSON" を選択して "Create" をクリック
- ダウンロードした JSON ファイルを安全に保存
Google Analytics での権限付与：
- Google Analytics に移動
- "Admin"（歯車アイコン）をクリック
- データにアクセスしたいメディアリソースを含むアカウントを選択
- "Account" セクションで "Account Access Management" を選択
- "+" ボタンをクリックして、サービスアカウントのメールアドレス（JSON ファイルの client_email フィールドから）を追加
- "Viewer" 権限を割り当て
Google Analytics Property ID の取得：
- Google Analytics で "Admin"（歯車アイコン）をクリック
- "Property" > "Property details" を選択
- "PROPERTY ID: 42XXXXX01" をコピーし、AIとの会話やプロンプト内でパラメータとして使用（ステップ2の例を参照）

ステップ 2：スキルセットの設定

Bika の Google Analytics スキルセット設定ページに戻る
JSON 認証情報の内容全体を Google Credentials フィールドに貼り付ける
Connect をクリックして認証情報を完了
System Prompt に Property ID を入力するか、会話時に直接 Property ID を入力

⚠️ 設定プロセスが複雑な場合は、Google Analytics エージェントテンプレートドキュメントを参照して詳細な操作例を確認できます。

ステップ 3：必要なスキルの有効化

スキルセット設定ページでスイッチを使って必要な機能を有効化
複数のスキルを同時に有効化可能
保存をクリックして有効化

使用例

1) レポートの取得

AI にカスタム分析レポートを生成させる：

例のプロンプト："総ユーザー数を表示"

metrics: totalUsers は総ユーザー数、AIに直接伝えることで誤解を避けることができます。これは LLM の Google Analytics に対する理解能力によります。

例のプロンプト："過去1ヶ月の国別ページビュー数とセッション数を分析"

ページビュー数とセッション数の分析 metrics：screenPageViews、sessions

📌 ヒント：

Property ID：一意の識別子（例：42XXXXX01）、プロンプトで指定可能
dimensions（ディメンション）：country、date、city、adUnitName など
metrics（指標）：sessions、screenPageViews、activeUsers、totalUsers など
詳細なディメンションと指標については Google Analytics API ドキュメントを参照

2) アクティブユーザー数データの取得

AI にユーザーアクティビティ指標を取得させる：

例のプロンプト："アクティブユーザー数を表示"

アクティブユーザー数の表示

Q&A

Q: 接続に失敗した場合はどうすればよいですか？ A: JSONが完全に貼り付けられているか、余分な記号が追加されていないか、またはサービスアカウントのメールアドレスに権限が設定されているかを確認してください。

Q: 機能が利用できない場合はどうすればよいですか？ A: 設定ページで対応するスキルが有効化され、保存されていることを確認してください。

Q: 呼び出しが制限された場合はどうすればよいですか？ A: Google Analytics APIにはレート制限があります。リクエストが多すぎると制限が発生する可能性があります。後ほど再度お試しください。

テンプレート

ヘルプ

価格

ブログ

コミュニティ