---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.2
alternate:
  - https://ads.yandex.com/helpcenter/en/easy/integration/flutter/formats/interstitial.md
  - https://ads.yandex.com/helpcenter/ru/easy/integration/flutter/formats/interstitial.md
  - https://ads.yandex.com/helpcenter/zh/easy/integration/flutter/formats/interstitial.md
  - href: en/easy/integration/flutter/formats/interstitial.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/en/llms.txt

# Interstitial ads

<!-- source: en/easy/_includes/sdk-guide.md -->
A fullscreen ad format, interstitial ads are integrated in the app content at natural breaks, such as when the user transitions to the next game level or completes a conversion action.
<!-- endsource: en/easy/_includes/sdk-guide.md -->

<!-- source: en/easy/_includes/notes-flutter-easy-guide.md -->
{% note info %}

Examples showing how all the format types work are available in the [demo project](https://ads.yandex.com/helpcenter/en/easy/integration/flutter/testing.md#demo).

{% endnote %}
<!-- endsource: en/easy/_includes/notes-flutter-easy-guide.md -->

#|
||

**Entity**

|

**Description**

||
||

`HandleAdFailedToLoad`

|

If `HandleAdFailedToLoad()` returns an error, don't attempt to load a new ad again **using the same method**.

||
||

`adUnitId`

|

Use:

- **Development mode** to work with [demo ad units](https://ads.yandex.com/helpcenter/en/easy/integration/flutter/testing.md#blocks).

- **Production mode** to work with `R-M-XXXXXX-Y` (for the actual ID, check the Yandex Advertising Network interface). `R-M-XXXXXX-Y` is a template for your actual ad unit ID that will be used to receive various creatives.

||
|#


## Example of creating an interstitial ad

```dart
import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:yandex_mobileads/mobile_ads.dart';

class InterstitialPage extends StatefulWidget {
  const InterstitialPage({super.key});

  @override
  State<InterstitialPage> createState() => _InterstitialPageState();
}

class _InterstitialPageState extends State<InterstitialPage> {
  static const _tag = 'Interstitial';
  static const _adUnitId = 'demo-interstitial-yandex';
  final InterstitialAdLoader _loader = InterstitialAdLoader();
  InterstitialAd? _ad;
  String _status = 'Initializing...';

  @override
  void initState() {
    super.initState();
    _init();
  }

  @override
  void dispose() {
    _ad?.destroy();
    super.dispose();
  }

  Future<void> _init() async {
    setState(() => _status = 'Loading ad...');
    try {
      final ad = await _loader.loadAd(
        adRequest: AdRequest(adUnitId: _adUnitId),
      );
      if (!mounted) {
        ad.destroy();
        return;
      }
      _ad = ad;
      setState(() => _status = 'Showing...');
      await _show();
    } on AdRequestError catch (error) {
      debugPrint('[$_tag] onAdFailedToLoad: ${error.description}');
      if (mounted) setState(() => _status = 'Error: ${error.description}');
    }
  }

  Future<void> _show() async {
    final ad = _ad;
    if (ad == null) return;

    ad.setAdEventListener(
      eventListener: InterstitialAdEventListener(
        onAdShown: () => debugPrint('[$_tag] onAdShown'),
        onAdDismissed: () {
          debugPrint('[$_tag] onAdDismissed');
          if (mounted) {
            setState(() => _status = 'Closed');
            Navigator.of(context).pop();
          }
        },
        onAdClicked: () => debugPrint('[$_tag] onAdClicked'),
        onAdFailedToShow: (error) {
          debugPrint('[$_tag] onAdFailedToShow: ${error.description}');
          if (mounted) setState(() => _status = 'Show error: ${error.description}');
        },
        onAdImpression: (ImpressionData impressionData) =>
            debugPrint('[$_tag] onAdImpression: $impressionData'),
      ),
    );

    await ad.show();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Interstitial')),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            const CircularProgressIndicator(),
            const SizedBox(height: 16),
            Text(_status),
          ],
        ),
      ),
    );
  }
}

```


## Checking integration

<!-- source: en/easy/_includes/notes-flutter-easy-guide.md -->
Build and run your project. You can check if the integration is successful by searching the `YandexAds` keyword in **Logcat** in **Android Studio**:
<!-- endsource: en/easy/_includes/notes-flutter-easy-guide.md -->

```
[Integration] Ad type interstitial was integrated successfully
```