更新指南

正确更新 Tapjoy Offerwall iOS SDK 版本以避免问题并维持兼容性。

阅读时间5 分钟

最后更新于 2 天前

本指南介绍从一个 Offerwall SDK 版本更新到另一个版本时所需的步骤，建议您执行所有步骤以防止发生任何问题或冲突。

下面将介绍更新到特定的 Offerwall SDK 版本时所需的额外步骤。

14.3.0

将

[Tapjoy setDebugEnabled:YES]

的所有用例替换为

[Tapjoy setLoggingLevel:TJLoggerLevelDebug]

。前者已弃用。

日志级别为：Error（错误）、Warning（警告）、Info（信息）和 Debug（调试）。

将

TJC_OPTION_ENABLE_LOGGING

的所有用例替换为

TJC_OPTION_LOGGING_LEVEL

。前者已弃用。

14.2.0

移除已弃用的 TJPlacement didClick 回调的所有用例。此方法将在下一个主要版本中移除，目前已不再发挥任何作用。
移除已弃用的 getSupportURL 方法的所有用例。此方法将在下一个主要版本中移除，目前已不再发挥任何作用。

14.0.0

将已弃用的方法

[Tapjoy trackPurchase]

的用例替换为

trackPurchaseWithCurrencyCode:(NSString *)currencyCode price:(double)price

。

13.4.0

我们新增了一个

connectWarning

回调。当连接过程中出现非阻塞问题时将触发此回调，随后仍会触发

connectSuccess

。目前，此功能仅用于检测在 ConnectFlags 中发送的 UserId 的相关问题。


[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(tjcConnectWarning:) name:TJC_CONNECT_WARNING object:nil];- (void)tjcConnectWarning:(NSNotification *)notifyObj {    NSError *error = notifyObj.userInfo[TJC_CONNECT_USER_INFO_ERROR];    NSError *underlyingError = error.userInfo[NSUnderlyingErrorKey];}


NotificationCenter.default.addObserver(self, selector: #selector(AppDelegate.tjcConnectWarning(notif:)), name: NSNotification.Name(rawValue: TJC_CONNECT_WARNING), object: nil)@objc func tjcConnectWarning(notif: NSNotification) {    var message = "Tapjoy Connect Warning"    if let error = notif.userInfo?[TJC_CONNECT_USER_INFO_ERROR] as? NSError {        message.append("\nError: \(error.code) - \(error.localizedDescription)")        if let underlyingError = error.userInfo[NSUnderlyingErrorKey] as? NSError {            message.append("\nUnderlying Error: \(underlyingError.code) - \(underlyingError.localizedDescription)")        }    }}

13.2.0

连接

我们向

connectFailure

回调添加了错误代码和消息参数。以前的回调现已弃用，但仍然有效。


NSError *error = notifyObj.userInfo[TJC_CONNECT_USER_INFO_ERROR];NSInteger code = error.code;NSString *message = error.localizedDescription;NSString *underlyingErrorMessage = underlyingError != nil ? [NSString stringWithFormat:@" - %li %@", underlyingError.code, underlyingError.localizedDescription] : @"";


if let error = notif.userInfo?[TJC_CONNECT_USER_INFO_ERROR] as? NSError {    let code = error.code    let message = error.localizedDescription    if let underlyingError = error.userInfo[NSUnderlyingErrorKey] as? NSError {        let underlyingErrorMessage = "\nUnderlying Error: \(underlyingError.code) - \(underlyingError.localizedDescription)"    }}

最大用户等级

现在可以设置游戏中的关卡数。此设置可以在连接之前或之后进行。


[Tapjoy setMaxLevel:10];


Tapjoy.setMaxLevel(10)

用户细分段

现在可以设置当前使用应用的用户类型。此设置可以在连接之前或之后或在会话期间进行。


[Tapjoy setUserSegment:TJSegmentVIP];[Tapjoy setUserSegment:TJSegmentPayer];[Tapjoy setUserSegment:TJSegmentNonPayer];[Tapjoy setUserSegment:TJSegmentUnknown];


Tapjoy.setUserSegment(TJSegment.VIP)Tapjoy.setUserSegment(TJSegment.payer)Tapjoy.setUserSegment(TJSegment.nonPayer)Tapjoy.setUserSegment(TJSegment.unknown)

入口点

在调用_请求连接_之前，可以设置入口点。该设置用于指定广告位将在应用中的显示位置。您可以从多个预设值中选择一个值。


TJPlacement *placement = [TJPlacement placementWithName:@"myPlacement" delegate:nil];[placement setEntryPoint:TJEntryPointMainMenu];[placement requestContent]; // Values availableTJEntryPointUnknown //Not set, but removes any value that was already setTJEntryPointOtherTJEntryPointMainMenuTJEntryPointHudTJEntryPointExitTJEntryPointFailTJEntryPointCompleteTJEntryPointInbox TJEntryPointInitialisationTJEntryPointStore


let placement = TJPlacement(name: "myPlacement", delegate: nil)placement?.entryPoint = TJEntryPoint.mainMenuplacement?.requestContent() // Values availableTJEntryPoint.unknownTJEntryPoint.otherTJEntryPoint.mainMenuTJEntryPoint.hudTJEntryPoint.exitTJEntryPoint.failTJEntryPoint.completeTJEntryPoint.inboxTJEntryPoint.initialisationTJEntryPoint.store

货币

get/spend/earn 方法将不再接受负值。
如果自管货币调用托管货币 API，则会返回错误。

现在可以在创建广告位之前设置用户余额。此设置必须在 requestContent 之前进行。


TJPlacement* placement = [TJPlacement placementWithName:@"placementName" delegate:nil];[placement setBalance:100 forCurrencyId:@"1234" withCompletion:^(NSError * _Nullable error) {    if (error != nil) {        //Failure        NSString *message = error.localizedDescription;    } else {        //Success    }}];


let placement = TJPlacement(name: "placementName", delegate: nil)placement?.setBalance(100, forCurrencyId:"1234", withCompletion: { error in    if let error = error {        //Failure        let message = error.localizedDescription    } else {        //Success    }})

还可以设置用户在每个广告位上实现目标所需的货币数量。


TJPlacement* placement = [TJPlacement placementWithName:@"placementName" delegate:nil];placement setRequiredAmount:100 forCurrencyId:@"1234" withCompletion:^(NSError * _Nullable error) {    if (error != nil) {        //Failure        NSString *message = error.localizedDescription;    } else {        //Success    }}


let placement = TJPlacement(name: "placementName", delegate: nil)placement?.setRequiredAmount(100, forCurrencyId:"1234", withCompletion: { error in    if let error = error {        //Failure        let message = error.localizedDescription    } else {        //Success    }})

12.8.0

Offerwall SDK 现使用 XCFramework，不再需要单独的资源包。添加

Tapjoy.xcframework

之前，请删除

Tapjoy.framework

和

TapjoyResources.bundle

。

文档

Development

User Acquisition

Monetization

工业

文档