기술 자료

지원

탭조이 관리형 재화

탭조이 오퍼월 관리형 재화를 사용하여 탭조이 서버에 사용자 재화 잔액을 저장하고 관리합니다.
읽는 시간 4분최근 업데이트: 2일 전

탭조이 관리형 재화를 사용하면 탭조이의 서버를 사용하여 사용자의 재화 금액을 저장할 수 있습니다. 이 서비스는 탭조이의 퍼블리셔 SDK를 연동하는 모든 개발자에게 무료로 제공됩니다. 이렇게 하면 애플리케이션의 사용자 재화 데이터를 저장하는 데 일반적으로 필요한 백엔드 작업을 하지 않을 수 있습니다. 연동은 비교적 간단하며, 아래에 연동 방법이 상세히 설명되어 있습니다.

재화 잔액 가져오기

사용자의 현재 가상 재화를 확인하려면 다음 메서드를 호출합니다. VIRTUAL CURRENCY BEST PRACTICE: 사용자의 잔액이 항상 최신 상태를 유지하도록 가능한 한 자주 getCurrencyBalance를 호출하는 것이 좋습니다. 앱 실행 시, 앱 재개 시, 탭조이 보기 종료 시, 플레이스먼트 콘텐츠가 사라질 때 등이 사용자의 잔액을 확인하는 일반적인 시점입니다. 광고 콘텐츠가 사라진 후 3.5초 후에 getCurrencyBalance(또는 사용 중인 플랫폼의 해당 호출)를 호출하는 것이 특히 유용한 경우가 많습니다. 이렇게 하면 재화 잔액을 확인할 때까지 보상이 시스템에 반영될 시간을 확보할 수 있습니다. 콘텐츠 표시가 끝난 직후 getCurrencyBalance를 확인하면, 잔액을 조회하기 전에 보상이 사용자의 잔액에 반영되지 않을 수 있습니다.
// 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 패키지의 샘플 애플리케이션을 참고하십시오.

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

사용자에게 앱이 마지막으로 재화 잔액을 조회한 이후 가상 재화를 획득했음을 알리기 위해 알림 관찰자를 설정합니다.
// 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];}

탭조이 관리형 재화 지출

사용자의 가상 재화를 일정 금액 사용하려면 다음 메서드를 호출합니다.
// This method call will deduct 10 virtual currencies from the user's total.[Tapjoy spendCurrency:10 completion:^(NSDictionary *parameters, NSError *error) { if (error) { NSLog(@"spendCurrency error: %@", [error localizedDescription]); } else { NSLog(@"spendCurrency returned %@: %d", parameters[@"currencyName"], [parameters[@"amount"] intValue]); }}];
위에서 설명한 바와 같이, 완료 블록에서 재화 잔액에 대한 알림을 받게 되며, 파라미터
currencyName
는 재화 이름을 제공하고,
amount
는 사용자의 잔액을 제공합니다.

탭조이 관리형 재화 보상

사용자에게 일정 금액의 가상 재화를 지급하려면 다음 메서드를 호출합니다.
// This method call will award 10 virtual currencies to the user's total.[Tapjoy awardCurrency:10 completion:^(NSDictionary *parameters, NSError *error) { if (error) { NSLog(@"awardCurrency error: %@", [error localizedDescription]); } else { NSLog(@"awardCurrency returned %@: %d", parameters[@"currencyName"], [parameters[@"amount"] intValue]); }}];
위에서 설명한 바와 같이, 완료 블록에서 재화 잔액에 대한 알림을 받게 되며, 파라미터
currencyName
는 재화 이름을 제공하고,
amount
는 사용자의 잔액을 제공합니다.

관리형 재화 테스트

오퍼월에서 테스트 오퍼를 확인하려면 애플리케이션에 테스트 디바이스를 추가할 수 있습니다. 이렇게 하면 테스트 오퍼가 오퍼월 상단에 표시되어 재화 테스트를 쉽게 수행할 수 있습니다. 탭조이 관리형 재화 구현이 제대로 작동하는지 확인하는 또 다른 툴로는 탭조이 대시보드의 'Get User Balance' 툴이 있습니다.
탭조이 대시보드의 사용자 잔액 화면
앱에서 사용자의 잔액이 본 툴과 다르게 표시된다면, 앱이 탭조이 잔액과 동기화되지 않은 상태일 가능성이 높습니다. 일반적으로 앱에서
getCurrencyBalance
를 충분히 자주 호출하도록 하면 이 문제를 해결할 수 있습니다.

베스트 프랙티스

  • 일부 퍼블리셔는 클라이언트 측 알림 전용으로 관리형 재화를 구현하고 재화를 로컬에 저장합니다. 로컬 저장 재화 값에만 의존하지 않도록 강력히 권장합니다. 문제가 발생할 경우 지원을 제공할 수 없습니다. 이 문제가 발생할 경우 자체 관리형 재화 사용을 고려해야 할 수 있습니다.
  • spendCurrency
    는 항목이나 콘텐츠 잠금 해제를 위해 재화를 차감할 때만 호출해야 합니다.
  • 관리형 재화는 앱 ID당 1개 재화만 지원합니다. 여러 재화를 사용 중이라면 자체 관리형 재화를 사용해야 합니다.
  • 잔액은 디바이스별 앱별로 저장되므로 디바이스 간 잔액 공유가 불가능합니다.