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

# 第三方分析

> 通过 Google Analytics 4、Google Tag Manager 和 Meta Pixel，在您 Dodo Payments 托管的页面上跟踪页面浏览和电子商务事件。

<Frame>
  <img src="https://mintcdn.com/dodopayments/OJISfHo1pPGtWHk9/images/analytics-cover.png?fit=max&auto=format&n=OJISfHo1pPGtWHk9&q=85&s=6f9b234fb9bb78755cd79b315e594826" alt="Analytics Integration" style={{ maxHeight: '500px', width: 'auto' }} width="2866" height="1436" data-path="images/analytics-cover.png" />
</Frame>

跟踪客户从商品展示页直到结账完成的整个旅程。Dodo Payments 与 Google Analytics 4、Google Tag Manager 和 Meta Pixel 集成，为您托管的所有页面提供全面的分析数据。

<Info>
  一旦您在仪表板中添加跟踪 ID，分析跟踪将自动在您的 Storefront、Checkout 页面和 Customer Portal 上启用。
</Info>

<Warning>
  客户浏览器中的广告拦截器可能会阻止部分访客的分析跟踪功能。
</Warning>

## 支持的平台

<CardGroup cols={3}>
  <Card title="Google Analytics 4" icon="chart-simple">
    使用 GA4 跟踪页面浏览和电子商务行为。
  </Card>

  <Card title="Google Tag Manager" icon="tags">
    添加并管理营销标签。
  </Card>

  <Card title="Meta Pixel" icon="meta">
    跟踪 Facebook 和 Instagram 广告的转化情况。
  </Card>
</CardGroup>

## 快速入门

<Steps>
  <Step title="Open Business Settings">
    在您的 Dodo Payments 仪表板中，导航到 **设置 → 业务**，然后滚动到 **分析** 部分。
  </Step>

  <Step title="Enable Your Tracking Platform">
    打开所需分析平台的开关并输入您的跟踪 ID：

    * **Google Analytics**：输入您的 Measurement ID（格式：`G-XXXXXXXXXX`）
    * **Google Tag Manager**：输入您的 Container ID（格式：`GTM-XXXXXXX`）
    * **Meta Pixel**：输入您的 Pixel ID（数字，10-20 位）
  </Step>

  <Step title="Save Your Settings">
    点击 **Save** 应用您的跟踪配置。
  </Step>

  <Step title="Verify Tracking">
    访问您的 Storefront 或创建一次测试结账，以验证事件是否在分析仪表板中被跟踪。
  </Step>
</Steps>

## Google Analytics 4

