与 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. 自动跟踪基本事件:安装、会话开始和结束、深链、应用内购买。

    事件跟踪将在您在应用中初始化 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

  1. 将平台 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 或更高版本。
  2. 转到设置,在同步 Ads SDK下添加与Yandex Mobile Ads应用的连接。

  3. 新的关于与 Yandex Mobile Ads SDK 交互的数据将在几分钟内出现在 事件 报告中。 这些事件不计入事件限制。

如果需要,您可以通过在 Yandex Mobile Ads SDK 配置中使用方法 setAppAdAnalyticsReporting(Android)或方法 setAppAdAnalyticsReportingEnabled(iOS)禁用数据收集,或者在同步设置中移除连接。

如果您之前还没有使用过 Analytics module

在注册接口中激活集成Analytics module

  1. 将平台 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 或更高版本。
  2. 请确保您已完成应用所有权验证过程。

  3. 在 Analytics module 中注册,使用与在 Yandex Mobile Ads 中 注册 应用时相同的 Yandex ID。

    在第1步,你会看到一个通知,告诉你可以连接Yandex Ads SDK。 如果你没有看到,请检查是否使用了不同的用户名或应用未经验证。

  4. 在第 3 步 同步 Ads SDK,指定从哪些安装了 Ads SDK 的应用发送统计数据到 Analytics module。

    我们建议为您的应用选择所有平台(例如 iOS 和 Android)。 您可以在第 5 步添加更多应用。

  5. 注册后,Analytics module 将在几分钟内开始收集统计数据。 您不需要更新应用代码。

  6. 如果您想将额外数据发送到Analytics module,例如自定义事件,请使用相应的方法。 你不需要初始化 AppMetrica SDK 来执行此操作。

  7. 如果想使用 AppMetrica SDK 的高级配置功能,请手动 初始化 AppMetrica SDK,使用在 设置 → 主要 部分中指定的 API Key。

Yandex Mobile Ads SDK 自动事件

可用的事件及其参数:

  • 广告请求:来自应用的广告请求。

    • 广告类型:广告类型,例如横幅广告、插页广告、本地化广告或有奖励的广告.
    • 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 版本。
    • 广告网络:提供广告的网络。

了解更多

如果您没有找到所需答案,可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能,请附上截图。

联系支持 为文档提出改进建议
上一篇
下一篇