Offerwall 迁移指南
按照 Offerwall 迁移指南从 ironSource 过渡到 Tapjoy。
阅读时间3 分钟最后更新于 4 个月前
-
集成 Unity Offerwall 适配器。您可以使用 ironSource 聚合管理器窗口将此适配器添加到项目中。
-
添加 Offerwall Unity 插件。此插件可用于从 C# 代码访问 Offerwall SDK 方法。
Tapjoy Unity 插件使用 External Dependency Manager 安装 Offerwall iOS SDK 的副本，并包含了 Tapjoy Android SDK 的副本。由于我们已在步骤 1 中使用适配器添加了 SDK，因此不需要包含第二个副本（我们仅需桥接代码）。修改 /Assets/Tapjoy/Editor 中的 文件，移除 iOS 引用，仅包含 Android Unity Bridge。将该文件的内容替换为以下内容：
TJPluginDependencies<dependencies><androidPackages> <repositories> <repository>https://sdk.tapjoy.com</repository> </repositories> <androidPackage spec="com.tapjoy:tapjoy-android-unitybridge:12.11.1@aar"/> </androidPackages></dependencies>
- 直接调用 Offerwall SDK 函数。我们需要这样做才能显示 Tapjoy Offerwall。首先，需要将 Tapjoy 导入您的类：
import TapjoyUnity
- 初始化 Offerwall SDK。初始化成功（或失败）时，您将收到回调，在收到成功回调之前，无需进行任何 Offerwall SDK 调用。
#if UNITY_ANDROID Tapjoy.Connect("your_android_sdk_key");#elif UNITY_IOS Tapjoy.Connect("your_ios_sdk_key");#endif
- 创建一个广告位对象和一个监听器（了解步骤 5 中的监听器的更多信息）。广告位在 Offerwall 后台上进行配置，其中包含 Offerwall 内容卡片。在以下示例中，假设您已将广告位命名为 Offerwall。实际上，您可以将其命名为任何名称，但此处在代码中使用的名称必须与后台上的名称匹配。
TJPlacement placement = TJPlacement.CreatePlacement("Offerwall");
- 请求您的广告位。通过以下调用来加载广告位，以便在需要显示广告位时广告位准备就绪。Offerwall 广告位应该会快速加载，但最好在显示 Offerwall 之前进行此调用。
placement.requestContent();
- 我们提供了一系列可供您实现的回调。
TJPlacement.OnRequestSuccess += HandlePlacementRequestSuccess;TJPlacement.OnRequestFailure += HandlePlacementRequestFailure;TJPlacement.OnContentReady += HandlePlacementContentReady;TJPlacement.OnContentShow += HandlePlacementContentShow;TJPlacement.OnContentDismiss += HandlePlacementContentDismiss;
以上有一些回调可以替换您可能已经实现的 ironSource 回调。下表显示了相应的回调，便于您将自定义逻辑移到相应的 Tapjoy 回调中：
ironSource 回调 | Tapjoy 回调 |
|---|---|
| onOfferwallClosedEvent | OnContentDismiss |
| onOfferwallOpenedEvent | OnContentShow |
| onOfferwallAvailableEvent | OnContentReady |
从 Tapjoy 服务器返回内容请求时，将调用 。当内容 (Offerwall) 准备好显示时，将调用 。此时，您可以显示 Offerwall，或设置某种标志，以便在需要时知道其已准备好显示。
OnRequestSuccessOnContentReady- 要显示 Offerwall 广告位，请检查内容是否已准备就绪，然后调用 ：
showContent
if (placement.IsContentReady()) { placement.ShowContent();}
此调用将替换您现有的 ironSource 调用：
IronSource.Agent.showOfferwall();
-
用户关闭 Offerwall 后，您必须再次请求内容。您不能多次显示广告位。建议您在回调中请求广告位，以便下次用户请求时准备好再次显示。
OnContentDismiss -
现在可以移除所有剩余的 ironSource Offerwall 代码。
隐私
如果您使用 Unity LevelPlay，则可以使用 LevelPlay API 与 Tapjoy 共享以下隐私标志：
- GDPR 同意。
- 根据美国各州隐私法律，选择不出售或共享个人信息。
- 将特定终端用户标记为儿童。请注意，如果您的应用主要面向 COPPA 规定的儿童用户，必须将所有终端用户标记为儿童。
此外，如果您的应用加入了 Google Play 的 Designed for Families（亲子同乐）计划，或出现在 Google Play 的“Family（家庭）”类别中，请将应用的所有用户标记为儿童，并使用 Offerwall SDK 的此 API，这样我们就不会收集用户的 GAID。
如果您不使用 Unity LevelPlay，或者希望单独配置 Offerwall SDK，请按照这些准则与 Tapjoy 共享相关的隐私标志。