업데이트 가이드

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

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

13.4.0

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

Tapjoy.OnConnectWarning += HandleConnectWarning;

void HandleConnectWarning(int code, string message)
{
    
}

13.2.0

Connect

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

void Start() {	
    // Connect Delegates	
    Tapjoy.OnConnectSuccess += HandleConnectSuccess;	
    Tapjoy.OnConnectFailed += HandleConnectFailed;
	// Deprecated since 13.2.0	
    Tapjoy.OnConnectFailure += HandleConnectFailure;
    }
void OnDisable(){	
    // Connect Delegates	
    Tapjoy.OnConnectSuccess -= HandleConnectSuccess;	
    Tapjoy.OnConnectFailed -= HandleConnectFailed;
	// Deprecated since 13.2.0	
    Tapjoy.OnConnectFailure -= HandleConnectFailure;
    }
public void HandleConnectFailed(int code, string message){

}
// Deprecated since 13.2.0
public void HandleConnectFailure(){
} 

최대 사용자 레벨

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

Tapjoy.SetMaxLevel(10); 

사용자 분류

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

Tapjoy.SetUserSegment(TJSegment.VIP);
Tapjoy.SetUserSegment(TJSegment.Payer);
Tapjoy.SetUserSegment(TJSegment.NonPayer);
Tapjoy.SetUserSegment(TJSegment.Unknown); 

유입 경로

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

TJPlacement placement = TJPlacement.CreatePlacement("placementName");
placement.SetEntryPoint(TJEntryPoint.COMPLETE); 

// Available values
TJEntryPoint.UNKNOWN
TJEntryPoint.OTHER
TJEntryPoint.MAIN_MENU
TJEntryPoint.HUD
TJEntryPoint.EXIT
TJEntryPoint.FAIL
TJEntryPoint.COMPLETE
TJEntryPoint.INBOX
TJEntryPoint.INIT
TJEntryPoint.STORE 

가상화폐

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

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

TJPlacement placement = TJPlacement.CreatePlacement("placementName");
placement.SetCurrencyBalance("[CURRENCY_ID]", 100);

// Callbacks

void OnEnable() 
{	
    TJPlacement.OnSetCurrencyBalanceSuccess += HandleSetCurrencyBalanceSuccess;	
    TJPlacement.OnSetCurrencyBalanceFailure += HandleSetCurrencyBalanceFailure;	
}

void OnDisable() 
{	
    TJPlacement.OnSetCurrencyBalanceSuccess -= HandleSetCurrencyBalanceSuccess;	
    TJPlacement.OnSetCurrencyBalanceFailure -= HandleSetCurrencyBalanceFailure;
}

public void HandleSetCurrencyBalanceSuccess(TJPlacement placement) 
{

}

public void HandleSetCurrencyBalanceFailure(TJPlacement placement, int code, string error)
{

}

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

TJPlacement placement = TJPlacement.CreatePlacement("placementName");
placement.SetRequiredAmount("[CURRENCY_ID]", 200); 

// Callbacks

void OnEnable() 
{	
    TJPlacement.OnSetCurrencyAmountRequiredSuccess += HandleSetRequiredAmountSuccess;	
    TJPlacement.OnSetCurrencyAmountRequiredFailure += HandleSetRequiredAmountFailure;}

void OnDisable() 
{	
    TJPlacement.OnSetCurrencyAmountRequiredSuccess -= HandleSetRequiredAmountSuccess;	
    TJPlacement.OnSetCurrencyAmountRequiredFailure -= HandleSetRequiredAmountFailure;
}

public void HandleSetCurrencyBalanceSuccess(TJPlacement placement)
{

}

public void HandleSetCurrencyBalanceFailure(TJPlacement placement, int code, string error)
{

}

public void HandleSetRequiredAmountSuccess(TJPlacement placement)
{

}
public void HandleSetRequiredAmountFailure(TJPlacement placement, int code, string error)
{

} 

12.8.1

업데이트하기 전에Assets> Plugins> Android에서 Tapjoy 및 Google Play Service 파일을 모두 삭제하십시오. Tapjoy SDK는 이제 외부 의존성 관리자(EDM)에 의해 Maven을 통해 관리됩니다. EDM은 Tapjoy Unity 플러그인의 일부로 포함되며 Android를 지원하는데 필요합니다.

Custom Gradle Templates

사용자 지정 gradle 템플릿을 사용하는 경우 Jetifier를 활성화해야합니다. 사용중인 Unity Editor 버전에 항목이 옵션인 경우 사용자 지정 gradle 속성 파일도 사용해야합니다.

12.8.0

업데이트 전에 Tapjoy.framework 항목과 Assets > iOS 아래 Resources 폴더를 삭제해 주세요.

Unity iOS 내보내기 프로젝트의 경우 External Dependency Manager(EDM)와 CocoaPods에 의해서 Tapjoy SDK가 임포트 되도록 변경되었습니다. EDM 탭조이 유니티 플러그인의 일부로 포함되어 있으며 iOS 지원을 위해서 필요합니다. Cocoapods version is 1.9.0 이상이어야 하며, Xcode version은 11.0 이상이어야 합니다.