업데이트 가이드

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

14.3.0

Tapjoy.setDebugEnabled API를 사용중이라면 해당 API를Tapjoy.setLoggingLevel(TJLogLevel.Debug)로 업데이트합니다.
로그레벨은 Error, Warning, Info 그리고 Debug 입니다.
TapjoyConnectFlag.ENABLE_LOGGINGFlag 를 사용중이라면 해당 Flag를 TapjoyConnectFlag.TJC_OPTION_LOGGING_LEVEL 로 업데이트합니다.

14.2.0

TJPlacementListener onClick 메소드가 더이상 지원하지 않으므로 이를 제거해 주십시오. 해당 메소드는 다음 주요 업데이트 버전에서 더이상 사용되지 않을 예정입니다.
getSupportUrl 메소드가 더이상 지원하지 않으므로 이를 제거해 주십시오. 해당 메소드는 다음 주요 업데이트 버전에서 더이상 사용되지 않을 예정입니다.

메뉴얼 연동

수동으로 연동시 아래의 두 액티비티를 AndroidManifest.xml 에 추가합니다.

<activity
    android:name="com.tapjoy.TJAdUnitActivity"
    android:enableOnBackInvokedCallback="false"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:theme="@style/TranslucentTheme"
    android:hardwareAccelerated="true"
    tools:ignore="UnusedAttribute" />
<activity
    android:name="com.tapjoy.TJWebViewActivity"
    android:enableOnBackInvokedCallback="false"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:theme="@style/TranslucentTheme"
    android:hardwareAccelerated="true"
    tools:ignore="UnusedAttribute" />

13.4.0

connectWarning 콜백이 추가되었습니다. 해당 콜백은 Tapjoy SDK 초기화 시 경고성 이슈가 있을 경우 호출되며 connectSucess 역시 호출됩니다. 현재 해당 기능은 connectFlag상에 설정된 UserID 에 이슈가 있을 경우 호출됩니다.

Tapjoy.connect(getContext().getApplicationContext(), "SDK_KEY_GOES_HERE", connectFlags, new TJConnectListener() {
    @Override
    public void onConnectSuccess() {
        
    }
    @Override
    public void onConnectWarning(int code, String message) {
        
    }
    @Override
    public void onConnectFailure(int code, String message) {
        
    }    
});

13.2.0

Connect

connectFailure 콜백시 에러코드와 에러 메시지가 추가되었습니다. 기존 콜백은 지원이 중단되었으나 여전히 동작합니다.

Tapjoy.connect(getContext().getApplicationContext(), "SDK_KEY_GOES_HERE", connectFlags, new TJConnectListener() {
    @Override
    public void onConnectSuccess() {
        super.onConnectSuccess();
    }    
    @Override
    public void onConnectFailure(int code, String message) {
        super.onConnectFailure(code, message);
    }    
    @Override
    public void onConnectFailure() { //Deprecated
        super.onConnectFailure();
    }
});

최대 사용자 레벨

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

Tapjoy.setMaxLevel(10);

사용자 분류

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

Tapjoy.setUserSegment(TJSegment.VIP);
Tapjoy.setUserSegment(TJSegment.PAYER);
Tapjoy.setUserSegment(TJSegment.NON_PAYER);
Tapjoy.setUserSegment(TJSegment.UNKNOWN);

유입 경로

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

TJPlacement placement = Tapjoy.getPlacement("myPlacement", null);
placement.setEntryPoint(TJEntryPoint.ENTRY_POINT_MAIN_MENU);
placement.requestContent(); 

// Available values
TJEntryPoint.ENTRY_POINT_UNKNOWN
TJEntryPoint.ENTRY_POINT_OTHER
TJEntryPoint.ENTRY_POINT_MAIN_MENU
TJEntryPoint.ENTRY_POINT_HUD
TJEntryPoint.ENTRY_POINT_EXIT
TJEntryPoint.ENTRY_POINT_FAIL
TJEntryPoint.ENTRY_POINT_COMPLETE
TJEntryPoint.ENTRY_POINT_INBOX
TJEntryPoint.ENTRY_POINT_INIT
TJEntryPoint.ENTRY_POINT_STORE

가상화폐

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

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

TJPlacement placement = Tapjoy.getPlacement("placement", this);
placement.setCurrencyBalance("1234", 100, new TJSetCurrencyBalanceListener() {
    @Override
    public void onSetCurrencyBalanceSuccess() {
        
    }

    @Override
    public void onSetCurrencyBalanceFailure(int code, String error) {

    }
});

또한 위에서 설정한 각 사용자의 가상화폐 잔고에 따라 플레이스먼트 노출 여부를 설정하실 수 있습니다.

TJPlacement placement = Tapjoy.getPlacement("placement", this);
placement.setCurrencyAmountRequired("1234", 100, new TJSetCurrencyAmountRequiredListener() {
    @Override
    public void onSetCurrencyAmountRequiredSuccess() {
        
    }

    @Override
    public void onSetCurrencyAmountRequiredFailure(int code, String error) {

    }
});

12.8.0

탭조이는 이제 자체 maven 리파지토리를 사용합니다. Bintray를 이용한 배포는 이후 잠시동안 운영되다가 중단될 예정이기 때문에 최대한 빠르게 리파지토리 설정을 업데이트 해야합니다.

모든 이전 버전과 향후 버전의 SDK는 자체 리파지토리를 통해서 제공되고, 12.8.0 이전 버전의 릴리즈에 대해서만 Bintray에서 일시적으로 제공됩니다.

다음과 같은 설정을 통해 리파지토리 설정을 변경할 수 있습니다.

    repositories {
      maven {
        name "Tapjoy's maven repo"
        url "https://sdk.tapjoy.com/"
      }
    }

    dependencies {
      api 'com.tapjoy:tapjoy-android-sdk:12.8.0@aar'
    }

업데이트 가이드
14.3.0
14.2.0
13.4.0
13.2.0
12.8.0