업데이트 가이드

이 가이드는 버전에 따른 탭조이 SDK 업데이트 과정을 설명합니다. 업데이트 시 발생할 수 있는 충돌문제를 피하기 위해 아래 설명하는 방법을 사용하길 권장합니다.

아래는 특정 버전별 SDK 업데이트 절차를 설명합니다.

14.2.0

  • TJPlacement didClick 메소드는 더이상 지원하지 않으므로 제거해 주십시오. 다음 주요 업데이트 버전에서 더이상 동작하지 않을 예정입니다.
  • getSupportURL 메소드는 더이상 지원하지 않으므로 제거해 주십시오. 다음 주요 업데이트 버전에서 더이상 동작하지 않을 예정입니다.

13.4.0

connectWarning 콜백이 추가되었습니다. 해당 콜백은 Tapjoy SDK 초기화 시 경고성 이슈가 있을 경우 호출되며 connectSucess 역시 호출됩니다. 현재 해당 기능은 connectFlag상에 설정된 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] : @""; 

최대 사용자 레벨

이제 여러분의 게임의 최대 레벨 설정이 가능합니다. 해당 API 는 connect API 호출 전후로 설정하실 수 있습니다.

Objective-C
Swift
[Tapjoy setMaxLevel:10]; 

사용자 분류

이제 여러분의 앱을 사용하는 사용자의 타입을 설정하실 수 있습니다. 해당 API 는 connect API 호출 전후 혹은 앱이 실행되는 동안에 설정하실 수 있습니다.

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

유입 경로

플레이스먼트의 콘텐츠를 요청전 해당 플레이스먼트에 대한 유입 경로를 설정할 수 있습니다. 이를 통해 앱 내 어느 화면에서 해당 플레이스먼트가 표시되는지 설정할 수 있습니다. 유입경로는 사전에 설정된 프리셋을 통해 설정하실 수 있습니다.

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 

가상화폐

  • 가상화폐 가져오기 / 사용하기 / 획득하기 API는 더이상 음수값을 사용할 수 없습니다.
  • 만약 자체 관리 가상화폐를 사용하는 중에 Tapjoy 관리 가상화폐 API 를 호출할 경우 에러를 리턴합니다.

플레이스먼트의 콘텐츠를 요청하기 전 사용자의 가상화폐 잔고를 설정할 수 있습니다. 잔고 설정은 반드시 requestContent API 호출 전 사용해야 합니다.

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

탭조이 SDK 12.8.0 버전부터 XCFramework을 사용하고 별도의 번들 파일을 필요로하지 않습니다. Tapjoy.xcframework을 추가하기 전에 Tapjoy.frameworkTapjoyResources.bundle 항목을 삭제해 주세요.