> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/zh-cn/startguide/connect/events/ga4.md).

# 连接 GA4

## GA4 连接指南

1. 点击左侧导航栏的「数据连接」，然后在浏览面板的「搜索连接器」中输入 GA4，或在「连接事件」类别中点击「连接 GA4」。

   ![浏览面板「连接事件」类别中的「连接 GA4」](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-c4e719bf7062e4d1e3098ce2bc64c1dbac0c73a2%2Fstartguide__connect__events__ga4__01.png?alt=media)
2. 点击「连接 GA4」页面标题栏右侧的「数据连接」，打开连接窗口。可以在窗口上方的「连接步骤」中确认当前所处步骤。在「使用 Google 账号登录」中点击 **「使用 Google 账号连接 GA4」** 按钮。

   ![GA4 连接窗口中的「使用 Google 账号连接 GA4」按钮](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-60c9b08b1bdeecb2d9ac74f2422bfcc29a7a5ec1%2Fstartguide__connect__events__ga4__02.png?alt=media)

{% hint style="info" %}
如果还没有已连接的账号，连接器页面会显示「连接后可以进行的分析」。点击「查看示例」，即可用示例数据预览连接后可查看的页面。也请查看页面下方的「连接步骤」和「开始前的准备」，确认连接步骤和需要提前准备的内容。

Google 登录会在新窗口中打开。如果窗口没有打开，请解除浏览器的弹出窗口拦截。
{% endhint %}

3. 请使用拥有 GA4 数据的 Google 账号登录。

   ![](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-71e4f9d09389bdc877a9fdf384f5c323db0f8fbd%2F60d3b932afc3.png?alt=media)
4. **请勾选所有同意复选框（可能会显示 2 个以上的复选框）。** 确认 Laplace 的条款后，点击「继续」按钮。

   ![](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-8f4493ee43f349c3b95d7a60b440922a8dfead8e%2F02e74e9fcbe5.png?alt=media)
5. 账号对接完成后，在「选择要导入的媒体资源」中勾选要连接的 GA4 账号的媒体资源。

   ![在「选择要导入的媒体资源」中勾选 GA4 媒体资源](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-3f022955cee299e3700273b3a26c916ad3e64f11%2Fstartguide__connect__events__ga4__03.png?alt=media)
6. 选择好要连接的数据源后，点击下方的 **「连接」** 按钮。

   ![选择媒体资源后点击「连接」](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-1d15dc84ccbaf227656580d6a6794e01c1a70a9d%2Fstartguide__connect__events__ga4__04.png?alt=media)

{% hint style="info" %}

* GA4 API 数据源分析直接使用 GA4 提供的 API，因此连接数据后即可立即完成。
* 调用 GA4 API 时会利用 Laplace 的缓存，可以有效避开 GA4 API 的调用量限制。
  {% endhint %}

## 查看连接状态

连接完成后，可以在「连接 GA4」页面的 **「已连接的数据」** 表中查看当前状态。

`验证状态` 列会显示以下两种状态。

* **已验证**：Google 账号验证有效，数据正常获取。
* **更新失败**：该 Google 账号的验证已断开，或因 Google 一侧的错误而无法获取数据。

点击行左侧的展开箭头，还可以查看该账号所连接的 GA4 账号和媒体资源，以及各媒体资源的 `连接状态` 和 `最近更新` 时间。

## 更换账号重新连接时

即使用与之前不同的 Google 账号重新连接同一个 GA4 媒体资源，**之前账号的对接也不会自动消失。** 两个账号的对接会同时指向同一个媒体资源，此时如果之前账号的验证已断开，仪表板可能无法加载 GA4 指标。

使用新账号连接后，请删除之前账号的对接。

1. 点击左侧导航栏的「数据连接」，然后在浏览面板中进入「连接事件」 › 「连接 GA4」。
2. 在 **「已连接的数据」** 表中，勾选 `验证状态` 为 **更新失败** 的行的复选框。
3. 点击表格上方出现的 **「删除数据」** 按钮。
4. 在 **「确定要删除连接吗？」** 确认窗口中点击 **「删除」** 按钮。

{% hint style="warning" %}
已删除的连接及其中的数据源无法恢复。删除前，请先确认**要保留的对接的验证状态是否为已验证**。
{% endhint %}

## 联系专属经理

连接 GA4 时遇到困难了吗？

请通过下方的方式联系我们，专属经理会为您提供帮助。

> 💬 [在官网咨询](https://www.analytics.laplacetec.com/contact)

**邮件咨询：** [**product@laplacetec.com**](mailto:product@laplacetec.com)