feat(ads): admob adapter

[peterporfy]

Description

Adds react-native-purchases-admob, a new automatic ad tracking package covering the 3rd party react-native-google-mobile-ads package. This is the most commonly used admob package available for admob

The adsTester example changes that exercise it are in the stacked PR.

Changes

Adapter

• RevenueCatAdMob.create{Interstitial,AppOpen,Rewarded,RewardedInterstitial}Ad(adUnitId, options) creates the ad and tracks loaded, failed-to-load, displayed, opened and revenue.
• trackAd(ad, options) does the same for an ad the app created.
• showAndTrack(ad, { placement }) for show-time placement overrides.
• useTrackingBannerAdProps(...) (hook) / trackingBannerAdProps(...) for <BannerAd>, trackNativeAd(nativeAd) for native ads, impressionIdOf(ad).
• Reward verification: createRewardedAd(id, { enableRewardVerification: true }) attaches the token as SSV options at creation. The library only accepts them there. showWithRewardVerification(ad, callbacks) polls and returns a VerifiedReward.
• Events are stamped with AdCaptureMethod.reactNativeAdMobAdapter.

Example usage

import { RevenueCatAdMob, useTrackingBannerAdProps } from 'react-native-purchases-admob';

const rewarded = await RevenueCatAdMob.createRewardedAd(adUnitId, {
  placement: 'level_complete',
  enableRewardVerification: true,
});
rewarded.load();
await RevenueCatAdMob.showWithRewardVerification(rewarded, {
  onRewardVerificationCompleted: result => grant(result),
});

function HomeBanner() {
  const props = useTrackingBannerAdProps({ unitId, size: BannerAdSize.BANNER, placement: 'home_bottom' });
  return <BannerAd {...props} />;
}

Why 17.x

17.0.0 added ResponseInfo on loaded events, the IMPRESSION event, PaidEvent.valueMicros and error.reason.

The adapter needs all four. Verified on 17.0.0, 17.1.0 and 17.2.0.

The only exception is rewarded ad ssv, where we are using our custom impression id, because it is not available properly yet in the API. We might change it in the future.

Core SDK

• added an optional captureMethod so the new adapter can pass in the new capture method type

Examples

• adsTester rewritten to use the adapter in the stacked PR

Release wiring

• Fastfile: adapter in the version-bump map, fourth npm publish in release.
• CircleCI: prepare, API tests and unit tests for the adapter in analyse_js.
• Repo-wide tslint already crashes on main under TypeScript 5.4.5; not addressed.

Tests

• unit tests, api tests
• full e2e simulator test with all ad formats, against production system, both with android and ios builds, using the adsTester from the stacked PR
• full e2e for manual integration to catch regression issues

---

Note

Medium Risk
New monetization surface (ad events and server-side reward verification) with complex lifecycle edge cases, though failures are mostly logged and tracking calls are non-throwing.

Overview
Introduces react-native-purchases-admob, a new workspace package that bridges react-native-google-mobile-ads (17+) to RevenueCat’s Purchases.adTracker and reward-verification APIs.

The RevenueCatAdMob API replaces or wraps ad creation (createInterstitialAd, createAppOpenAd, async rewarded variants), attaches listeners for load/display/revenue/failure events, and forwards them with placement overrides and AdCaptureMethod.reactNativeAdMobAdapter. Banners use useTrackingBannerAdProps / trackingBannerAdProps; native ads use trackNativeAd. Optional enableRewardVerification pins a pre-request impression id, injects AdMob SSV options, blocks unsafe reloads, and showWithRewardVerification polls RevenueCat after the user earns a reward.

Core react-native-purchases gains AdCaptureMethod and an optional captureMethod on ad tracking / reward metadata types (marked @internal for official adapters).

Release and CI: the adapter is added to yarn workspaces, root publish exclusions, Jest ignore paths, CircleCI prepare/API/unit steps, and Fastlane version bumps plus a fourth npm publish in the release lane.

^{Reviewed by Cursor Bugbot for commit 567b4fb. Bugbot is set up for automated code reviews on this repo. Configure here.}

[peterporfy]

• feat(ads): use the AdMob adapter in adsTester #2033
• feat(ads): admob adapter #2023 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[cursor]

Stale Bugbot comment from a previous run.

[polmiro]

Looks good to me!

[cursor]

Stale Bugbot comment from a previous run.

[tonidero]

Looking good I think. My only main concern is whether we are not clearing ads in the kept state at all... Not sure what the best way to fix that is though... Will approve for now, since I think that it shouldn't be a huge leak... Looks great!

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 1d2639c. Configure here.}