cordova-plugin-metkasu-admob
v0.1.1
Published
Fail-closed Android Next-Gen AdMob bridge with UMP and a two-ad rewarded preload buffer
Maintainers
Readme
0.1.1: Production is supported with explicit valid IDs and release configuration, as requested by the owner. UI visibility is separate. The older hard production lock described below is superseded. METKASU_ADMOB_APP_ID has a default and can be overridden at Cordova installation; it is not a secret.
cordova-plugin-metkasu-admob 0.1.1
Reusable Android Cordova advertising bridge. Default is DISABLED. No native onload initialization and no advertising timers. This version permits TEST only, on a debuggable application or a separate application ID ending .adstest. PRODUCTION is rejected even if JavaScript requests it. There is no date-based reactivation.
SDK and installation
- Google Mobile Ads Next-Gen
com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0. - Google UMP
com.google.android.ump:user-messaging-platform:4.0.0. - Cordova Android >=13, minSdk >=24, compileSdk >=35; actual transitive dependencies may require a higher compileSdk in your cloud environment.
- Google Maven + Maven Central only. No JitPack or jcenter.
Do not install alongside admob-plus-cordova or another legacy Mobile Ads plugin. Installation and Gradle guards reject common old plugins and play-services-ads / play-services-ads-lite dependencies. They do not exclude PGS, Firebase or Billing libraries.
After approved NPM publication, use cordova plugin add [email protected]. For local install validation before publication, use the package folder. GDevelop integration declares a pinned Cordova dependency in an events extension and includes the JS controller/facade in that extension. See the parent integration directory for generated projects and validation reports.
API
// Development application only. Never set this in the Play production game.
MetkasuAdMob.listen(event => console.log(event.type, event.state));
const init = await MetkasuAdMob.call('initialize', { mode: 'TEST', testDeviceIds: [] });
if (init.state !== 'DISABLED' && init.state !== 'ERROR') {
await MetkasuAdMob.call('preload', { format: 'rewarded' });
}
// ONLY in response to an explicit player action; do not call from preload callbacks.
await MetkasuAdMob.call('show', {
format: 'rewarded', requestId: 'unique-per-attempt',
scene: 'unique-scene-instance', placement: 'daily-2x'
});Actions: initialize, preload, show, status, hideBanner, privacyOptions, disable. Formats: rewarded, interstitial, banner. Events: state, reward, dismiss, showfail. States: DISABLED / INITIALIZING / LOADING / READY / SHOWING / UNAVAILABLE / ERROR. MetkasuAdMobController.createController(config, nativeInvoker) supplies the higher-level gates and once-only JS reward consumption.
All IDs used by this native release are Google's demo IDs; JavaScript cannot replace them with production IDs. Test device IDs are supported in request configuration, not logged. Advertising IDs, user details and SDK response data are not sent to application logs. SDK internal logs remain SDK-owned.
Consent and cache
UMP requests a consent-information update each initialization, then shows the required consent form. canRequestAds() must pass before SDK initialization or any ad operation. Mobile Ads initializes on a background executor. If UMP fails and cannot authorize requests, initialization returns DISABLED; this plugin never assumes that the game's welcome/privacy acknowledgment is advertising consent. Sample app ID must also appear in the UMP manifest metadata. A test-device UMP error/no consent can prevent demo loading; diagnose this on a device without bypassing the gate.
If privacyOptionsRequired is returned, the host must expose privacyOptions; the supplied GDevelop facade adds an entry while Settings is open. Changing choices disables preloading until a new initialization/app session; no silent restart is attempted.
Rewarded preloading calls RewardedAdPreloader.start once with new PreloadConfiguration(request, 2). This constructor was checked in the published 1.6.0 AAR. pollAd is called only for a player show request; the SDK owns replenishment, retries and expiration. No application loop restarts preload from callbacks. Two is a target capacity, not a guarantee of two available ads. Rewarded and interstitial ready-state checks do not remove cached ads. The SDK's app-wide preload limit still applies.
Banner preload does not display the banner. Explicit display reserves WebView bottom margin so the banner does not cover game controls; if margin reservation is unsupported, display returns UNAVAILABLE. Hide/pause restores the original margin. Placement still requires real-device screen validation.
Reward safety
Only the native earned-reward callback emits reward. Native atomic receipt and the JS request ID prevent duplicates. Scene instance + placement are echoed and checked; stale scene rewards are discarded. Dismiss and show failure do not award. The SDK cannot credit the game's economy by itself; only the game's existing validated reward flow can do so. Client receipts do not provide server-side fraud-proof currency verification.
Verification status
npm test uses simulated SDK events, including five consecutive rewards. No live advertising is requested by tests. Java sources were compiled separately with ECJ/Java 17 against the actual Next-Gen 1.6.0, UMP 4.0.0 and Cordova 13 artifacts. This is not a full Android Gradle/AAB build, a dependency-tree resolution test, an emulator test or a real ad-show test. GDevelop cloud Android build and actual consent/reward/cache behavior remain unverified. Do not describe this package as production-verified.
NPM publication requires owner approval. This source package has not been published by this task. The ads-off 1.6.5 game intentionally does not require this unpublished native package, so publication does not block its export.
