탭조이 관리형 재화
탭조이 오퍼월 관리형 재화를 사용하여 탭조이 서버에 사용자 재화 잔액을 저장하고 관리합니다.
읽는 시간 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사용자가 재화를 획득했는지 확인
사용자에게 앱이 마지막으로 재화 잔액을 조회한 이후 가상 재화를 획득했음을 알리기 위해 알림 관찰자를 설정합니다.
// 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]); }}];
currencyNameamount탭조이 관리형 재화 보상
사용자에게 일정 금액의 가상 재화를 지급하려면 다음 메서드를 호출합니다.
위에서 설명한 바와 같이, 완료 블록에서 재화 잔액에 대한 알림을 받게 되며, 파라미터// 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]); }}];
currencyNameamount관리형 재화 테스트
오퍼월에서 테스트 오퍼를 확인하려면 애플리케이션에 테스트 디바이스를 추가할 수 있습니다. 이렇게 하면 테스트 오퍼가 오퍼월 상단에 표시되어 재화 테스트를 쉽게 수행할 수 있습니다. 탭조이 관리형 재화 구현이 제대로 작동하는지 확인하는 또 다른 툴로는 탭조이 대시보드의 'Get User Balance' 툴이 있습니다.
getCurrencyBalance베스트 프랙티스
- 일부 퍼블리셔는 클라이언트 측 알림 전용으로 관리형 재화를 구현하고 재화를 로컬에 저장합니다. 로컬 저장 재화 값에만 의존하지 않도록 강력히 권장합니다. 문제가 발생할 경우 지원을 제공할 수 없습니다. 이 문제가 발생할 경우 자체 관리형 재화 사용을 고려해야 할 수 있습니다.
- 는 항목이나 콘텐츠 잠금 해제를 위해 재화를 차감할 때만 호출해야 합니다.
spendCurrency - 관리형 재화는 앱 ID당 1개 재화만 지원합니다. 여러 재화를 사용 중이라면 자체 관리형 재화를 사용해야 합니다.
- 잔액은 디바이스별 앱별로 저장되므로 디바이스 간 잔액 공유가 불가능합니다.