# SkillPatch skill: google-mobile-ads-interstitial This skill provides step-by-step guidance for implementing Google Mobile Ads (GMA) SDK interstitial ads in Android and iOS mobile applications. It covers ad placement guidelines, a structured workflow for loading, registering callbacks, and showing ads, and references platform-specific implementation guides. It explicitly excludes rewarded interstitial ads. You (the agent) were given this URL and asked to use this skill. This is a **public** skill — no SkillPatch account, API key, or prior setup is required. Two ways to use it: **1. Use it right now** — the skill's complete file tree (SKILL.md + all reference files) is inlined below; read `SKILL.md` first, then follow it, consulting the other files as it directs. **2. Install the exact package onto disk** (recommended if you can run a shell — this reproduces the skill byte-for-byte, including any binary assets that can't be inlined): ```bash mkdir -p .claude/skills/google-mobile-ads-interstitial curl -sSL https://skillpatch.dev/install_skill/google-mobile-ads-interstitial | tar -xz -C .claude/skills/ ``` (`.claude/skills/` is Claude Code's convention; use whatever directory your agent loads skills from.) --- ## Skill files (3) - `SKILL.md` - `references/android-interstitial.md` - `references/ios-interstitial.md` ### `SKILL.md` ```markdown --- name: google-mobile-ads-interstitial description: Provides instructions for implementing, integrating, or configuring Google Mobile Ads (GMA) SDK interstitial ads in Android and iOS mobile applications. Use this skill when the task involves setting up interstitial ads. Don't use for "rewarded interstitial" ads. metadata: version: 1.0.0 category: GoogleAds --- # Google Mobile Ads SDK - Interstitial Ads Interstitial ads show full-page ads for users on mobile apps. Interstitial ads are designed to be placed between content and are best placed at natural app transition points. ### Ad Placement Guidelines **CRITICAL:** You MUST evaluate and apply the following Ad Placement Guidelines before proceeding with any interstitial ad implementation. * **Determine Ad Placement**: * [ ] **Identify the target file** where the ad should be placed. Ask if unsure. ## Workflow 1. **Determine the user's platform**: Identify if the project is Android or iOS. If unclear, ask before proceeding. 2. **Read the platform guide** for implementation details: - Android: `references/android-interstitial.md` - iOS: `references/ios-interstitial.md` 3. **Follow these steps in order**: - [ ] Load the ad - [ ] Register for ad event callbacks - [ ] Show the ad - [ ] Verify the implementation ``` ### `references/android-interstitial.md` ````markdown # AI Integration Agent Instructions for Interstitial Ads ## Required Imports Use the following imports to implement an interstitial ad: ``` import com.google.android.libraries.ads.mobile.sdk.common.AdRequest import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAd import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAdEventCallback ``` ## Method Signatures Use the following method signatures to implement interstitial ads: The `AdRequest` object takes the ad unit ID: ``` AdRequest.Builder(adUnitId: String).build() ``` The method signature to load an ad from `InterstitialAd`: ``` fun load( adRequest: AdRequest, adLoadCallback: AdLoadCallback ): Unit ``` The `AdLoadCallback` interface is defined as: ``` interface AdLoadCallback { fun onAdLoaded(ad: T): Unit fun onAdFailedToLoad(adError: LoadAdError): Unit } ``` ## Gotchas **UI Threading**: **MANDATORY**: Callbacks in GMA-Next Gen SDK are invoked on a background thread. **ALL UI-RELATED OPERATIONS** (e.g., Toasts, View updates, Fragment transactions) **MUST** be wrapped in `runOnUiThread {}` or `Dispatchers.Main.launch {}` within GMA SDK callbacks. SKIPPING THIS STEP WILL CAUSE THE APPLICATION TO CRASH. ## Interstitial ad workflow 1. **Load the ad** 2. **Register for ad event callbacks** - [ ] Set the `adEventCallback` on the `InterstitialAd` object. * Drop the reference to the interstitial ad when the ad is dismissed or fails to show. 3. **Show the ad** 4. **Verify the implementation**: Verify the build to ensure there are no compile errors: - [ ] Run `gradle build -x test` to confirm a successful clean build. Resolve any GMA SDK related compile errors. #### Troubleshooting **ONLY** if you exhaust your internal knowledge and not able to complete the workflow steps, read https://developers.google.com/admob/android/next-gen/interstitial.md.txt and try again. ```` ### `references/ios-interstitial.md` ```markdown # AI Integration Agent Instructions for Interstitial Ads ## Gotchas Google Mobile Ads SDK uses `NS_SWIFT_NAME` macros to provide idiomatic Swift names. ## Interstitial ad workflow 1. **Load the ad** * For Swift code, use `async/await` instead of a completion handler. 2. **Register for ad event callbacks** - [ ] Set the `fullScreenContentDelegate` on the `InterstitialAd` object. * Drop the reference to the interstitial ad when the ad is dismissed or fails to show. 3. **Show the ad** * **ViewController Parameter:** The `rootViewController` parameter in the `present(from:)` method is an optional parameter and can be set to `nil`. 4. **Verify the implementation**: Verify the build to ensure there are no compile errors: - **If `xcodebuild` is available**: Run `xcodebuild` to programmatically verify that the iOS project compiles properly with the GMA SDK. Resolve any GMA-SDK related compile errors. - **If `xcodebuild` is NOT available**: Output instructions directing the user to build the project in Xcode and manually verify there are no compile errors. #### Troubleshooting **ONLY** if you exhaust your internal knowledge and not able to complete the workflow steps, read https://developers.google.com/admob/ios/interstitial.md.txt and try again. ```