---
name: godot-admob-interstitial
description: Provides instructions to implement, load, show, and destroy interstitial ads (full-screen image/text ads) in GDScript and C#. Use when integrating interstitial ads.
metadata:
  version: 1.0.0
  category: GodotAdMob
---
# Godot AdMob - Interstitial Ads

Assists with implementing full-screen interstitial ads using the `InterstitialAdLoader` and `InterstitialAd` classes in Godot 4.x.

## Interstitial Ads Workflow

1.  **Instantiate InterstitialAdLoader**: Set up a loader instance.
2.  **Configure InterstitialAdLoadCallback**: Define success (`on_ad_loaded`) and failure callbacks.
3.  **Load the Ad**: Call `interstitial_ad_loader.load()` passing the Ad Unit ID, `AdRequest`, and load callback.
4.  **Handle Loaded Ad**: Save the loaded `InterstitialAd` instance in success callback.
5.  **Configure FullScreenContentCallback**: Listen to show, click, dismiss, and fail-to-show events.
6.  **Show the Ad**: Call `interstitial_ad.show()` to display the ad.
7.  **Crucial: Destroy the Ad**: Call `interstitial_ad.destroy()` inside the dismissed or show failure callback to free native memory.

### Code Examples

=== "GDScript"

    ```gdscript
    var interstitial_ad: InterstitialAd
    var interstitial_loader := InterstitialAdLoader.new()

    func load_interstitial() -> void:
    	var ad_unit_id := "ca-app-pub-3940256099942544/1033173712" # Test ID
    	var callback := InterstitialAdLoadCallback.new()
    	
    	callback.on_ad_loaded = func(ad: InterstitialAd) -> void:
    		interstitial_ad = ad
    		print("Interstitial loaded. Ready to show.")
    		setup_interstitial_callbacks()
    		
    	callback.on_ad_failed_to_load = func(error: LoadAdError) -> void:
    		print("Interstitial failed to load: ", error.message)
    		
    	interstitial_loader.load(ad_unit_id, AdRequest.new(), callback)

    func setup_interstitial_callbacks() -> void:
    	if not interstitial_ad:
    		return
    	var callbacks := FullScreenContentCallback.new()
    	callbacks.on_ad_showed_full_screen_content = func() -> void:
    		print("Interstitial showed.")
    	callbacks.on_ad_dismissed_full_screen_content = func() -> void:
    		print("Interstitial dismissed.")
    		interstitial_ad.destroy()
    		interstitial_ad = null
    	callbacks.on_ad_failed_to_show_full_screen_content = func(error: AdError) -> void:
    		print("Interstitial failed to show: ", error.message)
    		interstitial_ad.destroy()
    		interstitial_ad = null
    		
    	interstitial_ad.full_screen_content_callback = callbacks

    func show_interstitial() -> void:
    	if interstitial_ad:
    		interstitial_ad.show()
    	else:
    		print("Interstitial not loaded yet.")
    ```

=== "C#"

    ```csharp
    using Godot;
    using PoingStudios.AdMob.Api;
    using PoingStudios.AdMob.Api.Listeners;
    using PoingStudios.AdMob.Api.Core;

    private InterstitialAd _interstitialAd;
    private InterstitialAdLoader _interstitialLoader = new InterstitialAdLoader();

    public void LoadInterstitial()
    {
        string adUnitId = "ca-app-pub-3940256099942544/1033173712"; // Test ID
        var callback = new InterstitialAdLoadCallback();
        
        callback.OnAdLoaded = (InterstitialAd ad) => {
            _interstitialAd = ad;
            GD.Print("Interstitial loaded. Ready to show.");
            SetupInterstitialCallbacks();
        };
        callback.OnAdFailedToLoad = (error) => {
            GD.Print($"Interstitial failed to load: {error.Message}");
        };
        
        _interstitialLoader.Load(adUnitId, new AdRequest(), callback);
    }

    private void SetupInterstitialCallbacks()
    {
        if (_interstitialAd == null) return;
        
        var callbacks = new FullScreenContentCallback();
        callbacks.OnAdShowedFullScreenContent = () => GD.Print("Interstitial showed.");
        callbacks.OnAdDismissedFullScreenContent = () => {
            GD.Print("Interstitial dismissed.");
            _interstitialAd.Destroy();
            _interstitialAd = null;
        };
        callbacks.OnAdFailedToShowFullScreenContent = (error) => {
            GD.Print($"Interstitial failed to show: {error.Message}");
            _interstitialAd.Destroy();
            _interstitialAd = null;
        };
        
        _interstitialAd.FullScreenContentCallback = callbacks;
    }

    public void ShowInterstitial()
    {
        if (_interstitialAd != null)
        {
            _interstitialAd.Show();
        }
    }
    ```