구독 정보 전송

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

1. Instantiate a subscription object

- (nullable id)initWithPrice:(nonnull NSDecimalNumber *)price
                    currency:(nonnull NSString *)currency
               transactionId:(nonnull NSString *)transactionId;

시작하려면 구독 구매에 대한 세부 정보가 포함된 구독 객체를 생성해야 합니다. 이 작업을 위해서는 initWithPrice 메서드를 사용해 ADJAppStoreSubscription 객체를 초기화합니다. 다음 인수를 전달합니다.

파라미터	데이터 유형	설명
`price`	`NSDecimalNumber`	구독료
`currency`	`NSString`	구독 통화. `priceLocale` 객체의 `currencyCode`로 포맷됨
`transactionId`	`NSString`	거래 ID

Swift
Objective-C

1
let subscription = ADJAppStoreSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId

1
ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price
2
                                                                        currency:currency
3
                                                                        transactionId:transactionId];

Record the purchase date

- (void)setTransactionDate:(nonnull NSDate *)transactionDate;

사용자가 구독을 구매한 날짜를 기록할 수 있습니다. SDK는 리포트할 수 있도록 이 데이터를 반환합니다. 이 정보를 기록할 타임스탬프와 함께 setTransactionDate 메서드를 호출합니다.

Swift
Objective-C

1
let subscription = ADJAppStoreSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId)
5
// ...
6
subscription.setTransactionDate(transactionDate)

1
ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price
2
                                                                        currency:currency
3
                                                                        transactionId:transactionId];
4
/// ...
5
[subscription setTransactionDate:transactionDate];

Record the purchase region

- (void)setSalesRegion:(nonnull NSString *)salesRegion;

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

Swift
Objective-C

1
let subscription = ADJAppStoreSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId)
5
// ...
6
subscription.setSalesRegion(salesRegion)

1
ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price
2
                                                                        currency:currency
3
                                                                        transactionId:transactionId];
4
/// ...
5
[subscription setSalesRegion:salesRegion];

Add callback parameters

- (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value;

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

Swift
Objective-C

1
let subscription = ADJAppStoreSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId)
5
// ...
6
subscription.addCallbackParameter("key1", value: "value1")
7
subscription.addCallbackParameter("key2", value: "value2")

1
ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price
2
                                                                        currency:currency
3
                                                                        transactionId:transactionId];
4
/// ...
5
[subscription addCallbackParameter:@"key1" value:@"value1"];
6
[subscription addCallbackParameter:@"key2" value:@"value2"];

Add partner parameters

- (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value;

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

Swift
Objective-C

1
let subscription = ADJAppStoreSubscription(
2
    price: price,
3
    currency: currency,
4
    transactionId: transactionId)
5
// ...
6
subscription.addParameterParameter("key1", value: "value1")
7
subscription.addParameterParameter("key2", value: "value2")

1
ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price
2
                                                                        currency:currency
3
                                                                        transactionId:transactionId];
4
/// ...
5
[subscription addParameterParameter:@"key1" value:@"value1"];
6
[subscription addParameterParameter:@"key2" value:@"value2"];

2. Send subscription information

+ (void)trackAppStoreSubscription:(nonnull ADJAppStoreSubscription *)subscription;

구독 객체를 설정하고 나면 Adjust SDK를 사용하여 Adjust에 전송할 수 있습니다. 완료된 객체를 trackAppStoreSubscription 메서드로 전달하여 사용자의 구독 구매를 기록합니다.

Swift
Objective-C

1
let subscription = ADJAppStoreSubscription(
2
   price: price,
3
   currency: currency,
4
   transactionId: transactionId)
5

6
subscription.setTransactionDate(transactionDate)
7
subscription.setSalesRegion(salesRegion)
8

9
// Add callback parameters
10

11
subscription.addCallbackParameter("key1", value: "value1")
12
subscription.addCallbackParameter("key2", value: "value2")
13

14
// Add partner parameters
15

16
subscription.addPartnerParameter("key1", value: "value1")
17
subscription.addCallbackParameter("key2", value: "value2")
18

19
Adjust.trackAppStoreSubscription(subscription)

1
ADJAppStoreSubscription *subscription = [[ADJAppStoreSubscription alloc] initWithPrice:price
2
                                                                        currency:currency
3
                                                                        transactionId:transactionId
4
[subscription setTransactionDate:transactionDate];
5
[subscription setSalesRegion:salesRegion];
6

7
/// Add callback parameters
8
[subscription addCallbackParameter:@"key1" value:@"value1"];
9
[subscription addCallbackParameter:@"key2" value:@"value2"];
10

11
/// Add partner parameters
12
[subscription addPartnerParameter:@"key1" value:@"value1"];
13
[subscription addPartnerParameter:@"key2" value:@"value2"];
14

15
[Adjust trackAppStoreSubscription:subscription];