Skip to content

Add trackCustomPaywallImpression API with offeringId override#725

Merged
rickvdl merged 7 commits into
mainfrom
rickvdl/track-custom-paywall-impression-experimental-api
Mar 18, 2026
Merged

Add trackCustomPaywallImpression API with offeringId override#725
rickvdl merged 7 commits into
mainfrom
rickvdl/track-custom-paywall-impression-experimental-api

Conversation

@rickvdl

@rickvdl rickvdl commented Mar 12, 2026

Copy link
Copy Markdown
Member

Summary

  • Expose trackCustomPaywallImpression as a public API in Capacitor
  • Support optional paywallId and offeringId parameters via TrackCustomPaywallImpressionOptions
  • If offeringId is not provided, the SDK uses the current offering identifier from the cache
  • Add prompt-based UI in purchase tester for testing with custom paywall and offering IDs

Changes

  • TypeScript: TrackCustomPaywallImpressionOptions with paywallId and offeringId in definitions.ts
  • iOS bridge: trackCustomPaywallImpression in PurchasesPlugin.swift
  • Android bridge: trackCustomPaywallImpression in PurchasesPlugin.kt
  • Web: Mock implementation in web.ts
  • Purchase tester: Prompt-based UI for entering paywall ID and offering ID

Related PRs

@tonidero tonidero left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a thought I have about trying to avoid including parsing logic in this layer if possible, so it's simpler to parse things later with logic in just PHC. Lmk what you think!

Comment thread src/definitions.ts Outdated
Comment thread ios/Sources/RevenuecatPurchasesCapacitor/PurchasesPlugin.swift Outdated
Comment thread android/src/main/java/com/revenuecat/purchases/capacitor/PurchasesPlugin.kt Outdated
Comment thread src/definitions.ts Outdated

@tonidero tonidero left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good! Looks like we might need a PHC bump for the README to be udpated... But not a blocker IMO. It would get updated anyway after a bump I think

Comment thread README.md
rickvdl added a commit to RevenueCat/purchases-unity that referenced this pull request Mar 17, 2026
## Summary
- Add `trackCustomPaywallImpression` API to the Unity SDK, wiring
through the existing hybrid-common bridge on both iOS and Android
- Introduce `CustomPaywallImpressionParams` class with an optional
`PaywallId`
- Pass `CustomPaywallImpressionParams` through the wrapper interface,
splitting into separate arguments only at the native bridge boundary
- Add a testing UI in the Subtester app's Paywall screen with an
optional paywall ID field

## Changes
- **New file:** `CustomPaywallImpressionParams.cs` — params class with
optional `PaywallId`
- **Interface:** `IPurchasesWrapper` — added
`TrackCustomPaywallImpression(CustomPaywallImpressionParams)`
- **Public API:** `Purchases.cs` — two overloads (with params,
parameterless)
- **iOS bridge:** `PurchasesWrapperiOS.cs` + `PurchasesUnityHelper.m` —
DllImport and ObjC bridge calling `[RCCommonFunctionality
trackCustomPaywallImpression:]`
- **Android bridge:** `PurchasesWrapperAndroid.cs` +
`PurchasesWrapper.java` — CallPurchases and static method calling
`CommonKt.trackCustomPaywallImpression()`
- **No-op:** `PurchasesWrapperNoop.cs` — empty stub
- **API tests:** `PurchasesAPITests.cs` — compile-time verification of
both overloads
- **Subtester:** `PaywallScreen.cs` — "Custom Paywall Events" section
with paywall ID field and button

### Related PRs
- purchases-ios: RevenueCat/purchases-ios#6427
- purchases-android:
RevenueCat/purchases-android#3199
- purchases-hybrid-common:
RevenueCat/purchases-hybrid-common#1537
- react-native-purchases:
RevenueCat/react-native-purchases#1660
- purchases-flutter:
RevenueCat/purchases-flutter#1679
- purchases-capacitor:
RevenueCat/purchases-capacitor#725

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Rick van der Linden <rick.vanderlinden@revenuecat.com>
rickvdl added a commit to RevenueCat/react-native-purchases that referenced this pull request Mar 17, 2026
## Summary
- Add `trackCustomPaywallImpression` API to React Native, enabling
developers to track impressions of custom (non-RevenueCat) paywalls for
analytics
- Add purchase tester demo screen for testing custom paywall impressions

## Changes
- **iOS bridge:** `RCT_EXPORT_METHOD(trackCustomPaywallImpression:)` in
`RNPurchases.m`
- **Android bridge:** `@ReactMethod trackCustomPaywallImpression` in
`RNPurchasesModule.java`
- **TypeScript:** `Purchases.trackCustomPaywallImpression()` in
`purchases.ts` with optional `paywallId` parameter
- **Purchase tester:** Added a demo Custom Paywall screen for testing
impressions

