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

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

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

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

1
String yourAppToken = "{YourAppToken}";
2
String environment = ADJPConstants.ENVIRONMENT_SANDBOX;
3

4
ADJPConfig config = new ADJPConfig(yourAppToken, environment);
5

6
AdjustPurchase.init(config);

2. 구매를 인증합니다.

1
AdjustPurchase.verifyPurchase(purchase.getSku(),
2
                              purchase.getToken(),
3
                              purchase.getDeveloperPayload(),
4
                              new OnADJPVerificationFinished() {
5
    @Override
6
    public void onVerificationFinished(ADJPVerificationInfo info) {
7
        // process ADJPVerificationInfo
8
    }
9
});

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

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.setRevenue(6.0, "EUR");
3
adjustEvent.setProductId("product-id");
4
adjustEvent.setPurchaseToken("purchase-token");
5
Adjust.trackEvent(adjustEvent);

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

가이드

이 가이드에 나온 단계를 수행하여 지정한 SDK 에서 SDK v5 내장된 버전으로 마이그레이션하시기 바랍니다.

1. 구매 검증 SDK 삭제

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

2. 구매 검증 SDK 코드 삭제

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

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

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

1. 구매를 나타내는 AdjustEvent 객체를 생성하고 다음 속성을 추가합니다.

   • productId (String): 성공적으로 구매된 아이템의 제품 ID.
   • purchaseToken (String): 성공적으로 완료된 인앱 구매에 대해 생성된 구매 토큰.

2. 제품 ID와 구매 토큰으로 AdjustPlayStorePurchase 객체를 생성합니다.

이벤트 기록 및 구매 검증

검증을 위해 매출 이벤트를 전송하고 승인 상태를 수신하려면 다음의 단계를 수행하시기 바랍니다.

1. 이벤트 토큰으로 AdjustEvent 객체를 인스턴스화하고 다음 파라미터를 설정합니다.

   • productId (String): 구매된 제품의 ID.
   • purchaseToken (String): 구매와 관련된 구매 토큰.

2. 다음 인수와 함께 Adjust.verifyAndTrackPlayStorePurchase 메서드를 호출합니다.

   • event (AdjustEvent): 인스턴스화된 이벤트 객체.
   • callback (OnPurchaseVerificationFinishedListener): AdjustPurchaseVerificationResult 객체를 인수로 수신하는 델리게이트 콜백 함수.

이 예시에서, 구매 검증 응답은 logging daemon으로 출력됩니다.

1
val adjustEvent = AdjustEvent("abc123")
2
adjustEvent.setRevenue(6.0, "EUR")
3
adjustEvent.productId = "product-id"
4
adjustEvent.purchaseToken = "purchase-token"
5
Adjust.trackEvent(adjustEvent)
6

7
Adjust.verifyAndTrackPlayStorePurchase(adjustEvent) {
8
    result -> Log.d("Verification status: ", result.verificationStatus)
9
    Log.d("Code: ", result.code)
10
    Log.d("Message: ", result.message)
11
}

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.setRevenue(6.0, "EUR");
3
adjustEvent.setProductId("product-id");
4
adjustEvent.setPurchaseToken("purchase-token");
5
Adjust.trackEvent(adjustEvent);
6

7
Adjust.verifyAndTrackPlayStorePurchase(adjustEvent, new OnPurchaseVerificationFinishedListener() {
8
    @Override
9
    public void onFinished(AdjustPurchaseVerificationResult result) {
10
       Log.d("Verification status: ", result.verificationStatus);
11
       Log.d("Code: ", result.code);
12
       Log.d("Message: ", result.message);
13
    }
14
});

구매만 검증

독립형 구매를 전송하고 구매 검증 상태 정보를 수신하려면 다음의 단계를 수행하시기 바랍니다.

1. 다음 인수를 사용하여 AdjustPlayStorePurchase 를 인스턴스화합니다.

   • productId (String): 구매된 제품의 ID.
   • purchaseToken (String): 구매와 관련된 구매 토큰.

2. 다음 인수와 함께 Adjust.verifyPlayStorePurchase 메서드를 호출합니다.

   • purchase (AdjustPlayStorePurchase): 인스턴스화된 구매 객체.
   • callback (OnPurchaseVerificationFinishedListener): AdjustPurchaseVerificationResult 객체를 인수로 수신하는 델리게이트 콜백 함수.

이 예시에서, 구매 검증 응답은 logging daemon으로 출력됩니다.

1
val purchase = AdjustPlayStorePurchase("product-id", "purchase-token")
2
Adjust.verifyPlayStorePurchase(purchase) {
3
    result -> Log.d("Verification status: ", result.verificationStatus)
4
    Log.d("Code: ", result.code)
5
    Log.d("Message: ", result.message)
6
}

1
AdjustPlayStorePurchase purchase = new AdjustPlayStorePurchase("product-id", "purchase-token");
2
Adjust.verifyPlayStorePurchase(purchase, new OnPurchaseVerificationFinishedListener() {
3
    @Override
4
    public void onFinished(AdjustPurchaseVerificationResult result) {
5
       Log.d("Verification status: ", result.verificationStatus);
6
       Log.d("Code: ", result.code);
7
       Log.d("Message: ", result.message);
8
    }
9
});