탭조이 관리형 재화

탭조이 오퍼월 관리형 재화를 사용하여 탭조이 서버에 사용자 재화 잔액을 저장하고 관리합니다.

읽는 시간 9분

최근 업데이트: 8시간 전

탭조이에서 관리하는 재화를 사용하여 사용자의 가상 재화 잔액을 탭조이 서버에 저장하고 관리할 수 있습니다. 탭조이의 퍼블리셔 SDK를 통합하는 모든 개발자가 이용할 수 있는 이 무료 서비스를 통해, 앱 내에서 재화를 백엔드에 저장할 필요가 없어집니다.

재화 잔액 가져오기

사용자의 현재 가상 재화 잔액을 확인하려면 각 플랫폼별로 안내된 메서드를 사용합니다. 잔액이 정확하게 유지되도록

getCurrencyBalance

를 자주 호출하는 것이 권장되는 베스트 프랙티스입니다. 잔액을 확인하는 일반적인 시점은 다음과 같은 상황입니다.

앱 실행
앱 재개
탭조이 뷰 종료
플레이스먼트 콘텐츠가 사라짐

최적의 결과를 위해 광고 콘텐츠가 종료된 후 약 3.5초 뒤에

getCurrencyBalance

를 호출합니다. 이렇게 하면 보상이 업데이트될 충분한 처리 시간이 확보됩니다. 즉시 잔액을 확인하면 새롭게 획득한 보상이 반영되지 않을 수 있습니다.

재화 잔액 검색

탭조이는 보상을 신속하게 전달하기 위해 최선을 다합니다. 하지만 네트워크 지연이 발생할 수 있으므로 즉시 보상이 보장되지는 않습니다. 사용자들에게 오퍼 보상이 반영되기까지 다소 시간이 걸릴 수 있음을 알려줍니다. 정확성을 유지하려면 정기적으로 잔액을 확인하고, 다음과 같은 주요 앱 이벤트가 발생할 때 확인하십시오.

앱 실행
앱 재개
레벨 사이
스토어 로딩 전

재화 잔액을 조회하려면 다음 플랫폼별 메서드를 참고하십시오.

iOS 디바이스에서 현재 가상 재화 잔액을 확인하려면 다음 메서드를 사용합니다.


// This method requests the tapjoy server for current virtual currency of the user.//Get currency[Tapjoy getCurrencyBalanceWithCompletion:^(NSDictionary *parameters, NSError *error) {  if (error) {    //Show error message    NSLog(@"getCurrencyBalance error: %@", [error localizedDescription]);  } else {    //Update currency value of your app    NSLog(@"getCurrencyBalance returned %@: %d", parameters[@"currencyName"], [parameters[@"amount"] intValue]);  }}];

완료 블록은

currencyName

에 재화 이름,

amount

에 사용자의 총 잔액을 반환합니다. 구현 세부 사항은 SDK 패키지의 샘플 애플리케이션을 참고하십시오.

Android 디바이스에서 현재 가상 재화 잔액을 확인하려면 다음 메서드를 사용합니다.


  Tapjoy.getCurrencyBalance(new TJGetCurrencyBalanceListener(){    @Override    public void onGetCurrencyBalanceResponse(String currencyName, int balance) {      Log.i(TAG, "getCurrencyBalance returned " + currencyName + ":" + balance);    }    @Override    public void onGetCurrencyBalanceResponseFailure(String error) {      Log.i("Tapjoy", "getCurrencyBalance error: " + error);    }  });

onGetCurrencyBalanceResponse

콜백에서 결과값을 받고

onGetCurrencyBalanceResponseFailure

에서 오류 정보를 받습니다. 앱 시작과 재개 시

getCurrencyBalance

를 호출하여 정확도를 유지합니다. spend와 award 콜백도 전체 잔액을 반환하며, 앱 업데이트에 활용할 수 있습니다.


// Get currencyTapjoy.GetCurrencyBalance();// on enable, add delegatesvoid OnEnable() {  Tapjoy.OnGetCurrencyBalanceResponse += HandleGetCurrencyBalanceResponse;  Tapjoy.OnGetCurrencyBalanceResponseFailure += HandleGetCurrencyBalanceResponseFailure;}// on disable, remove delegatesvoid OnDisable() {  Tapjoy.OnGetCurrencyBalanceResponse -= HandleGetCurrencyBalanceResponse;  Tapjoy.OnGetCurrencyBalanceResponseFailure -= HandleGetCurrencyBalanceResponseFailure;}public void HandleGetCurrencyBalanceResponse(string currencyName, int balance) {  Debug.Log("C#: HandleGetCurrencyBalanceResponse: currencyName: " + currencyName + ", balance: " + balance);}  public void HandleGetCurrencyBalanceResponseFailure(string error) {  Debug.Log("C#: HandleGetCurrencyBalanceResponseFailure: " + error);}

지정한

OnGetCurrencyBalanceResponse

핸들러에서 재화 잔액에 대한 알림을 받게 되며, 이 핸들러는

currencyName

및

balance

파라미터를 전달합니다.

OnGetCurrencyBalanceResponseFailure

