文档

LevelPlay SDK - Android

APS 集成

通过配置 APS 帐户并设置与 LevelPlay 的集成,将 Amazon Publisher Services (APS)与 Unity LevelPlay 集成。
阅读时间5 分钟最后更新于 1 个月前

重要
以下文档涉及非 Unity 开发、拥有或运营的产品或服务(“第三方产品”)。 这些信息可能已过时或不完整,仅为方便您参考才提供。 您对任何第三方产品的使用均受产品自身条款的约束。 Unity 对这些产品不提供任何担保,也不对因使用这些产品而造成的任何损害或损失负责,包括与第三方供应商提供的内容、广告或材料有关的问题。
注意
Amazon 发布者服务 (APS) 是一个仅限邀请的计划。要集成 APS,您需要初始化 LevelPlay SDK 和 APS SDK。确保执行以下详细说明的完整集成流程,以便在应用程序中显示 APS 广告服务。
本指南适用于 LevelPlay SDK 9.0.0 及更高版本。有关旧版本(8.0.0 和更高版本),请参阅这篇文章。
注意
要查看此聚合网络的适配器更改日志,请参阅适用于 Android 的聚合网络。

支持 APS Android SDK 范围

Android APS 适配器 5.0.0 旨在通过范围依赖项集成 APS Android SDK。通过使用 9.8+ 依赖项,无需集成新的 LevelPlay 适配器,即可自动集成到任何未来的 APS Android SDK(小于 9.8.8)。

创建 APS 帐户

  1. 联系 APS 以设置app程序的帐户。要创建 APS 帐户,请访问 APS 网站,选择 Contact us,然后发出请求。
  2. 如果您的 APS 请求获得批准,您将收到一个邀请链接,用于在 APS 中注册和创建帐户。
  3. 在 LevelPlay 中设置 APS 之前,必须完成上述步骤。

在 APS 网络中设置席位

  1. 从 Apps 菜单中选择正确的应用程序,然后选择 Setup。
  2. 选择 LevelPlay 作为 Monetization 服务设置菜单
  3. 添加字段并为每个字段定义:
    • Name(名称)
    • 广告大小
    • 价格点(自动/手动)
  4. 完成添加所有字段并获取凭据:
    1. 获取 app ID
    2. 下载价格点 CSV 文件。

激活 APS 网络

在 LevelPlay 平台中,访问 SDK Networks 设置以将 APS 参数配置到您的 LevelPlay 帐户中。
  1. 拥有上述凭据后,登录 LevelPlay 帐户,然后选择 Monetize > Setup > SDK Networks。
  2. 从 Available Networks 的表中选择 APS,然后选择 Activate
  3. 从广告网络列表中选择 APS,然后选择 Setup。
  4. 输入您的 APS app ID 并按原样上传 CSV 文件。
  5. APS app 设置页面界面将刷新。

在 LevelPlay 控制面板中更新 APS 数据

  • 请注意,系统会自动填充“Slot Name”、“Price Points”和“大小”字段。
  • 为每个字段名称填写以下字段:
    • UUID
    • APS 格式
    • 大小
  • 您可能需要参阅 APS 网站以获取此信息。
  • 填写 UUID、APS Format 和 Size 字段后,选择 Save。

将 APS 适配器添加到构建中

Gradle

  1. 确保 app 模块的构建.gradle 脚本中存在以下 Maven 网址
    repositories { mavenCentral()}
  2. 将适配器的 Maven 名称添加到 app 模块的构建.gradle 脚本。
    dependencies { implementation 'com.unity3d.ads-mediation:aps-adapter:5.0.0' implementation 'com.amazon.android:aps-sdk:11.1.0+' implementation 'com.iabtcf:iabtcf-decoder:2.0.10'}

更新 AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

仅适用于 Proguard 用户

如果将 ProGuard 与 APS 适配器结合使用,必须将以下代码添加 ProGuard 文件中:
- 保留类 com.amazon.device.广告服务。** { *; }

Init APS SDK

APS 网络要求初始化 ironSource 和 APS SDK 以显示 APS 广告服务。
在打开应用程序后以及在初始化 LevelPlay SDK 之前,立即初始化 APS SDK。使用 APS 设置的步骤 2 中定义的 APS app ID。
AdRegistration.getInstance(APS_app_ID, this);//其中“this”是活动上下文。

高级设置

美国隐私合规性

LevelPlay 的聚合平台允许发行商根据美国各州隐私法(例如加利福尼亚州隐私权法 (CPRA))限制销售或共享终端用户的个人信息。此功能是使用 LevelPlay SDK 8.4.0 及更高版本以及 APS Android 适配器 5.1.0 及更高版本已启用的。
有关更多信息,请参阅法规高级设置。
您现在可以在应用程序中交付 APS 需求。