Unity 구매 검증 마이그레이션 가이드

본 가이드에서는 Adjust의 구매 검증 SDK에서 SDK v5에 내장된 구매 검증 기능으로 마이그레이션하는 방법을 확인하실 수 있습니다. SDK v5 구매 검증 워크플로우는 간소화된 구매 검증 방식입니다.

구매 검증 SDK의 검증은 다음의 3단계로 나뉩니다.

1. 구매 검증 SDK를 초기화합니다.

   1
   var adjustPVConfig = new ADJPConfig(
   2
       adjustAppToken,
   3
       ADJPEnvironment.Production
   4
   );
   5
   
   6
   adjustPVConfig.SetLogLevel(ADJPLogLevel.Info);
   7
   new GameObject("AdjustPurchase").AddComponent<adjustpurchase>();
   8
   
   9
   AdjustPurchase.Init(adjustPVConfig);

2. 구매를 인증합니다.

   1
   // purchase verification request on iOS
   2
   AdjustPurchase.VerifyPurchaseiOS("{Receipt}", "{TransactionID}", "{ProductId}", VerificationInfoDelegate);
   3
   
   4
   // purchase verification request on Android
   5
   AdjustPurchase.VerifyPurchaseAndroid("{ItemSKU}", "{ItemToken}", "{DeveloperPayload}", VerificationInfoDelegate);
   6
   
   7
   // ...
   8
   
   9
   private void VerificationInfoDelegate(ADJPVerificationInfo verificationInfo)
   10
   {
   11
       Debug.Log("Verification info callback!");
   12
       Debug.Log("Message: " + verificationInfo.Message);
   13
       Debug.Log("Status code: " + verificationInfo.StatusCode);
   14
       Debug.Log("Verification state: " + verificationInfo.VerificationState);
   15
   }

3. 인증 결과에 따라 AdjustEvent 객체를 구성하고 Adjust에 전송합니다.

   1
   AdjustEvent adjustEvent = new AdjustEvent("abc123");
   2
   adjustEvent.setRevenue(6.0, "EUR");
   3
   adjustEvent.setProductId("product-id");
   4
   adjustEvent.setTransactionId("transaction-id");
   5
   adjustEvent.setPurchaseToken("purchase-token"); // Android only
   6
   adjustEvent.setReceipt("receipt"); // iOS only
   7
   Adjust.trackEvent(adjustEvent);

SDK v5에서는 이 워크플로우가 간소화되었습니다. Adjust.verifyAndTrackAppStorePurchase() 및 Adjust.verifyAndTrackPlayStorePurchase() 메서드를 통해 Adjust 서버로 이벤트를 보내고 인증 상태를 콜백으로 받을 수 있습니다. Adjust는 이벤트와 인증 상태를 자동으로 기록합니다.

가이드

이 가이드를 참조하여 구매 검증 SDK에서 SDK v5에 내장된 구매 검증 기능으로 마이그레이션하시기 바랍니다.

1. 구매 검증 SDK 삭제

시작을 위해 Adjust 구매 검증 SDK를 삭제하시기 바랍니다.

2. 구매 검증 SDK 코드 삭제

Adjust 구매 검증 SDK 삭제가 완료되면, 프로젝트에서 모든 구매 검증 코드를 삭제해야 합니다.

3. SDK v5 구매 검증 사용을 위한 마이그레이션

기존의 구매 검증 코드를 삭제한 후에는 이를 SDK v5에 내장된 구매 검증 메서드로 교체할 수 있습니다. Adjust SDK로 구매를 검증하는 방법에는 두 가지가 있습니다.

1. 구매를 나타내는 AdjustEvent 객체를 만들고 타깃 스토어에 대한 구매 속성을 구성합니다.
2. 구매를 나타내는 AdjustAppStorePurchase(Apple 앱 스토어) 또는 AdjustPlayStorePurchase(Google 플레이 스토어) 객체를 생성합니다.

이벤트 기록 및 구매 인증

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.SetRevenue(6.66, "CAD");
3
adjustEvent.TransactionId = "transaction-id";
4
adjustEvent.ProductId = "product-id";
5
Adjust.VerifyAndTrackPlayStorePurchase(adjustEvent, verificationResult =>
6
{
7
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
8
    Debug.Log("Code: " + verificationResult.Code);
9
    Debug.Log("Message: " + verificationResult.Message);
10
});

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.SetRevenue(6.66, "CAD");
3
adjustEvent.ProductId = "product-id";
4
adjustEvent.PurchaseToken = "purchase-token";
5
Adjust.VerifyAndTrackPlayStorePurchase(adjustEvent, verificationResult =>
6
{
7
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
8
    Debug.Log("Code: " + verificationResult.Code);
9
    Debug.Log("Message: " + verificationResult.Message);
10
});

구매만 검증

1
AdjustAppStorePurchase purchase = new AdjustAppStorePurchase("transaction-id", "product-id");
2
Adjust.VerifyAppStorePurchase(purchase, verificationResult =>
3
{
4
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
5
    Debug.Log("Code: " + verificationResult.Code);
6
    Debug.Log("Message: " + verificationResult.Message);
7
});

1
AdjustPlayStorePurchase purchase = new AdjustPlayStorePurchase("product-id", "purchase-token");
2
Adjust.VerifyPlayStorePurchase(purchase, verificationResult =>
3
{
4
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
5
    Debug.Log("Code: " + verificationResult.Code);
6
    Debug.Log("Message: " + verificationResult.Message);
7
});