핸들러에서 오류가 발생하면 알림을 받게 됩니다.


try {  let result = await Tapjoy.getCurrencyBalance();    let currencyName = result['currencyName'];    let amount = result['amount'];} catch (error: any) {    //Handle error}

React Native에서 파라미터를 받지 않는

getCurrencyBalance()

에 대해 프로미스를 사용합니다. 이 프러미스는

currencyName

와

amount

를 포함하는 딕셔너리로 해결되거나, 실패할 경우 오류가 발생합니다.


  // Get currency  TapjoyAIR.getCurrencyBalance();  // Setup handlers  TapjoyAIR.addEventListener(TJCurrencyEvent.GET_CURRENCY_BALANCE_SUCCESS, tapjoyCurrencyEventHandler);  TapjoyAIR.addEventListener(TJCurrencyEvent.GET_CURRENCY_BALANCE_FAILURE, tapjoyCurrencyEventHandler);  private function tapjoyCurrencyEvents(event:TJCurrencyEvent):void {    trace("Tapjoy sample event listener for " + event.type + ", " + event.balance + ", " + event.currencyName);  }

지정한

TJCurrencyEvent.GET_CURRENCY_BALANCE_SUCCESS

핸들러에서 재화 잔액에 대한 알림이 전달되며, 이 핸들러는

TJCurrencyEvent

파라미터를 전달합니다. 이 오브젝트에는

currencyName

및

balance

등록 정보가 포함되어 있습니다.

TJCurrencyEvent.GET_CURRENCY_BALANCE_FAILURE

핸들러에서 오류가 발생하면 알림을 받게 됩니다.

사용자가 화폐를 획득했는지 확인

마지막 잔액 확인 이후 재화를 획득하면 사용자에게 알림을 제공합니다. 알림을 설정하려면 다음 섹션의 플랫폼별 명령어를 사용합니다.

iOS 디바이스에서 획득한 재화를 감지하려면 알림 관찰자를 추가합니다.


// Set the notification observer for earned-currency-notification. It's recommended that this be placed within the applicationDidBecomeActive method.[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(showEarnedCurrencyAlert:) name:TJC_CURRENCY_EARNED_NOTIFICATION object:nil];// In the following method, you can set a custom message or use the default UIAlert to inform the user that they just earned some currency.- (void)showEarnedCurrencyAlert:(NSNotification*)notifyObj{  NSNumber *currencyEarned = notifyObj.object;  int earnedNum = [currencyEarned intValue];  NSLog(@"Currency earned: %d", earnedNum);  // Pops up a UIAlert notifying the user that they have successfully earned some currency.  // This is the default alert, so you may place a custom alert here if you choose to do so.  [Tapjoy showDefaultEarnedCurrencyAlert];  // This is a good place to remove this notification since it is undesirable to have a pop-up alert more than once per app run.  [[NSNotificationCenter defaultCenter] removeObserver:self name:TJC_CURRENCY_EARNED_NOTIFICATION object:nil];}

사용자가 가상 재화를 획득할 때마다(예: 오퍼를 통해) 알림을 받으려면 다음 방법으로 획득한 재화 리스너를 설정합니다.


  // Get notifications whenever Tapjoy currency is earned.  Tapjoy.setEarnedCurrencyListener(new TJEarnedCurrencyListener() {    @Override    public void onEarnedCurrency(String currencyName, int amount) {      Log.i("Tapjoy", "You've just earned " + amount + " " + currencyName);    }  });

획득한 재화 알림은

onEarnedCurrency(String currencyName, int amount)

콜백 내의

TJEarnedCurrencyListener

에서 수신합니다. 예를 들어 사용자의 잔액이 100이고 오퍼로 25를 획득했다면, 다음

getCurrencyBalance()

호출 시

onEarnedCurrency

가 25 금액으로 트리거됩니다.


// on enable, add delegatesvoid OnEnable() {  Tapjoy.OnEarnedCurrency += HandleEarnedCurrency;}// on disable, remove delegatesvoid OnDisable() {  Tapjoy.OnEarnedCurrency -= HandleEarnedCurrency;}public void HandleEarnedCurrency(string currencyName, int amount) {  Debug.Log("C#: HandleEarnedCurrency: currencyName: " + currencyName + ", amount: " + amount);}

지정한

OnEarnedCurrency

핸들러를 통해 획득한 재화로 알림을 받게 되며,

currencyName

및

amount

파라미터가 전달됩니다.


  TapjoyAIR.addEventListener(TJEarnedCurrencyEvent.EARNED_CURRENCY, tapjoyEarnedCurrencyEventHandler);  private function tapjoyEarnedCurrencyEventHandler(event:TJEarnedCurrencyEvent):void  {    trace("You can notify user's here that they've just earned " + event.amount + " " + event.currencyName);  }

지정한

earned in the TJEarnedCurrencyEvent.EARNED_CURRENCY

핸들러에서 재화 관련 알림을 받게 되며

TJEarnedCurrencyEvent object

가 전달됩니다. 이 오브젝트에는

currencyName

및

amount

등록 정보가 포함되어 있습니다.