> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics をアプリに接続する

> Google Analytics のトラフィック、エンゲージメント、キャンペーンのデータを、アプリのダッシュボードやレポートに表示します。1 つの共有アカウントか、各ユーザー自身のアカウントを使います。

アプリを Google Analytics に接続して、トラフィックの傾向、エンゲージメント、キャンペーンの成果をダッシュボードやレポートに表示します。アプリ全体で 1 つの共有 Google アカウントを使うことも、各ユーザーが自分のアカウントを接続することもできます。

***

## できること

Google Analytics のデータをアプリに取り込みます。

> [card] トラフィックの傾向を表示
>
> 訪問数、上位のページ、トラフィックソースの推移を、アプリ内のダッシュボードに表示します。

> [card] ユーザー行動を分析
>
> エンゲージメントとコンバージョンファネルを確認し、訪問者がどこで離脱しているかを把握します。

> [card] 定期レポートを作成
>
> トラフィックとエンゲージメントのデータを含む週次レポートを、チーム向けに作成します。

> [card] キャンペーンを追跡
>
> Analytics のデータを使って、マーケティングキャンペーンの成果を比較します。

**プロンプト例**

AI チャットで、プロパティ、表示する指標、期間を指定します。例:

```text wrap theme={null}
Web サイトのトラフィックの傾向と、成果の高いページを表示して。
```

```text wrap theme={null}
主要なアナリティクス指標を表示するダッシュボードを作成して。
```

```text wrap theme={null}
Analytics からユーザー行動とコンバージョンファネルを分析して。
```

```text wrap theme={null}
トラフィックとエンゲージメントのデータを含む週次レポートを生成して。
```

```text wrap theme={null}
Analytics のデータを使って、マーケティングキャンペーンの成果を追跡して。
```

***

## Google Analytics を接続する

接続方法を選びます。アプリ全体で 1 つの共有アカウントを使うか、各ユーザーが自分のアカウントを使います。

