StoreKit 2 on iOS: What is the Flutter Equivalent of Analytics.logTransaction for Manually Logging in_app_purchase Events?

[ibrahimdevs]

Hi everyone,
I’m working on correctly logging in_app_purchase events on iOS when using StoreKit 2, and I would like to clarify which FlutterFire API corresponds to the native Firebase Analytics call.

---

Background

According to the Firebase documentation:

https://firebase.google.com/docs/analytics/measure-in-app-purchases#implementation-apple

When using StoreKit 2, the in_app_purchase event is not automatically logged. Firebase provides the following native API for manually logging the purchase:

// Call this Firebase API to log the in-app purchase event.
Analytics.logTransaction(transaction)

This makes sense, because on StoreKit 2 the SDK no longer receives automatic transaction updates.

---

Question: What is the Flutter equivalent of Analytics.logTransaction?

I noticed this recent PR in FlutterFire:
#17851

It introduces a new method:

logInAppPurchase(...)

However, the documentation comment included in the PR raises a bit of confusion:

/// This is especially useful in cases where purchases happen outside the native
/// billing systems (e.g. custom payment flows).

This wording makes it sound similar to the manual logging method described in:

https://firebase.google.com/docs/analytics/webview?platform=ios#log_in-app_purchase_events_manually_in_a_webview_on_ios

—which is specifically designed for WebView or non-native billing flows.

---

Main Question

Is logInAppPurchase() the Flutter equivalent of Analytics.logTransaction(transaction) for StoreKit 2 on iOS?

In our case:

• We handle all our in-app purchase flows using the adapty_flutter package:
  https://pub.dev/packages/adapty_flutter
  So purchases do run entirely through native StoreKit 2, not through WebView, external billing, or custom payment flows.

• We just need to manually log the in_app_purchase event because StoreKit 2 no longer sends it automatically.

So what I need to confirm is:

👉 Should Flutter apps using StoreKit 2 manually log the event using logInAppPurchase()?
Is this the intended equivalent of:

Analytics.logTransaction(transaction)

Or is another API planned for this specific StoreKit 2 use case?

---

Thanks!

This clarification is important for correct subscription and purchase reporting on Firebase Analytics (and for downstream integrations like Google Ads), so any confirmation would be greatly appreciated.
@russellwheatley @Lyokone @SelaseKay @Ehesp

[SelaseKay]

Hi @ibrahimdevs, sorry for the delayed response. You're correct that logInAppPurchase() is intended for logging transactions that occur in WebView or other non-native billing flows. I'll update the documentation to make this clearer and help avoid future confusion. There’s an open PR that adds support for logging StoreKit 2 transactions: #17995. I believe this is the functionality you're referring to. In the meantime, you can test it by using the PR branch until it’s officially released.

[ibrahimdevs]

Thank you, @SelaseKay! I'm really glad to see that this PR has just been merged. This feature is incredibly important for advertisers. We have been waiting for it for a long time, as we haven't been able to start our ad campaigns on the iOS side without it. So, this is really great news! I hope the new version including this PR will be released very soon. Thanks again! 🙌