积分墙迁移指南

  1. 首先,您需要集成ironSource Tapjoy adapter. 您可以如下所示将其添加到您的podfile:
pod 'IronSourceTapjoyAdapter','4.1.23.1'

您可以在这里获取最新版本的adapter.

  1. 在Adatper中包括Tapjoy SDK,因此您可以直接调用Tapjoy SDK函数。 下面是关于如何使用Tapjoy 积分墙的方法。 首先,我们需要将Tapjoy导入到您的类中:
#import <Tapjoy/TJPlacement.h>
  1. 接下来需要初始化积分墙,通常情况下通过Ironsource初始化。 一旦初始化完成,您将收到相应的回调。请不要在收到初始化成功的回调之前调用任何Tapjoy SDK功能。
[Tapjoy connect:@"TJ_SDK_KEY"];
    
- (void)tjcConnectSuccess:(NSNotification *)notifyObj 
{
    NSLog(@"Tapjoy connect succeeded");
}

- (void)tjcConnectFail:(NSNotification *)notifyObj 
{
    NSLog(@"Tapjoy connect failed");
}
  1. 接下来需要创建一个展示位置对象。这个展示位置是您配置在Tapjoy后台并添加了积分墙广告内容。在下面示例中,我们假设展示位置名称为”Offerwall“。 在您的实现中,您可以命名为任意名称,但是一定要保证您的代码中使用的名称和后台配置一致。
TJPlacement *placement = [TJPlacement placementWithName:@"Offerwall" delegate:self];
  1. 现在您可以请求积分墙广告内容了。通过这个调用,我们将会加载相应积分墙广告内容。通常情况下积分墙会很快加载完成。最好的方式是在积分墙展示之前提前加载。
[p requestContent];
  1. 下面是需要实现的积分墙相应的回调。
- (void)requestDidSucceed:(TJPlacement*)placement{}
- (void)requestDidFail:(TJPlacement*)placement error:(NSError*)error{}
- (void)contentIsReady:(TJPlacement*)placement{}
- (void)contentDidAppear:(TJPlacement*)placement{} 
- (void)contentDidDisappear:(TJPlacement*)placement{}

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

ironSource Callback Tapjoy Callback
offerwallDidShow contentDidAppear
offerwallDidClose contentDidDisappear
offerwallHasChangedAvailability contentIsReady

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

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

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

[IronSource showOfferwallWithViewController:UIViewController];

showContent方法接受一个视图控制器参数。 我们建议您传递 nil 并允许 Tapjoy 为您创建一个视图控制器。 在大多数情况下,这是最安全的选择。 如果你有一个复杂的视图层次结构并且出于某种原因想要自己管理显示,那么传递给这个方法的 ViewController 是最顶层的视图并且它不受其他视图的阻碍,并且保证直到Tapjoy内容被关闭其他视图不被放置在此视图之上。

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

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

[IronSource setOfferwallDelegate:yourOfferwallDelegate];

还有任何您没有转换为等效Tapjoy的回调都可以被删除。 如果您在初始化 ironSource SDK时指定了“@[IS_OFFERWALL]”,您也可以删除此参数。

Privacy

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

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

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