### Related PRs
- purchases-ios: RevenueCat/purchases-ios#6427
- purchases-android:
RevenueCat/purchases-android#3199
- purchases-hybrid-common:
RevenueCat/purchases-hybrid-common#1537
- purchases-flutter:
RevenueCat/purchases-flutter#1679
- purchases-capacitor:
RevenueCat/purchases-capacitor#725
@rickvdl rickvdl force-pushed the rickvdl/track-custom-paywall-impression-experimental-api branch from 34db143 to f753949 Compare March 18, 2026 09:44
@rickvdl rickvdl changed the title Add experimental trackCustomPaywallImpression API Add trackCustomPaywallImpression API with offeringId override Mar 18, 2026
@rickvdl rickvdl merged commit b627157 into main Mar 18, 2026
9 checks passed
@rickvdl rickvdl deleted the rickvdl/track-custom-paywall-impression-experimental-api branch March 18, 2026 10:40
rickvdl added a commit to RevenueCat/purchases-flutter that referenced this pull request Mar 18, 2026
## Summary
- Expose `trackCustomPaywallImpression` as a public API in Flutter
- Support optional `paywallId` and `offeringId` parameters via
`CustomPaywallImpressionParams`
- If `offeringId` is not provided, the SDK uses the current offering
identifier from the cache
- Pass full arguments dictionary to PHC on both iOS and Android instead
of unpacking individual fields
- Add purchase tester screen with text fields for paywall ID and
offering ID

## Changes
- **Dart:** `CustomPaywallImpressionParams` with `paywallId` and
`offeringId`
- **iOS bridge:** Pass arguments dictionary directly to
`[RCCommonFunctionality trackCustomPaywallImpression:]`
- **Android bridge:** Pass arguments map directly to
`CommonKt.trackCustomPaywallImpression()`
- **Tests:** Unit tests for all parameter combinations
- **API tester:** Compile-time verification of all API shapes
- **Purchase tester:** Screen with text fields for paywall ID and
offering ID

### Related PRs
- purchases-hybrid-common:
RevenueCat/purchases-hybrid-common#1565
- react-native-purchases:
RevenueCat/react-native-purchases#1679
- purchases-unity:
RevenueCat/purchases-unity#869
- purchases-capacitor:
RevenueCat/purchases-capacitor#725
This was referenced Mar 18, 2026
facumenzella pushed a commit that referenced this pull request Mar 19, 2026
**This is an automatic release.**

## RevenueCat SDK
### ✨ New Features
* Add platform-specific PaywallPresentationConfiguration to
purchases-capacitor-ui (#730) via Jeffrey Bunn (@Jethro87)
* Add trackCustomPaywallImpression API with offeringId override (#725)
via Rick (@rickvdl)
### 📦 Dependency Updates
* [AUTOMATIC BUMP] Updates purchases-hybrid-common to 17.52.0 (#732) via
RevenueCat Git Bot (@RCGitBot)
* [Android
9.26.1](https://github.com/RevenueCat/purchases-android/releases/tag/9.26.1)
* [Android
9.26.0](https://github.com/RevenueCat/purchases-android/releases/tag/9.26.0)
* [iOS
5.65.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.65.0)
* [iOS
5.64.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.64.0)
* Updates purchases-hybrid-common to 17.51.1 (#729) via RevenueCat Git
Bot (@RCGitBot)
* [Android
9.26.1](https://github.com/RevenueCat/purchases-android/releases/tag/9.26.1)
* [Android
9.26.0](https://github.com/RevenueCat/purchases-android/releases/tag/9.26.0)
* [iOS
5.65.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.65.0)
* [iOS
5.64.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.64.0)
* [AUTOMATIC BUMP] Updates purchases-hybrid-common to 17.49.0 (#724) via
RevenueCat Git Bot (@RCGitBot)
* [Android
9.26.1](https://github.com/RevenueCat/purchases-android/releases/tag/9.26.1)
* [Android
9.26.0](https://github.com/RevenueCat/purchases-android/releases/tag/9.26.0)
* [iOS
5.65.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.65.0)
* [iOS
5.64.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.64.0)
* [AUTOMATIC BUMP] Updates purchases-hybrid-common to 17.48.0 (#722) via
RevenueCat Git Bot (@RCGitBot)
* [Android
9.26.1](https://github.com/RevenueCat/purchases-android/releases/tag/9.26.1)
* [Android
9.26.0](https://github.com/RevenueCat/purchases-android/releases/tag/9.26.0)
* [iOS
5.65.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.65.0)
* [iOS
5.64.0](https://github.com/RevenueCat/purchases-ios/releases/tag/5.64.0)

## RevenueCatUI SDK
### Paywallv2
#### ✨ New Features
* Add customVariables support to purchases-capacitor-ui (#734) via
Facundo Menzella (@facumenzella)

### 🔄 Other Changes
* Add docs for new Paywall presentation APIs (#733) via Toni Rico
(@tonidero)
* Bump fastlane-plugin-revenuecat_internal from `3e8c384` to `9a6911b`
(#731) via dependabot[bot] (@dependabot[bot])
* Add api-extractor for public API surface tracking (#723) via Rick
(@rickvdl)
* Bump fastlane-plugin-revenuecat_internal from `e146447` to `3e8c384`
(#726) via dependabot[bot] (@dependabot[bot])
* Add Galaxy to the README (#721) via Will Taylor (@fire-at-will)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants