Send subscription information

You can record App Store and Play Store subscriptions and verify their validity with the Adjust SDK. After the user purchases a subscription, create an AdjustAppStoreSubscription2dx or AdjustPlayStoreSubscription2dx instance containing the details.

1. Instantiate a subscription object

To get started, you need to create a subscription object containing details of the subscription purchase.

App Store
Play Store

public: AdjustAppStoreSubscription2dx(std::string price, std::string currency, std::string transactionId, std::string receipt)

Create an AdjustAppStoreSubscription2dx object with the following properties:

Parameter	Data type	Description
`price`	String	The price of the subscription
`currency`	String	The currency of the subscription. Formatted as the `currencyCode` of the `priceLocale` object
`transactionId`	String	Your ID for the transaction
`receipt`	String	The receipt information

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

public: AdjustPlayStoreSubscription2dx(std::string price, std::string currency, std::string sku, std::string orderId, std::string signature, std::string purchaseToken);

Create an AdjustPlayStoreSubscription2dx object with the following properties:

Parameter	Data type	Description
`price`	Number	The price of the subscription
`currency`	String	The currency of the subscription
`sku`	String	The ID of the product
`orderId`	String	Your ID for the transaction
`signature`	String	The signature of the purchase data
`purchaseToken`	String	The unique token of the transaction. See Google’s documentation for more information

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

Record the purchase date

You can record the date on which the user purchased a subscription. The SDK returns this data for you to report on.

App Store
Play Store

void setTransactionDate(std::string transactionDate);

Call the setTransactionDate method on your subscription object to record the timestamp of the subscription.

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
    price,
3
    currency,
4
    transactionId,
5
    receipt
6
);
7
subscription.setTransactionDate(transactionDate);

void setPurchaseTime(std::string purchaseTime);

Call the setPurchaseTime method on your subscription object to record the timestamp of the subscription.

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

Record the purchase region (iOS only)

void setSalesRegion(std::string salesRegion);

You can record the region in which the user purchased a subscription. To do this, call the setSalesRegion method on your subscription object and pass the country code as a string. This needs to be formatted as the countryCode of the Storefront object.

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
    price,
3
    currency,
4
    transactionId,
5
    receipt
6
);
7
subscription.setSalesRegion(salesRegion);

Add callback parameters

You can add callback parameters to your subscription object. The SDK appends these parameters to your callback URL. To add callback parameters, call the addCallbackParameter method on your subscription object. You can add multiple callback parameters by calling this method multiple times.

App Store
Play Store

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

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
    price,
3
    currency,
4
    transactionId,
5
    receipt
6
);
7
subscription.addCallbackParameter("key1", "value1");
8
subscription.addCallbackParameter("key2", "value2");

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

1
AdjustPlayStoreSubscription2dx subscription = AdjustPlayStoreSubscription2dx(
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

You can add partner parameters to your subscription object. The SDK sends these to Adjust’s servers when the user purchases a subscription. Adjust’s servers forward the information on to your network partner. To add partner parameters, call the addPartnerParameter method on your subscription object. You can add multiple partner parameters by calling this method multiple times.

App Store
Play Store

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

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
2
    price,
3
    currency,
4
    transactionId,
5
    receipt
6
);
7
subscription.addPartnerParameter("key1", "value1");
8
subscription.addPartnerParameter("key2", "value2");

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

1
AdjustPlayStoreSubscription2dx subscription = AdjustPlayStoreSubscription2dx(
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

Once you have set up your subscription object, you can record it using the Adjust SDK.

App Store
Play Store

static void trackAppStoreSubscription(AdjustAppStoreSubscription2dx subscription);

Pass your subscription object to the trackAppStoreSubscription method to record the user’s subscription purchase.

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(
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
Adjust2dx::trackAppStoreSubscription(subscription);

static void trackPlayStoreSubscription(AdjustPlayStoreSubscription2dx subscription);

Pass your subscription object to the trackPlayStoreSubscription method to record the user’s subscription purchase.

1
AdjustPlayStoreSubscription2dx subscription = AdjustPlayStoreSubscription2dx(
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
Adjust2dx::trackPlayStoreSubscription(subscription);