文档

支持

Offerwall

开始使用 Monetization（变现）

开始使用 User Acquisition

Unity SDK 集成

Offerwall

Offerwall 迁移指南

按照 Offerwall 迁移指南从 ironSource 过渡到 Tapjoy。
阅读时间3 分钟最后更新于 5 天前
  1. 集成 Unity Offerwall 适配器。您可以使用 ironSource 聚合管理器窗口将此适配器添加到项目中。
  2. 添加 Offerwall Unity 插件。此插件可用于从 C# 代码访问 Offerwall SDK 方法。
Tapjoy Unity 插件使用 External Dependency Manager 安装 Offerwall iOS SDK 的副本，并包含了 Tapjoy Android SDK 的副本。由于我们已在步骤 1 中使用适配器添加了 SDK，因此不需要包含第二个副本（我们仅需桥接代码）。修改 /Assets/Tapjoy/Editor 中的 
TJPluginDependencies
文件，移除 iOS 引用，仅包含 Android Unity Bridge。将该文件的内容替换为以下内容： 
<dependencies>  <androidPackages>    <repositories>      <repository>https://sdk.tapjoy.com</repository>    </repositories>    <androidPackage spec="com.tapjoy:tapjoy-android-unitybridge:12.11.1@aar"/>  </androidPackages></dependencies>
  1. 直接调用 Offerwall SDK 函数。我们需要这样做才能显示 Tapjoy Offerwall。首先，需要将 Tapjoy 导入您的类：
import TapjoyUnity
  1. 初始化 Offerwall SDK。初始化成功（或失败）时，您将收到回调，在收到成功回调之前，无需进行任何 Offerwall SDK 调用。
#if UNITY_ANDROID  Tapjoy.Connect("your_android_sdk_key");#elif UNITY_IOS  Tapjoy.Connect("your_ios_sdk_key");#endif
  1. 创建一个广告位对象和一个监听器（了解步骤 5 中的监听器的更多信息）。广告位在 Offerwall 后台上进行配置，其中包含 Offerwall 内容卡片。在以下示例中，假设您已将广告位命名为 Offerwall。实际上，您可以将其命名为任何名称，但此处在代码中使用的名称必须与后台上的名称匹配。
TJPlacement placement = TJPlacement.CreatePlacement("Offerwall");
  1. 请求您的广告位。通过以下调用来加载广告位，以便在需要显示广告位时广告位准备就绪。Offerwall 广告位应该会快速加载，但最好在显示 Offerwall 之前进行此调用。
placement.requestContent();
  1. 我们提供了一系列可供您实现的回调。
TJPlacement.OnRequestSuccess += HandlePlacementRequestSuccess;TJPlacement.OnRequestFailure += HandlePlacementRequestFailure;TJPlacement.OnContentReady += HandlePlacementContentReady;TJPlacement.OnContentShow += HandlePlacementContentShow;TJPlacement.OnContentDismiss += HandlePlacementContentDismiss;
以上有一些回调可以替换您可能已经实现的 ironSource 回调。下表显示了相应的回调，便于您将自定义逻辑移到相应的 Tapjoy 回调中：

ironSource 回调

Tapjoy 回调

onOfferwallClosedEventOnContentDismiss
onOfferwallOpenedEventOnContentShow
onOfferwallAvailableEventOnContentReady
从 Tapjoy 服务器返回内容请求时，将调用 
OnRequestSuccess
。当内容 (Offerwall) 准备好显示时，将调用 
OnContentReady
。此时，您可以显示 Offerwall，或设置某种标志，以便在需要时知道其已准备好显示。
  1. 要显示 Offerwall 广告位，请检查内容是否已准备就绪，然后调用 
    showContent
    ：
if (placement.IsContentReady()) {  placement.ShowContent();}
此调用将替换您现有的 ironSource 调用： 
IronSource.Agent.showOfferwall();
  1. 用户关闭 Offerwall 后，您必须再次请求内容。您不能多次显示广告位。建议您在 
    OnContentDismiss
    回调中请求广告位，以便下次用户请求时准备好再次显示。
  2. 现在可以移除所有剩余的 ironSource Offerwall 代码。

隐私

如果您使用 Unity LevelPlay，则可以使用 LevelPlay API 与 Tapjoy 共享以下隐私标志：
  1. GDPR 同意。
  2. 根据美国各州隐私法律，选择不出售或共享个人信息。
  3. 将特定终端用户标记为儿童。请注意，如果您的应用主要面向 COPPA 规定的儿童用户，必须将所有终端用户标记为儿童。
此外，如果您的应用加入了 Google Play 的 Designed for Families（亲子同乐）计划，或出现在 Google Play 的“Family（家庭）”类别中，请将应用的所有用户标记为儿童，并使用 Offerwall SDK 的此 API，这样我们就不会收集用户的 GAID。 如果您不使用 Unity LevelPlay，或者希望单独配置 Offerwall SDK，请按照这些准则与 Tapjoy 共享相关的隐私标志。