升级指南

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

14.2.0

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

14.0.0

• 请用新方法“Tapjoy.TrackPurchase(string currencyCode, double productPrice)”替换已弃用的“Tapjoy.TrackPurchase”方法。

13.4.0

Tapjoy SDK增加了connectWarning回调。当连接期间出现非阻塞问题时，此回调将触发，connectSuccess也会在之后触发。 目前，此功能仅检测在ConnectFlags中设置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.0public void HandleConnectFailure(){
} 

Max User Level

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

Tapjoy.SetMaxLevel(10); 

User Segment

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

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

Entry Point

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

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 

Currency

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

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

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 Services相关文件。

目前Tapjoy SDK由External Dependency Manager (EDM)通过Maven管理。EDM包含在Tapjoy Unity插件中，并且支持Android。

定制Gradle Templates

如果您正在使用定制gradle template，您需要enable Jetifier。

如果在您使用的Unity Editor版本中需要使用定制gradle template，则必须使用定制gradle属性文件。

12.8.0

在升级之前，请先将Assets > iOS 下面的Tapjoy.framework和Resources文件夹删除。

Tapjoy SDK现在由External Dependency Manager（EDM）通过Cocoapods管理。 EDM包含在Tapjoy Unity插件中，并且是支持iOS所必需的。 请确保您的Cocoapods版本为1.9.0或更高，而Xcode版本为11.0或更高。