galaxypop-admob-unity-adapter
v0.1.0
Published
Unity AdMob iOS mediation adapter with a native contextual-only privacy configuration route (Galaxy Pop).
Maintainers
Readme
galaxypop-admob-unity-adapter
October 18 publication approval
Craig explicitly approved public publication of version 0.1.0 under the verified owner account craigmgauthier on October 18, 2026. The package targets only the official npm registry. License remains UNLICENSED (owner rights reserved), not MIT or another redistribution grant. Public availability is not a native-build or device-test acceptance claim. Verify registry integrity after publication.
Preparation package output belongs under
E:\Apps\Galaxy-Staging\npm-prep-20261017, never C: or inside the app ZIP.
The actual package allowlist is package.json, README.md, plugin.xml,
www/privacy.js and src/ios/GalaxyAdPrivacy.swift. No game assets, ad IDs,
credentials, certificates, profiles or private builder settings belong here.
Mandatory dependency order
The host must install [email protected]
BEFORE this adapter. Inspection of that exact registry tarball confirms its
Cordova plugin ID is admob-plus-cordova, with the same patched version,
and its GMA pod constraint is ~> 12.3. That is why the dependency ID in
plugin.xml differs from the npm fork name. The dependency is now exact-version
pinned so a missing patched host cannot silently select upstream's older release.
Do not install upstream admob-plus-cordova as a substitute. Cordova 12 / iOS 8
create, ordered plugin install and prepare passed on Windows. CocoaPods resolve,
Swift compilation and physical iOS tests remain release gates.
Local preparation and publication boundary
From this plugin directory, with output/cache on E:, run:
npm pack --ignore-scripts --pack-destination E:\Apps\Galaxy-Staging\npm-prep-20261017 --cache E:\Apps\Galaxy-Staging\npm-cacheRun node --test scripts/test-ios-adapter-npm.cjs from the Galaxy repository.
Inspect the tarball's exact file list and hash. Before requesting publication
approval: identify the owner-controlled npm account, confirm registry name is
available/owned and the intended source visibility/rights; never print tokens.
Do not log in, create an account or publish under an assumed identity.
Only after approval remove the private lock, regenerate/recheck the final
tarball, publish that approved artifact, and verify registry version/integrity.
If approval changes any packaged metadata, earlier preparation hashes are stale.
Only AFTER registry verification may the real adapter pin enter config.xml and the iOS revenue gate be enabled. Native pod resolution, Swift compilation, SKAdNetwork IDs, consent behavior and physical iOS tests are still gates. Packing/tests are not an iOS compile or ad-delivery claim. The current unsigned build5 app ZIP intentionally remains unchanged and does not include this plugin.
This adds GoogleMobileAdsMediationUnity 4.16.5.0 and the native
GalaxyAdPrivacy.configure() route. The route commits restrictive
gdpr.consent=false and privacy.consent=false metadata before GMA starts.
Unity remains an AdMob ad source only; this never initializes Unity or
creates another ad UI. Both ad formats use npa=1 in the Cordova bridge.
The bridge fails closed if this native route is absent or fails. The pinned older iOS adapter does not automatically forward GDPR or under-age treatment; GMA/UMP receive the age flag separately. Inspect actual requests on an iPhone before enabling revenue. No native iOS build or device pass is claimed.
Why it is not in Cordova/config.xml yet
- No npm Cordova plugin ships the Unity iOS adapter. For example,
community-cordova-plugin-admob-mediation1.1.0 covers only Meta, Liftoff (Vungle) and AppLovin. - VoltBuilder resolves third-party plugins from npm. Git, local-folder and
plugins/sources require its Enterprise plan.
To enable (Craig)
- Decide the publish route:
- remove
"private": true, choose a licence, andnpm publishfrom this folder under an account you control; or - use VoltBuilder Enterprise local plugins.
- remove
- Add the following to
Cordova/config.xml, aftergdevelop-cordova-admob-plus:<plugin name="galaxypop-admob-unity-adapter" spec="0.1.0" /> - Add Unity's current SKAdNetwork identifiers from Unity's and Google's mediation documentation. admob-plus injects Google's list only.
- In AdMob, add Unity Ads (Game ID and placements) to the Galaxy Pop iOS mediation groups. In Unity, disable any direct-integration monetization.
- Build on VoltBuilder. Confirm in the build log that CocoaPods resolved
GoogleMobileAdsMediationUnity (4.16.5.0)alongsideGoogle-Mobile-Ads-SDK (12.x). Then use the AdMob Ad Inspector on a registered test device to confirm the Unity adapter initializes.
Do not pick a newer adapter unless the Google Mobile Ads pod pinned by admob-plus moves to 13.x as well. Adapters 4.16.6.1 and later require GMA ~> 13.0.
