Android SDKのオブザーバーモードでトランザクションを報告する
オブザーバーモードでは、Adapty SDKは既存の購入システムを通じて行われた購入を自動的に追跡できません。アプリストアからのトランザクションを自分で報告する必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を完了しておくことが重要です。
各トランザクションをAdaptyに明示的に報告するには、reportTransactionを使用してください。
トランザクションの報告をスキップしないでください!
reportTransactionを呼び出さない場合、Adaptyはそのトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adaptyのペイウォールを使用している場合は、トランザクションを報告する際にvariationIdを含めてください。これにより、購入がトリガーとなったペイウォールに紐付けられ、正確なペイウォールアナリティクスが確保されます。
val transactionInfo = TransactionInfo.fromPurchase(purchase)
Adapty.reportTransaction(transactionInfo, variationId) { result ->
if (result is AdaptyResult.Success) {
// success
}
}パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionInfo | 必須 | 購入からのTransactionInfoです。purchaseはBillingライブラリのPurchaseクラスのインスタンスです。 |
| variationId | 任意 | バリアントの文字列識別子です。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |
TransactionInfo transactionInfo = TransactionInfo.fromPurchase(purchase);
Adapty.reportTransaction(transactionInfo, variationId, result -> {
if (result instanceof AdaptyResult.Success) {
// success
}
});パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionInfo | 必須 | 購入からのTransactionInfoです。purchaseはBillingライブラリのPurchaseクラスのインスタンスです。 |
| variationId | 任意 | バリアントの文字列識別子です。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |
オブザーバーモードでは、Adapty SDKは既存の購入システムを通じて行われた購入を自動的に追跡できません。アプリストアからのトランザクションを報告するか、復元する必要があります。アナリティクスのエラーを防ぐため、アプリをリリースする前にこの設定を完了しておくことが重要です。
トランザクションをAdaptyに報告するには、restorePurchasesを使用してください。
購入の復元をスキップしないでください!
restorePurchasesを呼び出さない場合、Adaptyはそのトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
Adaptyのペイウォールを使用している場合は、setVariationIdメソッドを使用して、トランザクションを購入のきっかけとなったペイウォールに紐付けてください。これにより、正確なアナリティクスのために購入がトリガーとなったペイウォールに正しく関連付けられます。この手順は、Adaptyのペイウォールを使用している場合にのみ必要です。
Adapty.restorePurchases { result ->
if (result is AdaptyResult.Success) {
// success
}
}
Adapty.setVariationId(transactionId, variationId) { error ->
if (error == null) {
// success
}
}パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 | 購入の文字列識別子(purchase.getOrderId)です。purchaseはBillingライブラリのPurchaseクラスのインスタンスです。 |
| variationId | 必須 | バリアントの文字列識別子です。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |
Adapty.restorePurchases(result -> {
if (result instanceof AdaptyResult.Success) {
// success
}
});
Adapty.setVariationId(transactionId, variationId, error -> {
if (error == null) {
// success
}
});パラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 | 購入の文字列識別子(purchase.getOrderId)です。purchaseはBillingライブラリのPurchaseクラスのインスタンスです。 |
| variationId | 必須 | バリアントの文字列識別子です。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |
トランザクションの報告
オブザーバーモードでAdaptyにトランザクションを報告するには、モバイルコードでの購入の復元ページで説明されているようにrestorePurchasesを使用してください。
トランザクションの報告をスキップしないでください!
restorePurchasesを呼び出さない場合、Adaptyはそのトランザクションを認識できず、アナリティクスに表示されず、インテグレーションにも送信されません。
ペイウォールとトランザクションの関連付け
Adapty SDKは購入の発生元を判断できません。購入の処理はあなた自身が行うためです。そのため、オブザーバーモードでペイウォールやA/B テストを使用する場合は、アプリストアからのトランザクションをモバイルアプリのコード内で対応するペイウォールに関連付ける必要があります。アプリのリリース前にこれを正しく設定しておくことが重要です。設定しないと、アナリティクスにエラーが発生します。
Adapty.setVariationId(transactionId, variationId) { error ->
if (error == null) {
// success
}
}リクエストパラメーター:
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 | 購入の文字列識別子(purchase.getOrderId)です。purchaseはBillingライブラリのPurchaseクラスのインスタンスです。 |
| variationId | 必須 | バリアントの文字列識別子です。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |
Adapty.setVariationId(transactionId, variationId, error -> {
if (error == null) {
// success
}
});
| パラメーター | 必須/任意 | 説明 |
|---|---|---|
| transactionId | 必須 | 購入の文字列識別子(purchase.getOrderId)です。purchaseはBillingライブラリのPurchaseクラスのインスタンスです。 |
| variationId | 必須 | バリアントの文字列識別子です。AdaptyPaywallオブジェクトのvariationIdプロパティを使用して取得できます。 |