Flutter SDK'da Observer Mode'da işlemleri raporlama

Observer mode’da, Adapty SDK kendi başına mevcut satın alma sisteminiz üzerinden yapılan satın almaları takip edemez. App Store’daki işlemleri uygulamanızdan manuel olarak bildirmeniz gerekir. Analitik hatalarını önlemek için bunu uygulamanızı yayınlamadan önce yapılandırmanız son derece önemlidir.

Her işlemi Adapty’nin tanıyabilmesi için reportTransaction kullanarak açıkça bildirin.

Warning

İşlem raporlamayı atlama! reportTransaction çağırmadığın takdirde Adapty işlemi tanımaz, işlem analizlerde görünmez ve entegrasyonlara gönderilmez.

Adapty flow’ları ve paywall’ları kullanıyorsan, bir işlem raporlarken variationId değerini ekle. Bu, satın almayı tetikleyen flow veya paywall ile ilişkilendirir ve doğru analizler sağlar.

try {
    // transaction.finish() her çağrıldığında
    await Adapty().reportTransaction(
        transactionId: "YOUR_TRANSACTION_ID",
        variationId: "PAYWALL_VARIATION_ID", // isteğe bağlı
    );
} on AdaptyError catch (adaptyError) {
    // hatayı yönet
} catch (e) {
    // hatayı yönet
}

Parametreler:

Parametre	Zorunluluk	Açıklama
transactionId	zorunlu	iOS için: İşlemin tanımlayıcısı. Android için: Satın almanın `purchase.getOrderId` string tanımlayıcısı; burada purchase, billing library Purchase sınıfının bir örneğidir.
variationId	isteğe bağlı	Varyantın string tanımlayıcısı. Bunu AdaptyPaywall nesnesinin `variationId` özelliğini kullanarak alabilirsiniz.

Observer modunda, Adapty SDK mevcut satın alma sisteminiz üzerinden gerçekleştirilen satın almaları kendi başına takip edemez. App store’dan işlemleri raporlamanız veya geri yüklemeniz gerekir. Analitik hatalarını önlemek için bunu uygulamanızı yayınlamadan önce ayarlamanız kritik önem taşır.

Her işlemi açıkça raporlamak için her iki platformda da reportTransaction kullanın; Adapty’nin bunu tanımasını sağlamak için Android’de ek bir adım olarak restorePurchases kullanın.

Warning

İşlem raporlama ve satın alma geri yüklemeyi atlamayın! Eğer bu yöntemleri çağırmazsanız, Adapty işlemi tanımaz, analitiklerde görünmez ve entegrasyonlara gönderilmez.

Adapty flow’ları ve paywalllarını kullanıyorsanız, bir işlemi raporlarken variationId değerini de ekleyin. Bu, satın almayı tetikleyen flow veya paywall ile ilişkilendirerek doğru analitik verisi elde etmenizi sağlar.

// 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(
        transactionId: "YOUR_TRANSACTION_ID",
        variationId: "PAYWALL_VARIATION_ID", // optional
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

Parametreler:

Parametre	Zorunluluk	Açıklama
transactionId	zorunlu	iOS, StoreKit 1 için: bir SKPaymentTransaction nesnesi. iOS, StoreKit 2 için: Transaction nesnesi. Android için: String tanımlayıcı (satın almanın purchase.getOrderId değeri; burada purchase, billing library Purchase sınıfının bir örneğidir).
variationId	isteğe bağlı	Varyasyonun string tanımlayıcısı. Bunu AdaptyPaywall nesnesinin `variationId` özelliğini kullanarak alabilirsiniz.

İşlemleri raporlama Mobil Kodda Satın Almaları Geri Yükle sayfasında açıklandığı gibi, Observer Mode’da bir işlemi Adapty’e bildirmek için restorePurchases kullanın.

Warning

İşlem bildirmeyi atlama! restorePurchases çağırmazsanız, Adapty işlemi tanımaz, işlem analizlerde görünmez ve integrasyonlara gönderilmez.

Flow’ları ve paywallları işlemlerle ilişkilendirme

Adapty SDK, satın almaların kaynağını belirleyemez; çünkü bunları işleyen sizsiniz. Bu nedenle, Observer modunda flow’lar, paywall’lar ve/veya A/B testleri kullanmayı planlıyorsanız, uygulama mağazanızdan gelen işlemi (transaction) mobil uygulama kodunuzda ilgili flow veya paywall ile ilişkilendirmeniz gerekir. Uygulamanızı yayınlamadan önce bunu doğru şekilde yapmanız önemlidir; aksi takdirde analizlerde hatalara yol açar.

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

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