---
metadata:
- name: generator
content: Diplodoc Platform v5.64.0
alternate:
- https://boost.yandex.com/doc/en/analytics/content/common/ads-sdk-integration.md
- https://boost.yandex.com/doc/ru/analytics/content/common/ads-sdk-integration.md
- https://boost.yandex.com/doc/zh/analytics/content/common/ads-sdk-integration.md
- href: https://boost.yandex.com/doc/zh/analytics/content/common/ads-sdk-integration.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
# 与 Yandex Ads SDK 集成
您可以使用 Boost 的分析功能，而无需单独初始化 AppMetrica SDK，只要您使用的是 Yandex Mobile Ads SDK 7.6.0 或更高版本，或者安装了以下插件之一：
- Unity Ads SDK 版本 7.10.0 或更高；
- React Ads SDK 版本 7.10.0 或更高；
- Flutter Ads SDK 版本 7.9.0 或更高。
您也可以访问自动收集的广告交互事件。
主要功能：
1. 自动跟踪[基本事件](https://boost.yandex.com/doc/zh/analytics/content/data-collection/index.md)：安装、会话开始和结束、深链、应用内购买。
事件跟踪将在您在应用中初始化 Yandex Mobile Ads SDK 时自动开始。 要做到这一点，请在Analytics module界面中激活集成。 您不需要更新应用代码。
2. 自动跟踪 Yandex Mobile Ads SDK 交互事件：广告请求、响应、展示、点击。
与 Yandex Mobile Ads SDK 同步的应用会自动发送数据到 Analytics module。
如果你在应用中手动初始化 AppMetrica SDK，数据将自动开始流入，前提是 Yandex Mobile Ads SDK 也已初始化，并且在 Analytics module 设置中启用了与 Yandex Mobile Ads 的同步。
## 如果您在应用中使用 Analytics module {#already-using}
1. 将平台 Yandex Mobile Ads SDK 更新至 7.6.0 或更高版本，或者更新你需要的插件之一：
- Unity Ads SDK — 升级到版本 [7.10.0](https://ads.yandex.com/helpcenter/zh/dev/unity/changelog-unity#2025) 或更高；
- React Ads SDK — 升级到版本 [7.10.0](https://ads.yandex.com/helpcenter/zh/dev/react-native/changelog-react-native#2025) 或更高；
- Flutter Ads SDK — 升级到 7.9.0 或更高版本。
1. 转到**设置**，在**同步 Ads SDK**下添加与Yandex Mobile Ads应用的连接。
- 使用与在 Yandex Mobile Ads 中[注册](https://boost.yandex.com/application/new)应用相同的 Yandex ID。
- 请确保您已完成[应用所有权验证](https://ads.yandex.com/helpcenter/en/quick-start#step-3-verify-your-ownership-of-the-app)过程。
1. 新的关于与 Yandex Mobile Ads SDK 交互的数据将在几分钟内出现在 **事件** 报告中。 这些事件不计入[事件限制](https://boost.yandex.com/doc/zh/analytics/content/common/limits.md#limit-events)。
如果需要，您可以通过在 Yandex Mobile Ads SDK 配置中使用方法 [setAppAdAnalyticsReporting](https://yastatic.net/s3/doc-binary/src/dev/mobile-ads/ru/javadoc/com/yandex/mobile/ads/common/MobileAds.html#setAppAdAnalyticsReporting(java.lang.Boolean))（Android）或方法 [setAppAdAnalyticsReportingEnabled](https://yastatic.net/s3/doc-binary/src/dev/mobile-ads/ru/jazzy/Classes/MobileAds.html#/c:@M@YandexMobileAds@objc(cs)YMAMobileAds(cm)setAppAdAnalyticsReportingEnabled)（iOS）禁用数据收集，或者在同步设置中移除连接。
## 如果您之前还没有使用过 Analytics module {#not-using}
在注册接口中激活集成Analytics module
1. 将平台 Yandex Mobile Ads SDK 更新至 7.6.0 或更高版本，或者更新你需要的插件之一：
- Unity Ads SDK — 升级到版本 [7.10.0](https://ads.yandex.com/helpcenter/zh/dev/unity/changelog-unity#2025) 或更高；
- React Ads SDK — 升级到版本 [7.10.0](https://ads.yandex.com/helpcenter/zh/dev/react-native/changelog-react-native#2025) 或更高；
- Flutter Ads SDK — 升级到 7.9.0 或更高版本。
1. 请确保您已完成[应用所有权验证](https://ads.yandex.com/helpcenter/en/quick-start#step-3-verify-your-ownership-of-the-app)过程。
1. 在 Analytics module 中注册，使用与在 Yandex Mobile Ads 中 [注册](https://boost.yandex.com/application/new) 应用时相同的 Yandex ID。
在第1步，你会看到一个通知，告诉你可以连接Yandex Ads SDK。 如果你没有看到，请检查是否使用了不同的用户名或应用未经验证。
1. 在第 3 步 **同步 Ads SDK**，指定从哪些安装了 Ads SDK 的应用发送统计数据到 Analytics module。
我们建议为您的应用选择所有平台（例如 iOS 和 Android）。 您可以在第 5 步添加更多应用。
1. 注册后，Analytics module 将在几分钟内开始收集统计数据。 您不需要更新应用代码。
1. 如果您想将[额外数据](https://boost.yandex.com/doc/zh/analytics/content/data-collection/index.md)发送到Analytics module，例如自定义[事件](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-events.md)，请使用相应的方法。 你不需要初始化 AppMetrica SDK 来执行此操作。
1. 如果想使用 AppMetrica SDK 的高级配置功能，请手动 [初始化 AppMetrica SDK](https://boost.yandex.com/doc/zh/analytics/content/common/quick-start.md#integration-sdk)，使用在 **设置** → **主要** 部分中指定的 API Key。
## Yandex Mobile Ads SDK 自动事件 {#auto-events}
可用的事件及其参数：
- `广告请求`：来自应用的广告请求。
- `广告类型`：广告类型，例如`横幅广告`、`插页广告`、`本地化广告`或`有奖励的广告`.
- `block_id`: 广告位 ID。
- `sdk_version`: Yandex Mobile Ads SDK 版本。
- `广告尝试`：向广告网络成功发送广告请求。
- `广告类型`：例如 `横幅广告`、`插页广告`、`本地化广告` 或 `有奖励广告`.
- `block_id`: 广告位 ID。
- `sdk_version`: Yandex Mobile Ads SDK 版本。
- `广告网络`：提供广告的网络。
- `ad_filled_request`: 广告请求，导致广告被选中。
- `广告类型`：广告类型，例如`横幅广告`、`插页广告`、`本地化广告`或`有奖励广告`.
- `block_id`: 广告位 ID。
- `sdk_version`: Yandex Mobile Ads SDK 版本。
- `广告网络`：提供广告的网络。
- `banner_id`: 广告位 ID。
- `广告展示`：广告展示。
- `广告类型`：广告类型，例如`横幅广告`、`插页广告`、`本地化广告`或`有奖励广告`.
- `block_id`: 广告位 ID。
- `sdk_version`: Yandex Mobile Ads SDK 版本。
- `广告网络`：提供广告的网络。
- `banner_id`: 广告位 ID。
- `广告收益`：广告网络货币中的广告展示收益。
- `货币`：广告网络的货币。
- `精度`：`ad_revenue`值的准确性。 可接受的值：`publisher_defined`，该值基于中介界面中的CPM阈值；以及`estimated`，该值基于自动化策略。
- `广告点击`：点击广告。
- `广告类型`：广告类型，例如`横幅广告`、`插页广告`、`本地化广告`或`有奖励广告`.
- `block_id`: 广告位 ID。
- `sdk_version`: Yandex Mobile Ads SDK 版本。
- `广告网络`：提供广告的网络。
- `banner_id`: 广告位 ID。
- `广告奖励`：观看“奖励式”广告获得奖励。
- `广告类型`：广告类型，例如`横幅广告`、`插页广告`、`本地化广告`或`有奖励广告`.
- `block_id`: 广告位 ID。
- `sdk_version`: Yandex Mobile Ads SDK 版本。
- `广告网络`：提供广告的网络。
## 了解更多 {#learn-more}
- [我如何使用 AppMetrica SDK 的高级配置功能？](https://boost.yandex.com/doc/zh/analytics/content/troubleshooting/troubleshooting.md#yads-sdk-extended)
- [如果我已经在应用中使用了AppMetricaSDK，是否需要对集成做任何修改？](https://boost.yandex.com/doc/zh/analytics/content/troubleshooting/troubleshooting.md#yads-sdk-already-using)
- [如何禁用 Yandex Ads SDK 的自动事件？](https://boost.yandex.com/doc/zh/analytics/content/troubleshooting/troubleshooting.md#yads-sdk-disable-auto)
- [如何使用与 Yandex Mobile Ads SDK 初始化不同的逻辑来初始化 AppMetrica SDK？](https://boost.yandex.com/doc/zh/analytics/content/troubleshooting/troubleshooting.md#yads-sdk-other-logic)
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。
联系支持
为文档提出改进建议