Offerwall 迁移指南
按照分步迁移说明从应用中实现的现有 ironSource Offerwall 过渡到 Tapjoy Offerwall。
阅读时间3 分钟最后更新于 3 个月前
- 首先需要集成 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];
- 我们提供了一系列可供您实现的回调。
以上有一些回调可以替换您可能已经实现的 ironSource 回调。下表显示了相应的回调，便于您将自定义逻辑移到相应的 Tapjoy 回调中：- (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 回调 |
|---|---|
| offerwallDidShow | contentDidAppear |
| offerwallDidClose | contentDidDisappear |
| offerwallHasChangedAvailability | contentIsReady |
requestDidSuceedcontentIsReady- 要显示 Offerwall 广告位，请检查内容是否已准备就绪，然后调用 showContent：
此调用将替换您现有的 ironSource 调用：if (placement.isContentReady) { [placement showContentWithViewController:nil];}
[IronSource showOfferwallWithViewController:UIViewController];
showContent-
用户关闭 Offerwall 后，您必须再次请求内容。您不能多次显示广告位。建议您在 回调中请求广告位，以便下次用户请求时准备好再次显示。
contentDidDisappear - 现在可以移除所有剩余的 ironSource Offerwall 代码。例如：
还可以移除所有未转换为等效 Tapjoy 版本的回调。如果在初始化 LevelPlay SDK 时指定[IronSource setOfferwallDelegate:yourOfferwallDelegate];
@[IS_OFFERWALL]隐私
如果您使用 Unity LevelPlay，则可以使用 LevelPlay API 与 Tapjoy 共享以下隐私标志：- GDPR 同意。
- 根据美国各州隐私法律，选择不出售或共享个人信息。
- 将特定终端用户标记为儿童。请注意，如果您的应用主要面向 COPPA 规定的儿童用户，必须将所有终端用户标记为儿童。