업데이트 가이드

탭조이 오퍼월 iOS SDK 버전을 올바르게 업데이트하여 문제 발생을 방지하고 호환성을 유지합니다.

읽는 시간 4분

최근 업데이트: 8시간 전

이 가이드에서는 하나의 Offerwall SDK 버전에서 다른 버전으로 업데이트할 때 필요한 단계를 설명합니다. 모든 단계를 수행하여 문제나 충돌이 발생하는 것을 방지합니다.

아래에서는 특정 버전의 Offerwall SDK로 업데이트할 때 필요한 추가 단계를 설명합니다.

14.3.0

```
[Tapjoy setDebugEnabled:YES]
```
의 모든 사용을
```
[Tapjoy setLoggingLevel:TJLoggerLevelDebug]
```
로 대체합니다. 이전 방법은 지원이 중단되었습니다.
로그 레벨은 다음과 같습니다. 오류, 경고, 정보, 디버그
```
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

Connect

오류 코드 및 메시지 파라미터를

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)

엔트리 포인트

_request connect_를 호출하기 전에 엔트리 포인트를 설정할 수 있습니다. 이는 앱에서 플레이스먼트가 표시되는 위치를 설명합니다. 여러 프리셋 값 중 하나를 선택할 수 있습니다.


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

산업 분야