> [tab] 共有コネクタ
>
> 1 つの Google アカウントを接続すると、アプリを使う全員がそのアカウントと Analytics のデータを共有します。
>
> **共有 Google Analytics コネクタを追加するには:**
>
> 1. ワークスペースのサイドバーで **コネクタ** をクリックします。
>
> 2. **コネクターを追加** をクリックします。
>
> 3. **Google アナリティクス** を検索し、クリックします。
>
> 4. **共有コネクター** を選択し、**次へ** をクリックします。
>
> 5. **接続名** を入力します。
>
> 6. **アクセスできる対象** で、**アプリと Super Agent**、**アプリのみ**、**Super Agent のみ** のいずれかを選択します。デフォルトでは **アプリと Super Agent** が選択されています。
>
> 7. **権限** で、アプリに必要な [スコープ](#scopes-and-permissions) を選択します:
>
>    * **読み取り専用:** アプリは Analytics のデータと設定を表示できます。これがデフォルトです。
>    * **読み取りと書き込み:** アプリは Analytics のアカウントとプロパティの設定も変更できます。
>    * **カスタム:** アプリに必要な任意の権限を選択します。必須の権限は選択されたままです。
>
>    ![Connection name、Who can access が入力され、Read-only の権限が選択された共有 Google Analytics コネクタの設定](https://mintcdn.com/base44/f-7NhkNoXDoVi_Da/images/apps-connectors-google-analytics-shared-setup.png?fit=max\&auto=format\&n=f-7NhkNoXDoVi_Da\&q=85\&s=cd95db20bce0213e7874e1cb16c1eb6b)
>
>    共有 Google Analytics コネクタを設定する
>
> 8. **コネクターを追加** をクリックします。
>
> 9. Analytics のプロパティにアクセスできる Google アカウントでサインインします。

> [tab] アプリユーザーコネクタ
>
> 各ユーザーが自分の Google アカウントを接続します。アプリは、そのユーザーがアクセスできる Analytics のプロパティを表示できます。
>
> > [!WARNING]
> >
> > これを設定できるのは、ワークスペースのオーナーと管理者のみです。
>
> > [!TIP]
> >
> > **アプリユーザーコネクタを設定する前に:** Client ID と Client Secret を持つ Google Cloud の OAuth クライアントが必要です。同じ Google Cloud プロジェクトで Google Analytics Data API をオンにします。アプリでプロパティの一覧表示や設定の変更を行う場合は、Google Analytics Admin API もオンにします。[独自の OAuth クライアントを使う](https://docs.base44.com/ja/Integrations/Connectors.md#using-your-own-oauth-client) を参照してください。
>
> **アプリユーザー Google Analytics コネクタを追加するには:**
>
> 1. ワークスペースのサイドバーで **コネクタ** をクリックします。
>
> 2. **コネクターを追加** をクリックします。
>
> 3. **Google アナリティクス** を検索し、クリックします。
>
> 4. **アプリユーザーコネクター** を選択し、**次へ** をクリックします。
>
> 5. **コールバック URL** をコピーします。
>
> 6. Google Cloud の OAuth クライアントで、コールバック URL を承認済みのリダイレクト URI に追加します。
>
> 7. **Add Google Analytics Connection** フォームに戻り、**コネクタ名** を入力します。
>
> 8. **クライアントID** を入力します。
>
> 9. **クライアントシークレット** を入力します。
>
> 10. **スコープ** で、アプリに必要な [スコープ](#scopes-and-permissions) を選択します。
>
>     ![email がロックされ、analytics readonly と analytics edit を選べる Google Analytics の Scopes リスト](https://mintcdn.com/base44/f-7NhkNoXDoVi_Da/images/apps-connectors-google-analytics-app-user-scopes.png?fit=max\&auto=format\&n=f-7NhkNoXDoVi_Da\&q=85\&s=7610bcb079782883d45daf160a69f252)
>
>     アプリユーザーコネクタのスコープを選ぶ
>
> 11. **コネクタを追加** をクリックします。
>
> 12. アプリエディターに移動します。
>
> 13. 各ユーザーが自分の Google Analytics アカウントを接続できる仕組みを追加するよう AI チャットに依頼します。

***

## スコープと権限

スコープは、アプリが Google Analytics でできることを制御します。スコープはコネクタを設定するときに選びます。

> [card]
>
> **1. Base44 が追加するもの**
>
> Base44 は常にこのスコープを含めます。共有コネクタでは **カスタム** の下、アプリユーザーコネクタでは **スコープ** の下に、ロックされた状態で表示されます。
>
> * `email`: 接続する Google アカウントを識別します
>
> **2. 自分で設定するもの**
>
> 共有コネクタでは権限のオプションを選び、アプリユーザーコネクタではスコープを選択します。Google Analytics のスコープ名は `https://www.googleapis.com/auth/` で始まります:
>
> * `analytics.readonly`: Analytics のデータと設定を表示します
> * `analytics.edit`: Analytics のアカウントとプロパティの設定を編集します
>
> **アクセス:** アプリは、接続した Google アカウントがアクセスできる Analytics のアカウントとプロパティを扱います。

***

## バックエンド関数を使う

Google Analytics を接続すると、バックエンド関数がアクセストークンを取得して Google Analytics Data API を直接呼び出せます。サインインとトークンの更新は Base44 が処理します。

* 共有接続の場合は、`getConnection()` でトークンを取得します。
* アプリユーザー接続の場合は、`getCurrentAppUserConnection()` を使い、各リクエストがサインイン中のユーザーのトークンを使用するようにします。

`analyticsdata.googleapis.com` で Google Analytics Data API を呼び出し、`Authorization` ヘッダーでトークンを渡します:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("google_analytics");

const propertyId = "123456789"; // Your Google Analytics property ID

const response = await fetch(
  `https://analyticsdata.googleapis.com/v1beta/properties/${propertyId}:runReport`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
      dimensions: [{ name: "pagePath" }],
      metrics: [{ name: "screenPageViews" }],
    }),
  },
);
const report = await response.json();
```

> [card] [共有コネクタ](https://docs.base44.com/ja/developers/backend/resources/connectors/shared-connectors.md)
>
> バックエンド関数から共有接続を設定、デプロイ、呼び出します。

> [card] [アプリユーザーコネクタ](https://docs.base44.com/ja/developers/backend/resources/connectors/app-user-connectors.md)
>
> ユーザーごとのトークンを取得し、サインイン中のユーザーとして API を呼び出します。

***

## トラブルシューティング

アプリで Google Analytics が動作しなくなった場合は、接続、Google アカウント、スコープを確認してください。

> [accordion] 接続の再接続が必要になる
>
> Google Analytics へのアクセスが失われたり期限切れになったりすると、接続に **この接続は再接続が必要です** セクションが表示されます。共有コネクタの場合は、[再接続](https://docs.base44.com/ja/Integrations/Connectors.md#managing-your-connectors) し、同じ Google アカウントでサインインします。その接続を使うすべてのアプリが再び動作します。アプリユーザーコネクタの場合は、各ユーザーがアプリ内から自分のアカウントを再接続します。

> [accordion] Analytics のデータが表示されない
>
> 接続した Google アカウントが目的のプロパティにアクセスできること、アプリがそのプロパティの ID を使っていることを確認してください。新しいプロパティはデータの収集に時間がかかる場合があります。Google Analytics で同じ期間と比較してください。

> [accordion] アプリで Analytics の設定を変更できない
>
> アカウントとプロパティの設定を変更するには、アプリに `analytics.edit` スコープが必要です。
>
> * 共有コネクタの場合、権限は接続を追加するときに設定されます。Google Analytics コネクタのページで **別のコネクターを追加** をクリックし、新しい接続で **読み取りと書き込み** を選びます。
> * アプリユーザーコネクタの場合は、Google Analytics コネクタのページでコネクタを開き、スコープに `analytics.edit` を追加して **変更を保存** をクリックします。すでに接続したユーザーは、再度接続するまで以前のアクセス権のままです。

> [accordion] 一部のユーザーが自分の Google アカウントを接続できない
>
> OAuth クライアントはテストモードで始まり、承認されたテストユーザーだけが接続できます。より広くアクセスを開く前に、OAuth アプリを本番環境に移行し、Google が求める確認を完了してください。

> [accordion] リダイレクト URI のエラーで接続に失敗する
>
> **Add Google Analytics Connection** フォームから **コールバック URL** をコピーし、Google Cloud の OAuth クライアントの承認済みリダイレクト URI に正確に追加してください。

***

## よくある質問

> [accordion] アカウントにはどの Google Analytics のロールが必要ですか?
>
> 表示したいプロパティで、少なくとも閲覧者のロールを持つ Google アカウントを接続します。アプリでアカウントやプロパティの設定を変更できるようにするには、そのアカウントに編集者のロールが必要です。

> [accordion] アプリで複数のプロパティを使えますか?
>
> はい。接続した Google アカウントが複数のプロパティにアクセスできる場合は、AI チャットで使いたいプロパティを指定するか、プロパティを切り替える仕組みを依頼してください。

> [accordion] Google Analytics と Google Search Console を一緒に使えますか?
>
> はい。それぞれのコネクタを個別に追加してから、Google Analytics のトラフィックと [Google Search Console](https://docs.base44.com/ja/Integrations/google-search-console-connector.md) の検索パフォーマンスを 1 つのダッシュボードにまとめるよう AI チャットに依頼します。

> [!NOTE]
>
> このページは AI によって翻訳されました。最も正確で最新の情報については、[英語版](https://docs.base44.com/index.md) を参照してください。


## Related topics

- [Google Maps をアプリに接続する](https://docs.base44.com/ja/Integrations/google-maps-connector.md)
- [Google Search Console をアプリに接続する](https://docs.base44.com/ja/Integrations/google-search-console-connector.md)
- [Snowflake をアプリに接続する](https://docs.base44.com/ja/Integrations/snowflake-connector.md)
- [Slack をアプリに接続する](https://docs.base44.com/ja/Integrations/slack-connectors.md)
- [Databricks をアプリに接続する](https://docs.base44.com/ja/Integrations/databricks-connector.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.