AdMob
AdMob cocos guide for Custom Adapter (GMA SDK).
Prerequisites
Performed by: Developer
- See the Compatibility Matrix for the minimum Android and iOS versions for this package.
Install the SDK
Performed by: Developer
Install the TapMind AdMob extension:
- Extension → Extension Manager → Install from File
- Download the TapMind extension ZIP: TapMind-CA-Admob-Cocos (main)
- Select the downloaded ZIP, install, then Enable the extension in the Installed tab.
Configure AdMob
Performed by: Ad ops
Create the custom event (waterfall): Mediation → Create mediation group → select Android or iOS and ad format → name it (provided by your account manager) → Add ad units → select your app and ad units.
Add the ad source: Waterfall source → Set up ad source → Custom event → select your app/platform → select the ad unit, then enter:
Android
Mapping name : provided by your account manager
eCPM : provided by your account manager
Class : com.tapmind.tech.TapMindMediationAdapterAdmob
Parameter : {"placementName": "provided by your account manager"}
iOS
Mapping name : provided by your account manager
eCPM : provided by your account manager
Class : TapMindMediationAdapterAdmob
Parameter : {"placementName": "provided by your account manager"}
The placementName value is case-sensitive and must exactly match the Placement Name configured in the TapMind Dashboard.
Note: Official Google documentation: Create a custom event
Verify integration
Performed by: Developer
After install and dashboard configuration:
- Run your app in a debug build. TapMind's test mode is enabled automatically in debug builds and serves test ads at a high fill rate.
- Request an ad through your mediation SDK as you normally would.
- Confirm a TapMind ad fills. Check logs for the tag
TapMindAdapter. - When verified, build in release mode for production - test mode is disabled automatically in release builds, and live ads serve.
Note: Test mode is automatic. It follows your build type: debug = test ads, release = live ads. There is no flag to enable or disable, and nothing to turn off before going live.
Release build QA: There is currently no documented release-safe test path to validate R8/ProGuard without serving live ads. Consumer ProGuard rules from the TapMind AAR are applied automatically when you integrate the published adapter packages.
Troubleshooting
Performed by: Developer
Before diving into logs, confirm adapter class names and the LevelPlay network key against the Class & Network Key Registry, and placementName and eCPM/rate with your account manager.
See Troubleshooting for common symptoms, mediation-specific fixes, release vs debug guidance, and escalation steps. Partner-specific verification steps are under Verify integration above.
