Отчёт о транзакциях в режиме Observer Mode во Flutter SDK

В режиме Observer Mode SDK Adapty не может самостоятельно отслеживать покупки, сделанные через вашу существующую систему покупок. Вам нужно сообщать о транзакциях из вашего стора. Крайне важно настроить это до выпуска приложения, чтобы избежать ошибок в аналитике.

Используйте reportTransaction, чтобы явно сообщать о каждой транзакции, которую должна распознать Adapty.

Если вы используете пейволы Adapty, включайте variationId при отчёте о транзакции. Это связывает покупку с пейволом, который её инициировал, и обеспечивает точную аналитику пейвола.

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        "YOUR_TRANSACTION_ID", 
        variationId: "PAYWALL_VARIATION_ID", // optional
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

Параметры:

Параметр	Обязательность	Описание
transactionId	обязательный	Для iOS: идентификатор транзакции. Для Android: строковый идентификатор purchase.getOrderId покупки, где покупка — это экземпляр класса Purchase из библиотеки биллинга.
variationId	необязательный	Строковый идентификатор варианта. Его можно получить с помощью свойства variationId объекта AdaptyPaywall.

В режиме Observer Mode SDK Adapty не может самостоятельно отслеживать покупки, сделанные через вашу существующую систему покупок. Вам нужно сообщать о транзакциях из вашего стора или восстанавливать их. Крайне важно настроить это до выпуска приложения, чтобы избежать ошибок в аналитике.

Используйте reportTransaction на обеих платформах, чтобы явно сообщать о каждой транзакции, и используйте restorePurchases на Android в качестве дополнительного шага, чтобы убедиться, что Adapty распознала её.

Если вы используете пейволы Adapty, включайте variationId при отчёте о транзакции. Это связывает покупку с пейволом, который её инициировал, и обеспечивает точную аналитику пейвола.

// every time when calling transaction.finish()
if (Platform.isAndroid) {
    try {
        await Adapty().restorePurchases();
    } on AdaptyError catch (adaptyError) {
        // handle the error
    } catch (e) {
    }
}

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        "YOUR_TRANSACTION_ID", 
        variationId: "PAYWALL_VARIATION_ID", // optional
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

Параметры:

Параметр	Обязательность	Описание
transactionId	обязательный	Для iOS, StoreKit 1: объект SKPaymentTransaction. Для iOS, StoreKit 2: объект Transaction. Для Android: строковый идентификатор (purchase.getOrderId покупки, где покупка — это экземпляр класса Purchase из библиотеки биллинга).
variationId	необязательный	Строковый идентификатор варианта. Его можно получить с помощью свойства variationId объекта AdaptyPaywall.

Привязка пейволов к транзакциям

SDK Adapty не может определить источник покупок, так как вы сами их обрабатываете. Поэтому, если вы планируете использовать пейволы и/или A/B-тесты в режиме Observer Mode, вам нужно связать транзакцию из вашего стора с соответствующим пейволом в коде мобильного приложения. Это важно сделать правильно до выпуска приложения, иначе это приведёт к ошибкам в аналитике.

final transactionId = transaction.transactionIdentifier
final variationId = paywall.variationId

try {
  await Adapty().setVariationId('transactionId', variationId);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}