구독 정보 전송

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

1. 구독 객체 인스턴스화

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

App Store
Play Store

constructor(price: string, currency: string, transactionId: string, receipt: string)

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

파라미터	데이터 유형	설명
`price`	Number	구독료
`currency`	String	구독 통화. `priceLocale` 객체의 `currencyCode`로 포맷됨
`transactionId`	String	거래 ID
`receipt`	String	영수증 정보

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt,
6
);

constructor(price: string, currency: string, sku: string, orderId: string, signature: string, purchaseToken: string)

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

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

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

구매일 기록

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

App Store
Play Store

setTransactionDate(transactionDate: string): void

구독 객체의 setTransactionDate 메서드를 호출하여 구독의 타임스탬프를 기록합니다.

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt,
6
);
7

8
subscription.setTransactionDate(transactionDate);

setPurchaseTime(purchaseTime: string): void

구독 객체의 setPurchaseTime 메서드를 호출하여 구독의 타임스탬프를 기록합니다.

1
var subscription = new AdjustPlayStoreSubscription(
2
   price,
3
   currency,
4
   sku,
5
   orderId,
6
   signature,
7
   purchaseToken,
8
);
9
subscription.setPurchaseTime(purchaseTime);

구매 지역 기록(iOS만 해당)

setSalesRegion(salesRegion: string): void

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

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt,
6
);
7

8
subscription.setSalesRegion(salesRegion);

콜백 파라미터 추가

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

App Store
Play Store

addCallbackParameter(key: string, value: string): void

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt,
6
);
7

8
subscription.addCallbackParameter("key1", "value1");
9
subscription.addCallbackParameter("key2", "value2");

addCallbackParameter(key: string, value: string): void

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

10
subscription.addCallbackParameter("key1", "value1");
11
subscription.addCallbackParameter("key2", "value2");

파트너 파라미터 추가

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

App Store
Play Store

addPartnerParameter(key: string, value: string): void

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt,
6
);
7

8
subscription.addPartnerParameter("key1", "value1");
9
subscription.addPartnerParameter("key2", "value2");

addPartnerParameter(key: string, value: string): void

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

10
subscription.addPartnerParameter("key1", "value1");
11
subscription.addPartnerParameter("key2", "value2");

2. 구독 정보 기록

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

App Store
Play Store

trackAppStoreSubscription(subscription: AdjustAppStoreSubscription): void

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

1
var subscription = new AdjustAppStoreSubscription(
2
   price,
3
   currency,
4
   transactionId,
5
   receipt,
6
);
7
subscription.setTransactionDate(transactionDate);
8
subscription.setSalesRegion(salesRegion);
9
subscription.addCallbackParameter("key1", "value1");
10
subscription.addCallbackParameter("key2", "value2");
11
subscription.addPartnerParameter("key1", "value1");
12
subscription.addPartnerParameter("key2", "value2");
13

14
Adjust.trackAppStoreSubscription(subscription);

trackPlayStoreSubscription(subscription: AdjustPlayStoreSubscription): void

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

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

15
Adjust.trackPlayStoreSubscription(subscription);