구독 정보 전송

앱 스토어 및 플레이 스토어 구독을 기록한 후 Adjust SDK로 유효성을 검증할 수 있습니다. 사용자가 구독을 구매한 뒤 상세 내용을 담은 AdjustAppStoreSubscription 또는 AdjustPlayStoreSubscription 인스턴스를 생성하시기 바랍니다.

1. Instantiate a subscription object

시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다.

앱스토어
Play Store

AdjustAppStoreSubscription(String _price, String _currency, String _transactionId)

다음 속성을 포함하는 AdjustAppStoreSubscription 객체를 생성합니다.

| 파라미터 | 데이터 유형 | 설명 | | --------------- | --------- | -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------- | --- | | price | String | 구독 요금 | | currency | String | 구독 통화. priceLocale 객체의 currencyCode로 형식화됨 | |transactionId | String | | 트랜잭션 ID | |

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId);

AdjustPlayStoreSubscription(String _price, String _currency, String _sku, String _orderId, String _signature, String _purchaseToken)

다음 속성을 포함하는 AdjustPlayStoreSubscription 객체를 생성합니다.

파라미터	데이터 유형	설명
`price`	`String`	구독료
`currency`	`String`	구독 통화
`sku`	`String`	제품 ID
`orderId`	`String`	거래 ID
`signature`	`String`	구매 데이터의 서명
`purchaseToken`	`String`	거래의 고유 토큰. 자세한 정보는 Google 문서를 참조하시기 바랍니다.

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);

Record the purchase date

사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다.

앱스토어
Play Store

AdjustAppStoreSubscription 클래스에 transactionDate 속성을 추가합니다.

String? transactionDate

사용자가 구독을 구매한 날짜를 기록하기 위해 subscription 인스턴스의 transactionDate 속성에 타임스탬프를 설정합니다.

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId);
5
//...
6
subscription.transactionDate = 'transactionDate';

AdjustPlayStoreSubscription 클래스에 purchaseTime 속성을 추가합니다.

String? purchaseTime;

사용자가 구독을 구매한 날짜를 기록하기 위해 subscription 인스턴스의 purchaseTime 속성에 타임스탬프를 설정합니다.

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
subscription.purchaseTime = 'purchase-time';

Record the purchase region (iOS only)

String? salesRegion

사용자가 구독을 구매한 지역을 기록할 수 있습니다. 이를 위해 구독 객체의 setSalesRegion 메서드를 호출하고 국가 코드를 String로 전달합니다. 이는 Storefront 객체의 countryCode로 포맷되어야 합니다.

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId);
5
//...
6
subscription.salesRegion = 'sales-region';

Add callback parameters

콜백 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 이러한 파라미터를 콜백 URL에 첨부합니다. 콜백 파라미터를 추가하려면 구독 객체의 addCallbackParameter 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 콜백 파라미터를 추가할 수 있습니다.

앱스토어
Play Store

void addCallbackParameter(String key, String value)

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId);
5
//...
6
subscription.addCallbackParameter('key1', 'value1');
7
subscription.addCallbackParameter('key2', 'value2');

void addCallbackParameter(String key, String value)

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
//...
9
subscription.addCallbackParameter('key1', 'value1');
10
subscription.addCallbackParameter('key2', 'value2');

Add partner parameters

Adjust에서는 파트너 파라미터를 구독 객체에 추가할 수 있습니다. SDK는 사용자가 구독을 구매할 때 이를 Adjust 서버로 전송합니다. 이후 Adjust 서버는 해당 정보를 네트워크 파트너에게 전달합니다. 파트너 파라미터를 추가하려면 구독 객체의 addPartnerParameter 메서드를 호출합니다. 이 메서드를 여러 번 호출하여 여러 개의 파트너 파라미터를 추가할 수 있습니다.

앱스토어
Play Store

void addPartnerParameter(String key, String value)

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId);
5
//...
6
subscription.addPartnerParameter('key1', 'value1');
7
subscription.addPartnerParameter('key2', 'value2');

void addPartnerParameter(String key, String value)

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
//...
9
subscription.addPartnerParameter('key1', 'value1');
10
subscription.addPartnerParameter('key2', 'value2');

2. Record subscription information

구독 객체를 설정하고 나면 Adjust SDK를 사용하여 기록을 시작할 수 있습니다.

앱스토어
Play Store

static void trackAppStoreSubscription(AdjustAppStoreSubscription subscription)

구독 객체를 trackAppStoreSubscription 메서드로 전달하여 사용자의 구독 구매를 기록합니다.

1
AdjustAppStoreSubscription subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId);
5
subscription.transactionDate = 'transactionDate';
6
subscription.salesRegion = 'salesRegion';
7
subscription.addCallbackParameter('key1', 'value1');
8
subscription.addCallbackParameter('key2', 'value2');
9
subscription.addPartnerParameter('key1', 'value1');
10
subscription.addPartnerParameter('key2', 'value2');
11

12
Adjust.trackAppStoreSubscription(subscription);

static void trackPlayStoreSubscription(AdjustPlayStoreSubscription subscription)

구독 객체를 trackPlayStoreSubscription 메서드로 전달하여 사용자의 구독 구매를 기록합니다.

1
AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken);
8
subscription.purchaseTime = 'purchase-time';
9
subscription.addCallbackParameter('key1', 'value1');
10
subscription.addCallbackParameter('key2', 'value2');
11
subscription.addPartnerParameter('key1', 'value1');
12
subscription.addPartnerParameter('key2', 'value2');
13

14
Adjust.trackPlayStoreSubscription(subscription);