文档

支持

Unity Ads Monetization

Android developer monetization guide

iOS developer monetization guide

Privacy consent setup

Unity Ads Monetization

Unity Ads SDK API 弃用政策

Review Unity's guidelines on API deprecation. Check timelines, notifications, and exceptions for SDK changes.
阅读时间3 分钟最后更新于 3 个月前
Unity 鼓励您在开发时使用最能满足您需求的 API 集。但是，仍然鼓励所有开发者尽可能频繁地更新到最新的 SDK 版本。 为了确保 Unity 广告提供一致的最佳开发体验，必须继续发展和扩展 SDK 及其 API 类。随着我们适应平台和市场的变化，API 类会变得过时，需要替换为更高效的版本。 如果 Unity Ads 打算移除某个 API 类，或以破坏先前支持的功能的方式对其进行更改，Unity 将努力做到：
  • 将 API 标记为已弃用，在发行说明中记录此弃用，并（如果适用）更新文档和示例，以便在下一个主要或次要版本中提供偏好的替代方案。
  • 在未来的主要版本中移除已弃用的 API。
  • 以合理的方式尽可能通过使用弃用通知（请参阅通知部分）提供不少于三 (3) 个月的关于移除已弃用 API 的通知。

例外

上述弃用准则的例外情况如下：
  • 由于适用法律或合同权利发生变化，Unity Ads 必须移除 API。
  • 继续提供相关功能可能会产生安全性, 合规性, 数据隐私或其他监管风险，或在其他方面使 Unity 和/或其第三方合作伙伴和客户面临任何责任或损害风险（由 Unity 自行确定）。
  • 继续提供相关功能可能会给 Unity 或其第三方合作伙伴和客户带来巨大的经济或技术负担（包括加重任何基础 Unity 服务的负担或威胁其完整性, 性能或可用性；由 Unity 自行确定）。

通知

如果 API 过时，Unity Ads 将以合理的方式尽可能通过以下一种或多种方式提供弃用通知：
  • 开发者在 Monetization（变现）后台上发布帖子。该帖子将包含弃用通知, 替代 API（如果可用）以及要移除的目标 SDK 版本。
  • 官方在技术文档更新中说明替代 API（如果可用）；或
  • 更新 SDK 变更日志中的一个部分以提供一些链接，通过这些链接即可查看要弃用的类, 适用的替换类以及预计的生命周期结束日期等更多详细信息。

期望

在维护 API 类及其支持的功能时，我们希望尽可能确保与早期版本兼容。如果需要以不向后兼容的方式更改某些内容，Unity 广告会创建新资源, 媒体类型或版本，并根据 API 弃用政策维护旧资源或媒体类型。 Unity Ads 将为所有已宣布的 API 弃用情况提供以下信息：
  • 要移除的 API
  • 已弃用的 SDK 版本
  • 具有类似功能的换用 API
  • 已移除（或将要移除）的 SDK 版本
  • 弃用原因

这些准则的变更

这些准则如有更改，恕不另行通知，Unity 保留自行决定随时修改其 API 弃用流程的权利。

定义和概念

弃用

已弃用的 API 类仍可使用，但未来将不再受支持，并将在未来的版本中移除。

弃用通知

提供在即将发布的 SDK 版本中将替换 API 类的预先通知。这是开发者升级代码的好时机。

语义版本控制

Unity Ads SDK 遵循语义版本控制标准。只会在发布的主要版本中移除 API 类。

API 向后兼容性

Unity 尝试提供 API 参考中介绍的所有公共 API 的向后兼容性。开发者必须使用 API 参考中列出的支持的 API 来确保兼容性。