---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/data-collection/about-ecommerce.md
  - https://boost.yandex.com/doc/ru/analytics/content/data-collection/about-ecommerce.md
  - https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-ecommerce.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-ecommerce.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064

# 电子商务

在进行应用内购买时，用户会执行各种操作：电子商务事件。 例如：

- 打开页面。
- 查看产品资料和页面。
- 将商品添加到购物车或从购物车中移除。
- 开始并完成购买。

使用 Analytics module，您可以收集这些操作的信息，并在 [电子商务](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/ecommerce-report.md) 报告中跟踪其统计数据。

在设置好发送电子商务事件后，您可以：

- 分析从产品浏览到购买的销售漏斗。
- 评估不同产品类别的效果。
- 找出流行的产品和应用屏幕。
- 分析促销码的使用情况。
- 评估每个漏斗阶段的转化率。
- 比较不同获取渠道的效果。
- 分析购买地理分布。

{% note info "" %}

电子商务事件不包含在付费限制内。 发送这些事件不会影响您的[计划费用](https://boost.yandex.com/doc/zh/analytics/content/common/pricing/ru-currency.md)。

{% endnote %}

## 如何计算电商数据 {#calculation}

数据通过 SDK 从每个用户在完成购买行为（电子商务事件）时传输。

所有电子商务事件在 Analytics module 中都与用户关联，电子商务指标是基于这些数据计算的。

货币指标，包括虚拟金钱：

| **指标** | **描述** |
| ----------- | ----------- |
| Revenue | 报告期间电商事件的总收入。 |
| 平均订单价值 (AOV) | 报告期间总收入与购买次数的比值。 |
| 平均每用户收入 (ARPU) | 报告期间电商事件收入与同期应用用户数的比值。 |
| 每位付费用户的平均收入（ARPPU） | 报告期间电商事件收入与同期付费用户数的比值。 |
| 平均产品价格 | 报告期间产品总成本与购买产品数量的比值。 |
| 购买物品的基本成本 | 报告期间购买所有产品的总基础成本。 |
| 购买商品的实际成本 | 报告期间所有购买产品的总实际成本。 |
| 平均基础产品价格 | 报告期间产品总基础成本与购买产品数量的比值。 |
| 平均实际产品价格 | 报告期间产品总实际成本与购买产品数量的比值。 |

用户行为分析：

| **指标** | **描述** |
| ----------- | ----------- |
| 产品信息视图 | 报告期间产品卡片的查看次数。 |
| 查看产品信息的用户 | 报告期间查看产品卡片的独立用户数。 |
| 产品页面浏览次数 | 报告期间产品页面浏览次数。 |
| 查看产品页面的用户 | 报告期间查看产品页面的独立用户数。 |
| 购物车添加数量 | 报告期间将商品添加到购物车的事件数量。 |
| 已添加到购物车的商品 | 报告期间添加到购物车的商品总数。 |
| 已将商品添加到购物车的用户 | 报告期间将商品添加到购物车的独立用户数。 |
| 已从购物车移除的物品 | 报告期间从购物车中移除的商品总数。 |
| 已从购物车移除商品的用户 | 报告期间从购物车中移除商品的独立用户数。 |
| Items purchased → 已购买的商品 | 报告期间购买的产品总数。 |
| 购买了商品的用户 | 报告期间进行购买的唯一用户数量。 |
| 每用户购买的商品数量 | 报告期间购买产品数量与用户数量的比例。 |
| 电子商务购买 | 报告期间的购买数量。 |
| 每用户购买次数 | 报告期间购买数量与用户数量的比例。 |
| 开始购买 | 报告期间开始购买的事件数量。 |
| 开始购买的用户 | 报告期间开始购买的独立用户数。 |
| Pageviews | 报告期间的页面查看次数。 |
| 查看过页面的人 | 报告期间查看页面的人数（去重）。 |

## 设置发送电子商务事件 {#send-ecommerce}

有两种设置发送电子商务事件的方式：通过[SDK](#send-sdk)（主要方法）或[Post API](#send-post-api)。

### 设置通过 SDK 发送电子商务事件 {#send-sdk}

#### 步骤 1. 激活 SDK {#activate-sdk}

确保你的应用中已激活 AppMetrica SDK：

- [Android](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/quick-start.md)
- [iOS](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/analytics/quick-start.md)
- [Flutter](https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/analytics/quick-start.md)
- [React Native](https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/analytics/quick-start.md)
- [Unity](https://boost.yandex.com/doc/zh/analytics/content/sdk/unity/analytics/quick-start.md)

#### 步骤 2. 设置通过 SDK 发送电子商务事件 {#setup-sdk}

选择平台和集成方式，并设置相应的 SDK 方法：

- [安卓](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#send-ecommerce)
- [iOS](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/analytics/ios-operations.md#send-ecommerce)
- [Flutter](https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/analytics/flutter-operations.md#send-ecommerce)
- [React Native](https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/analytics/react-native-operations.md#send-ecommerce)
- [Unity](https://boost.yandex.com/doc/zh/analytics/content/sdk/unity/analytics/unity-operations.md#send-ecommerce)

{% note info "Debugging" %}

在 Analytics module 中，无法将事件分为测试和非测试事件。 如果您使用主 API 密钥调试广告赚钱数据收集，测试事件会被包含在总体统计中。 因此，为了调试，请使用报告器将数据发送到额外的 API 密钥。 

{% cut "了解更多关于报告员的信息" %}

- Android
  - [将统计数据发送到额外的API密钥](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#reporter-different-apikey). 
  - [为报告员跟踪会话](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-listen.md). 

- iOS
  - [将统计数据发送到额外的API密钥](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/analytics/ios-operations.md#reporter-different-apikey). 
  - [为报告员跟踪会话](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/analytics/ios-listen.md#reporter-listen). 

- Flutter
  - [将统计数据发送到额外的API密钥](https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/analytics/flutter-operations.md#reporter-different-apikey).

- React Native
  - [将统计数据发送到额外的 API 密钥](https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/analytics/react-native-operations.md#reporter-different-apikey). 

- Unity
  - [将统计数据发送到额外的 API 密钥](https://boost.yandex.com/doc/zh/analytics/content/sdk/unity/analytics/unity-operations.md#reporter-different-apikey). 

{% endcut %}

{% endnote %}

### 设置通过 Post API 发送电子商务事件 {#send-post-api}

使用 Post API 可能是个好主意的情况如下：

- 历史数据导入 — 上传 SDK 尚未安装时期的事件（最多过去 14 天）。
- 服务器验证 — 在对数据进行额外处理或验证后从后端传输数据。
- 数据聚合 — 在将数据发送到 Analytics module 之前从多个来源收集数据。
- 离线场景 — 发送设备在离线状态下收集的数据。
- 与第三方系统集成 — 通过其API从广告网络获取数据并发送到Analytics module
- 高级逻辑 — 在发送分析数据前在服务器上应用业务逻辑。

请考虑 Post API 的[特殊功能](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/about.md)和[限制](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/restrictions.md)。

#### 步骤 1. 获取 Post API 密钥 {#send-api-key}

转到**设置** → **主要**，获取用于请求授权的**Post API 密钥**。 

{% note info "Debugging" %}

在调试数据收集时，为了确保测试事件不会被包含在总体统计中，请为测试环境和生产环境使用不同的 Post API 密钥。 

{% endnote %}

#### 步骤 2. 准备要发送的数据 {#send-api-data}

查看有关通过 Post API 上传电商事件的文档：[上传电商事件](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/post/post-ecommerce.md)

收集电商事件所需的参数。

#### 步骤 3. 发送HTTP请求 {#send-api-request}

Post API 支持两种数据传输方法：

- 在请求体中发送数据（CSV 格式）。 适合批量上传数据。 

  使用以下端点：`/logs/v1/import/ecommerce.csv`。
  
  在请求体中以CSV格式传递数据。
   
- 通过请求参数发送数据。 适用于单独的事件。
  
  使用以下端点：`/logs/v1/import/ecommerce`.
  
  将数据作为URL参数传递。
   
#### 第4步。 处理响应 {#send-api-response}

API 返回以下响应代码：

- `200`: 数据上传成功。
- `403`: 授权错误。
- `400`: 缺少必需的参数。

## 检查报告中的数据 {#metrics}

在通过 SDK [或](#send-sdk) 使用 Post API [设置通过 Post API 发送电子商务事件](#send-post-api) 设置发送电子商务事件后，请确保事件数据流入系统，并且事件数量与广告展示数量相匹配。

指标可在[电子商务](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/ecommerce-report.md)报告中查看。 您可以评估：

- 产品详情页和页面浏览次数。
- 购物车添加数量。
- 购买数量。
- 收入和折扣销售额。
- 购买地理分布，使用按城市分组数据的维度。

<!-- source: zh/analytics/content/_includes/feedback-button.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/analytics/content/_includes/feedback-button.md -->