[Google Analytics 4](https://marketingplatform.google.com/about/analytics/) 提供全面的 Web 分析以及电子商务跟踪能力。通过 Dodo Payments 集成，您可以跟踪从浏览商店到完成购买的整个客户旅程。

### 添加您的 Google Analytics Measurement ID

1. 在 Google Analytics 中，转到 **管理员** → **数据流** → 选择您的网络流
2. 复制 **测量 ID**（以 `G-` 开头）
3. 在 Dodo Payments 仪表板中，转到 **设置** → **业务** → **分析**
4. 切换打开 **Google Analytics** 并粘贴您的测量 ID
5. 点击 **保存**

<Tip>
  如果您尚未拥有 Google Analytics 资产，请按照 [Google 的设置指南](https://support.google.com/analytics/answer/9304153) 创建一个。
</Tip>

### Google Analytics 跟踪的事件

我们在您托管的 storefront 和 checkout 页面上跟踪以下事件。每个事件都会发送包含产品信息、交易总额和货币等数据。

#### Storefront 事件

| Event            | Description               |
| ---------------- | ------------------------- |
| `view_item_list` | 当 storefront 页面加载并展示商品时触发 |
| `select_item`    | 当客户点击商品并开始结账时触发           |

#### Checkout 事件

| Event               | Description           |
| ------------------- | --------------------- |
| `view_item`         | 当 checkout 页面加载时触发    |
| `view_cart`         | 当 checkout 加载或选择变体时触发 |
| `apply_discount`\*  | 当成功应用有效优惠码时触发         |
| `remove_discount`\* | 当移除优惠码时触发             |
| `add_payment_info`  | 当客户提交付款表单时触发          |
| `purchase`          | 当付款成功时触发              |

<Note>
  `apply_discount` 和 `remove_discount` 是自定义事件，不包含在 [Google Analytics 标准电子商务事件](https://support.google.com/analytics/answer/9267735) 中。
</Note>

### 在 Overlay/Inline Checkout 中使用 GA4

若要在嵌入您自己网站的 overlay 或 inline checkout 中跟踪 Google Analytics 事件，需在结账嵌入的网页中安装 Google Analytics 跟踪代码。

安装完成后，所有上述跟踪事件会自动发送到您的 Google Analytics 账户，无需额外配置。

## Google Tag Manager

[Google Tag Manager](https://marketingplatform.google.com/about/tag-manager/) 让您无需修改代码即可管理营销和分析标签。通过 GTM 部署的标签会在所有 Dodo Payments 托管页面上触发。

### 添加您的 GTM Container ID

1. 在 Google Tag Manager 中，复制您的 **容器 ID**（以 `GTM-` 开头）
2. 在 Dodo Payments 仪表板中，转到 **设置** → **业务** → **分析**
3. 切换打开 **Google Tag Manager** 并粘贴您的容器 ID
4. 点击 **保存**

<Info>
  使用 GTM 时，您可以在容器中直接配置额外的跟踪（如 Google Ads 转化）。Dodo Payments 集成会注入 GTM 脚本及 noscript 备选方案，以确保最大兼容性。
</Info>

### 在 Overlay/Inline Checkout 中使用 GTM

对于嵌入您网站的 overlay 或 inline checkout，请在您的站点上安装 GTM。结账将继承您的 GTM 配置，并在嵌入的框架中触发事件。

## Meta Pixel

[Meta Pixel](https://www.facebook.com/business/tools/meta-pixel/) 跟踪客户在店铺中的行为，以衡量 Facebook 和 Instagram 广告活动的效果。跟踪从点击广告到完成购买的转化。

### 添加您的 Meta Pixel ID

1. 在 [Meta 事件管理工具](https://www.facebook.com/events_manager2/) 中，创建或选择您的像素
2. 复制 **像素 ID**（数字，通常为 15-16 位数字）
3. 在 Dodo Payments 仪表板中，转到 **设置** → **业务** → **分析**
4. 切换打开 **Meta 像素** 并粘贴您的像素 ID
5. 点击 **保存**

<Tip>
  如果尚未创建 Pixel，请按照 Meta 的 [Pixel 设置指南](https://www.facebook.com/business/help/952192354843755) 操作。
</Tip>

### Meta Pixel 跟踪的事件

我们跟踪以下事件，您可以在 [Meta Events Manager](https://www.facebook.com/events_manager2/) 中查看。每个事件都会发送包含内容 ID、价值和货币的数据。

<Note>
  事件可能不会立即出现在 Meta Events Manager 中，可能会有几分钟的延迟。
</Note>

#### Storefront 事件

| Event              | Description             |
| ------------------ | ----------------------- |
| `PageView`         | 当 storefront 页面加载时触发    |
| `ViewContent`      | 当 storefront 加载并展示商品时触发 |
| `InitiateCheckout` | 当客户点击商品并开始结账时触发         |

#### Checkout 事件

| Event              | Description           |
| ------------------ | --------------------- |
| `PageView`         | 当 checkout 页面加载时触发    |
| `AddToCart`        | 当 checkout 加载或选择变体时触发 |
| `ApplyDiscount`\*  | 当成功应用有效优惠码时触发         |
| `RemoveDiscount`\* | 当移除优惠码时触发             |
| `AddPaymentInfo`   | 当客户提交付款表单时触发          |
| `Purchase`         | 当付款成功时触发              |

<Note>
  `ApplyDiscount` 和 `RemoveDiscount` 是自定义事件，不包含在 [Meta 的标准事件](https://developers.facebook.com/docs/meta-pixel/reference#standard-events) 中。
</Note>

## 完整事件参考

下表列出了 Google Analytics 4 和 Meta Pixel 跟踪的所有事件：

| 触发条件            | GA4 事件             | Meta Pixel 事件      | 位置         |
| --------------- | ------------------ | ------------------ | ---------- |
| Storefront 页面加载 | `view_item_list`   | `ViewContent`      | Storefront |
| 客户点击商品          | `select_item`      | `InitiateCheckout` | Storefront |
| Checkout 页面加载   | `view_item`        | `AddToCart`        | Checkout   |
| 查看购物车/选择变体      | `view_cart`        | -                  | Checkout   |
| 应用优惠码           | `apply_discount`   | `ApplyDiscount`    | Checkout   |
| 移除优惠码           | `remove_discount`  | `RemoveDiscount`   | Checkout   |
| 提交付款表单          | `add_payment_info` | `AddPaymentInfo`   | Checkout   |
| 付款成功            | `purchase`         | `Purchase`         | Checkout   |

## 平台覆盖

分析跟踪可在不同的 Dodo Payments 端口上使用：

| 端口                         | Google Analytics 4 | Google Tag Manager | Meta Pixel |
| -------------------------- | ------------------ | ------------------ | ---------- |
| Storefront                 | 是                  | 是                  | 是          |
| Checkout（托管）               | 是                  | 是                  | 是          |
| Checkout（Overlay/Inline）\* | 是                  | 是                  | 是          |
| Customer Portal            | 是                  | 是                  | 否          |

<Info>
  \*对于 overlay 和 inline checkout，请先在您自己的网站上安装跟踪代码以获取完整归因。嵌入式结账将自动跟踪事件。
</Info>

## 事件数据包含内容

每个跟踪事件都包含相关的电子商务数据，帮助您分析客户行为：

### 产品数据

* 产品 ID
* 产品名称
* 价格
* 货币
* 数量

### 交易数据（购买事件）

* 交易/支付 ID
* 总金额
* 税额
* 货币
* 应用的折扣

### 客户数据

* 客户 ID（针对回头客）
* 邮箱（在适用时会进行哈希处理以保障隐私）

## 最佳实践

<AccordionGroup>
  <Accordion title="Test Your Integration">
    添加跟踪 ID 后，访问您的 storefront 并完成一次测试结账，以验证事件是否出现在分析仪表板中。使用 Google Analytics 实时报告或 Meta Events Manager 的测试事件功能。
  </Accordion>

  <Accordion title="Use UTM Parameters">
    为营销链接添加 UTM 参数，以跟踪哪些活动带来转化。Dodo Payments 会在整个结账流程中保留 UTM 参数。
  </Accordion>

  <Accordion title="Set Up Conversion Goals">
    在 Google Analytics 中，为 `purchase` 创建转化事件以跟踪转化率。在 Meta Ads Manager 中，使用 `Purchase` 事件作为广告系列的优化目标。
  </Accordion>

  <Accordion title="Enable Enhanced E-commerce">
    如果使用 Google Tag Manager，建议设置增强型电子商务报告，以获取详细的漏斗分析和产品表现指标。
  </Accordion>
</AccordionGroup>

## 故障排查

<AccordionGroup>
  <Accordion title="Events not appearing in Google Analytics">
    * 验证您的 Measurement ID 是否正确（格式：`G-XXXXXXXXXX`）
    * 检查 Google Analytics 实时报告——事件首先会出现在此处
    * 确保在 Dodo Payments 设置中已启用开关
    * 等待几分钟，可能存在处理延迟
    * 在隐身窗口中测试以排除广告拦截器影响
  </Accordion>

  <Accordion title="Events not appearing in Meta Events Manager">
    * 验证您的 Pixel ID 是否正确（数字，10-20 位）
    * 使用 Meta Pixel Helper 浏览器扩展进行调试
    * 检查 Events Manager 中的测试事件标签
    * 事件可能需要几分钟才能出现
    * 测试期间请确保禁用广告拦截器
  </Accordion>

  <Accordion title="GTM tags not firing">
    * 确认您的 Container ID 是否正确（格式：`GTM-XXXXXXX`）
    * 使用 GTM 预览模式调试标签触发情况
    * 检查 GTM 容器中触发器是否配置正确
    * 验证容器已发布（而非仅处于草稿）
  </Accordion>

  <Accordion title="Overlay/Inline checkout not tracking">
    * 请先在自己的站点上安装跟踪代码
    * 确保跟踪在结账覆盖弹窗打开前加载完成
    * 检查浏览器控制台是否有 JavaScript 错误
    * 如果使用 GA4，请确认已配置跨域跟踪
  </Accordion>

  <Accordion title="Purchase events showing wrong amounts">
    * 金额以最小货币单位（分）发送
    * 验证您的分析工具是否配置为显示正确货币
    * 检查税费是否按预期包含/排除
  </Accordion>
</AccordionGroup>

## 相关资源

<CardGroup cols={2}>
  <Card title="Segment Integration" icon="chart-line" href="/integrations/segment">
    将支付事件发送到 Segment，以实现高级分析和 CDP 集成。
  </Card>

  <Card title="Dub Integration" icon="https://mintcdn.com/dodopayments/LYWHtNbGSpS1P01t/images/logos/dub.svg?fit=max&auto=format&n=LYWHtNbGSpS1P01t&q=85&s=c36ca87c0811f65b3d8a4a79e4a34242" href="/integrations/dub" width="64" height="64" data-path="images/logos/dub.svg">
    使用 Dub 跟踪销售转化和联盟归因。
  </Card>

  <Card title="Customer.io Integration" icon="envelope" href="/integrations/customer-io">
    基于支付事件触发自动化电子邮件活动。
  </Card>

  <Card title="Webhooks" icon="webhook" href="/developer-resources/webhooks">
    使用 Webhook 事件创建自定义分析集成。
  </Card>
</CardGroup>