升级指南

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

下面,我们解释更新到Tapjoy SDK的特定版本时所需的步骤。

14.2.0

  • 请移除已弃用的TJPlacement didClick回调。它将在下一个主要版本中被移除,不再执行任何操作。
  • 请移除已弃用的getSupportURL方法。它将在下一个主要版本中被移除,不再执行任何操作。

14.0.0

  • 请将已弃用的方法 [Tapjoy trackPurchase] 替换为 trackPurchaseWithCurrencyCode:(NSString *)currencyCode price:(double)price

13.4.0

Tapjoy SDK增加了connectWarning回调。当连接期间出现非阻塞问题时,此回调将触发,connectSuccess也会在之后触发。 目前,此功能仅检测在ConnectFlags中设置UserId的问题。

Objective-C
Swift
[[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];
}


13.2.0

Connect

我们在connectFailure回调中添加错误代码和相关信息。原有回调方法已经被弃用,但是仍然起作用。

Objective-C
Swift
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] : @""; 

Max User Level

您可以设置应用中的级别数目。在connect之前或之后都可以调用。

Objective-C
Swift
[Tapjoy setMaxLevel:10]; 

User Segment

您可以在应用中设置用户的类型。在connect之前或之后都可以调用,在session中也可以调用。

Objective-C
Swift
[Tapjoy setUserSegment:TJSegmentVIP];
[Tapjoy setUserSegment:TJSegmentPayer];
[Tapjoy setUserSegment:TJSegmentNonPayer];
[Tapjoy setUserSegment:TJSegmentUnknown]; 

Entry Point

在调用_request connect_之前,您可以设置进入点。这个进入点表示广告展示位置在您应用中的位置。您可以从下面的预设值中选择。

Objective-C
Swift
TJPlacement *placement = [TJPlacement placementWithName:@"myPlacement" delegate:nil];
[placement setEntryPoint:TJEntryPointMainMenu];
[placement requestContent]; 

// Values available
TJEntryPointUnknown //Not set, but removes any value that was already set
TJEntryPointOther
TJEntryPointMainMenu
TJEntryPointHud
TJEntryPointExit
TJEntryPointFail
TJEntryPointComplete
TJEntryPointInbox 
TJEntryPointInitialisation
TJEntryPointStore 

Currency

  • Get/spend/earn不再支持负数。
  • 如果您使用的自管理虚拟货币,当您调用Tapjoy管理虚拟货币API时返回错误。

您可以在创建展示位置之前设置用户账号余额。必须要在_requestContent_之前设置。

Objective-C
Swift
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
    }
}]; 

您也可以设置用户在每个展示位置中达到目标需要获得的虚拟货币数量。

Objective-C
Swift
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
    }
} 

12.8.0

当前Tapjoy SDK使用XCFramework并且不再要求单独的resources bundle。在添加 Tapjoy.xcframework之前,请删除Tapjoy.frameworkTapjoyResources.bundle