Configuration

The plugin is driven by environment variables exposed through config/nativephp-google-admob.php.

Basic setup

Add the required keys to your app .env file.

Use test mode until your integration is verified end to end.

Config reference

Key	Type	Default	Required	Description
ADMOB_APP_ID	string	Google test app id	yes (production)	Google AdMob application ID used by the Android integration.
ADMOB_BANNER_ENABLED	bool	false	no	Enables banner support in the generated Android integration. If you disable it after enabling it, run php artisan native:install --force again.
ADMOB_BANNER_AD_UNIT_ID	string	empty	yes (production banners)	Production ad unit ID for anchored adaptive banners.
ADMOB_INTERSTITIAL_AD_UNIT_ID	string	empty	yes (production interstitial)	Production ad unit ID for interstitial ads.
ADMOB_REWARDED_AD_UNIT_ID	string	empty	yes (production rewarded)	Production ad unit ID for rewarded ads.
ADMOB_TEST_MODE	bool	true	no	Uses Google official demo ad unit IDs instead of production IDs when enabled.

Important banner note

If you turn banners off by setting ADMOB_BANNER_ENABLED=false, rerun:

php artisan native:install --force

That ensures generated native files are rebuilt consistently.

Test mode behavior

When ADMOB_TEST_MODE=true, the plugin always uses Google's official demo ad unit IDs instead of your production IDs. To keep you compliant with AdMob's policy - there is no way to use your own IDs in test mode. This ensures you won't accidentally click on real ads during development and testing.

You don't need to have test device IDs configured for test mode to work.

No credentials are required to use the plugin in test mode.