Offerwall 迁移指南
按照分步迁移说明从应用中实现的现有 ironSource Offerwall 过渡到 Tapjoy Offerwall。
阅读时间3 分钟最后更新于 4 个月前
- 首先需要集成 ironSource Tapjoy 适配器。可按如下方式将其添加到 podfile:
pod 'IronSourceTapjoyAdapter','4.1.23.1'
您可以在此处找到最新版的适配器。
- 适配器附带 Offerwall SDK 副本,因此可以直接调用 Offerwall SDK 函数。我们需要这样做才能显示 Tapjoy Offerwall。首先,需要将 Tapjoy 导入您的类:
#import <Tapjoy/TJPlacement.h>
- 然后,需要初始化 Offerwall SDK。初始化成功(或失败)时,您将收到回调,在收到成功回调之前,无需进行任何 Offerwall SDK 调用。
[Tapjoy connect:@"TJ_SDK_KEY"]; - (void)tjcConnectSuccess:(NSNotification *)notifyObj { NSLog(@"Tapjoy connect succeeded");}- (void)tjcConnectFail:(NSNotification *)notifyObj { NSLog(@"Tapjoy connect failed");}
- 接下来创建一个广告位对象。广告位在 Tapjoy 后台上进行配置,其中包含 Offerwall 内容卡片。在以下示例中,假设您已将广告位命名为“Offerwall”。实际上,您可以将其命名为任何名称,但此处在代码中使用的名称必须与后台上的名称匹配。
TJPlacement *placement = [TJPlacement placementWithName:@"Offerwall" delegate:self];
- 您现在可以请求广告位了。通过以下调用来加载广告位,以便在需要显示广告位时广告位准备就绪。Offerwall 广告位应该会快速加载,但最好在显示 Offerwall 之前进行此调用。
[p requestContent];
- 我们提供了一系列可供您实现的回调。
- (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 回调 | Tapjoy 回调 |
|---|---|
| offerwallDidShow | contentDidAppear |
| offerwallDidClose | contentDidDisappear |
| offerwallHasChangedAvailability | contentIsReady |
从 Tapjoy 服务器返回内容请求时,将调用 。当内容 (Offerwall) 准备好显示时,将调用 。此时,您可以显示 Offerwall,或设置某种标志,以便在需要时知道其已准备好显示。
requestDidSuceedcontentIsReady- 要显示 Offerwall 广告位,请检查内容是否已准备就绪,然后调用 showContent:
if (placement.isContentReady) { [placement showContentWithViewController:nil];}
此调用将替换您现有的 ironSource 调用:
[IronSource showOfferwallWithViewController:UIViewController];
showContent-
用户关闭 Offerwall 后,您必须再次请求内容。您不能多次显示广告位。建议您在回调中请求广告位,以便下次用户请求时准备好再次显示。
contentDidDisappear -
现在可以移除所有剩余的 ironSource Offerwall 代码。例如:
[IronSource setOfferwallDelegate:yourOfferwallDelegate];
还可以移除所有未转换为等效 Tapjoy 版本的回调。如果在初始化 LevelPlay SDK 时指定 ,也可以移除此参数。
@[IS_OFFERWALL]隐私
如果您使用 Unity LevelPlay,则可以使用 LevelPlay API 与 Tapjoy 共享以下隐私标志:
- GDPR 同意。
- 根据美国各州隐私法律,选择不出售或共享个人信息。
- 将特定终端用户标记为儿童。请注意,如果您的应用主要面向 COPPA 规定的儿童用户,必须将所有终端用户标记为儿童。
如果您不使用 Unity LevelPlay,或者希望单独配置 Offerwall SDK,请按照这些准则与 Tapjoy 共享相关的隐私标志。