积分墙迁移指南

  1. 首先,您需要集成ironSource Tapjoy adapter. 您可以通过ironSource mediation manager将其添加到您的工程中。

  2. 接下来您需要添加Tapjoy Unity Plugin。这将使您可以通过C#代码使用Tapjoy SDK方法。请在这里下载并导入您的Unity工程中。

Tapjoy Unity Plugin通过External Dependency Manager来安装Tapjoy iOS SDK和Tapjoy Android SDK。我们已经在第一步通过adapter安装了Tapjoy SDK,所以我们需要做些修改来防止再次添加SDK(我们只需要添加bridge代码)。 修改在 /Assets/Tapjoy/EditorTJPluginDependencies 来删除对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. 现在我们可以通过bridge调用Tapjoy SDK功能了。我们可以通过这些展示Tapjoy 积分墙。首先在您的类中导入Tapjoy:
import TapjoyUnity
  1. 接下来需要初始化积分墙。一旦初始化完成,您将收到相应的回调。请不要在收到初始化成功的回调之前调用任何Tapjoy SDK功能。
#if UNITY_ANDROID
  Tapjoy.Connect("your_android_sdk_key");
#elif UNITY_IOS
  Tapjoy.Connect("your_ios_sdk_key");
#endif
  1. 接下来需要创建一个展示位置对象和监听器。这个展示位置是您配置在Tapjoy后台并添加了积分墙广告内容。在下面示例中,我们假设展示位置名称为”Offerwall“。 在您的实现中,您可以命名为任意名称,但是一定要保证您的代码中使用的名称和后台配置一致。
TJPlacement placement = TJPlacement.CreatePlacement("Offerwall");
  1. 现在您可以请求积分墙广告内容了。通过这个调用,我们将会加载相应积分墙广告内容。通常情况下积分墙会很快加载完成。最好的方式是在积分墙展示之前提前加载。
placement.requestContent();
  1. 下面是需要实现的积分墙相应的回调。
TJPlacement.OnRequestSuccess += HandlePlacementRequestSuccess;
TJPlacement.OnRequestFailure += HandlePlacementRequestFailure;
TJPlacement.OnContentReady += HandlePlacementContentReady;
TJPlacement.OnContentShow += HandlePlacementContentShow;
TJPlacement.OnContentDismiss += HandlePlacementContentDismiss;

其中一些可以替换您可能已经实现的ironSource回调。 您可以在下表中看到相应的回调,这样您就可以轻松地将任何自定义逻辑移动到适当的Tapjoy回调中:

ironSource Callback Tapjoy Callback
onOfferwallClosedEvent OnContentDismiss
onOfferwallOpenedEvent OnContentShow
onOfferwallAvailableEvent OnContentReady

OnRequestSuccess 会在将会内容请求从Tapjoy的服务器返回时调用。 OnContentReady 将在内容(积分墙)准备好显示时调用。此时您可以显示积分墙,或设置一些标志,以便您知道积分墙已准备好在您需要时显示。

  1. 要显示您的积分墙,需要先检查内容是否准备就绪,然后调用showContent:
if (placement.IsContentReady()) {
  placement.ShowContent();
}

这个将会替换您现有的ironSource调用:

IronSource.Agent.showOfferwall();
  1. 一旦用户关闭积分墙,您必须再次请求该内容。 一次请求不能多次显示。 我们建议您在 OnContentDismiss 回调中再次请求,以便下次用户请求时再次显示。

  2. 您现在可以删除任何剩余的 ironSource 积分墙代码。

Privacy

如果您使用ironSource LevelPlay,您可以使用LevelPlay API与Tapjoy共享以下隐私标志:

  1. GDPR consent.
  2. 根据美国各州隐私法选择不出售或分享个人信息.
  3. 将特定最终用户标记为儿童. 请注意,如果您的应用根据COPPA主要面向儿童,您必须将所有最终用户标记为儿童。

此外,如果您的应用参与了 Google Play 的 Designed for Families 计划,或出现在 Google Play 的“家庭”部分,请将所有应用的用户标记为儿童并使用此API这样我们就不会收集用户的 GAID。

如果您没有使用 ironSource LevelPlay 或者如果您想单独配置 Tapjoy 的 SDK,请按照这些指南 与 Tapjoy 分享相关的隐私标志。