Как создать демонстрационный скрипт Google Mobile Ads в Unity: пошаговое руководство на русском языке

using UnityEngine;
using GoogleMobileAds.Api;

public class AdManager : MonoBehaviour
{
    // Идентификатор вашего тестового приложения AdMob.
    // Для Android: ca-app-pub-3940256099942544~3347511713
    // Для iOS: ca-app-pub-3940256099942544~1458002511
    private string _appUnitId = "ca-app-pub-3940256099942544~3347511713"; // Используем тестовый ID для Android

    public void Start()
    {
        // Инициализация Google Mobile Ads SDK.
        // Это асинхронная операция, которую следует выполнить один раз при запуске приложения.
        MobileAds.Initialize(initStatus =>
        {
            // Получение информации о статусе инициализации по каждой адаптерной сети.
            var map = initStatus.getAdapterStatusMap();

            // Пример обработки статуса: просто выводим в лог статус для всех адаптеров.
            foreach (var adapterStatusPair in map)
            {
                string adapterClassName = adapterStatusPair.Key;
                var adapterStatus = adapterStatusPair.Value;
                Debug.LogFormat("Adapter name: {0}, State: {1}, Description: {2}",
                    adapterClassName,
                    adapterStatus.InitializationState,
                    adapterStatus.Description);
            }

            // SDK успешно инициализирован.
            Debug.Log("Google Mobile Ads SDK успешно инициализирован.");

            // Теперь можно безопасно загружать рекламу.
            // Пример: LoadBannerAd();
        });
    }

    // Другие методы для загрузки и показа рекламы будут добавлены здесь...
}

using UnityEngine;
using GoogleMobileAds.Api;

// ... (остальная часть класса AdDisplayManager)

public class AdDisplayManager : MonoBehaviour
{
    private BannerView _bannerView;
    private string _bannerAdUnitId = "ca-app-pub-3940256099942544/6300978111"; // Тестовый ID баннера

    public void LoadBannerAd()
    {
        // Если баннер уже создан, уничтожаем его перед созданием нового.
        if (_bannerView != null)
        {
            _bannerView.Destroy();
        }

        // Создание нового экземпляра BannerView.
        // Размер баннера: AdSize.Banner (320x50) - стандартный размер.
        // Позиция: AdPosition.Bottom - размещение внизу экрана.
        _bannerView = new BannerView(_bannerAdUnitId, AdSize.Banner, AdPosition.Bottom);

        // Подписка на события баннера. Это позволяет отслеживать жизненный цикл рекламы
        // и реагировать на действия пользователя (например, клики, закрытие).
        // Эти события могут быть важны для аналитики, подобно отслеживанию конверсий в веб-маркетинге.
        ListenToBannerEvents();

        // Создание запроса на рекламу.
        AdRequest request = new AdRequest.Builder().Build();

        // Загрузка баннера.
        Debug.Log("Loading banner ad.");
        _bannerView.LoadAd(request);
    }

    private void ListenToBannerEvents()
    {
        // Вызывается при успешной загрузке баннера.
        _bannerView.OnBannerAdLoaded += () =>
        {
            Debug.Log("Баннер успешно загружен.");
        };

        // Вызывается при ошибке загрузки баннера.
        _bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
        {
            Debug.LogErrorFormat("Ошибка загрузки баннера: {0}", error.GetMessage());
        };

        // Вызывается при открытии полноэкранного окна после клика по баннеру.
        _bannerView.OnAdFullScreenContentOpened += () =>
        {
            Debug.Log("Полноэкранный контент баннера открыт.");
        };

        // Вызывается при закрытии полноэкранного окна.
        _bannerView.OnAdFullScreenContentClosed += () =>
        {
            Debug.Log("Полноэкранный контент баннера закрыт.");
        };

        // Вызывается при изменении формата или размера баннера.
        _bannerView.OnAdImpressionRecorded += () =>
        {
            // Это событие можно использовать для регистрации показа рекламы, подобно учету показов
            // в системах веб-аналитики для расчета метрик вроде CTR.
            Debug.Log("Impression recorded for banner ad.");
        };
    }

    // Метод для скрытия баннера.
    public void HideBannerAd()
    {
        if (_bannerView != null)
        {
            _bannerView.Hide();
            Debug.Log("Баннер скрыт.");
        }
    }

    // Метод для показа баннера после скрытия.
    public void ShowBannerAd()
    {
        if (_bannerView != null)
        {
            _bannerView.Show();
            Debug.Log("Баннер показан.");
        }
    }

    // Метод для уничтожения баннера, освобождения ресурсов.
    public void DestroyBannerAd()
    {
        if (_bannerView != null)
        {
            _bannerView.Destroy();
            _bannerView = null;
            Debug.Log("Баннер уничтожен.");
        }
    }

    // ... (методы для других форматов рекламы)
}

using UnityEngine;
using GoogleMobileAds.Api;
using GoogleMobileAds.Common;

// ... (остальная часть класса AdDisplayManager)

public class AdDisplayManager : MonoBehaviour
{
    private InterstitialAd _interstitialAd;
    private string _interstitialAdUnitId = "ca-app-pub-3940256099942544/1033173712"; // Тестовый ID межстраничного объявления

    /// 

    /// Загружает межстраничное объявление.
    /// Загрузку следует выполнять заранее, до момента, когда объявление потребуется показать.
    /// 
    public void LoadInterstitialAd()
    {
        // Очищаем предыдущее объявление, если оно существует.
        if (_interstitialAd != null)
        {
            _interstitialAd.Destroy();
            _interstitialAd = null;
        }

        Debug.Log("Attempting to load interstitial ad.");

        // Создание запроса на рекламу.
        var adRequest = new AdRequest.Builder().Build();

        // Асинхронная загрузка межстраничного объявления.
        InterstitialAd.Load(_interstitialAdUnitId, adRequest,
            (InterstitialAd ad, LoadAdError error) =>
            {
                // Если возникла ошибка при загрузке.
                if (error != null || ad == null)
                {
                    Debug.LogErrorFormat("Interstitial ad failed to load with error : {0}",
                                            error != null ? error.GetMessage() : "Unknown Error");
                    return;
                }

                Debug.Log("Interstitial ad loaded successfully.");
                _interstitialAd = ad;

                // Подписка на события загруженного объявления.
                // Отслеживание этих событий позволяет контролировать поток игры
                // в зависимости от взаимодействия пользователя с рекламой.
                ListenToInterstitialEvents(ad);
            });
    }

    /// 

    /// Показывает загруженное межстраничное объявление.
    /// Следует вызывать только после успешной загрузки объявления.
    /// 
    public void ShowInterstitialAd()
    {
        if (_interstitialAd != null && _interstitialAd.CanShowAd())
        {
            Debug.Log("Showing interstitial ad.");
            _interstitialAd.Show();
        }
        else
        {
            // Если объявление не готово, возможно, его нужно загрузить заново.
            Debug.LogError("Interstitial ad is not ready yet or already shown.");
            // Опционально: вызвать LoadInterstitialAd() здесь или ранее.
        }
    }

    private void ListenToInterstitialEvents(InterstitialAd ad)
    {
        // Вызывается, когда объявление открывает полноэкранный контент.
        ad.OnAdFullScreenContentOpened += () =>
        {
            // Здесь можно, например, поставить игру на паузу.
            Debug.Log("Межстраничное объявление открыто.");
        };

        // Вызывается при сбое показа объявления.
        ad.OnAdFullScreenContentFailedToShow += (AdError error) =>
        {
            Debug.LogErrorFormat("Ошибка показа межстраничного объявления: {0}", error.GetMessage());

            // Уничтожаем объявление после сбоя, чтобы избежать повторного использования.
            ad.Destroy();
            _interstitialAd = null; // Сброс ссылки, чтобы можно было загрузить новое.
        };

        // Вызывается, когда объявление закрывает полноэкранный контент.
        ad.OnAdFullScreenContentClosed += () =>
        {
            // Здесь можно, например, возобновить игру или загрузить новое объявление.
            // После показа объявление становится недействительным и должно быть уничтожено.
            Debug.Log("Межстраничное объявление закрыто.");
            ad.Destroy();
            _interstitialAd = null; // Сброс ссылки.

            // Рекомендуется загрузить новое объявление сразу после закрытия предыдущего
            // для поддержания готовности (готовности к показу при следующем вызове ShowInterstitialAd).
            LoadInterstitialAd();
        };

        // Вызывается при записи показа объявления (аналогично Impression).
        ad.OnAdImpressionRecorded += () =>
        {
            // Фиксация показа важна для аналитики монетизации.
            Debug.Log("Impression recorded for interstitial ad.");
        };

        // Вызывается при клике по объявлению.
        ad.OnAdClicked += () =>
        {
            // Клик по объявлению может быть зарегистрирован как целевое действие
            // в системах аналитики, подобно отслеживанию кликов по рекламным баннерам на сайте.
            Debug.Log("Межстраничное объявление было кликнуто.");
        };
    }

    // ... (методы для других форматов рекламы)
}

using UnityEngine;
using GoogleMobileAds.Api;
using GoogleMobileAds.Common;

// ... (остальная часть класса AdDisplayManager)

public class AdDisplayManager : MonoBehaviour
{
    private RewardedAd _rewardedAd;
    private string _rewardedAdUnitId = "ca-app-pub-3940256099942544/5224354917"; // Тестовый ID рекламы с вознаграждением

    /// 

    /// Загружает рекламу с вознаграждением.
    /// Как и межстраничные объявления, рекомендуется загружать заранее.
    /// 
    public void LoadRewardedAd()
    {
        // Очищаем предыдущее объявление, если оно существует.
        if (_rewardedAd != null)
        {
            _rewardedAd.Destroy();
            _rewardedAd = null;
        }

        Debug.Log("Attempting to load rewarded ad.");

        // Создание запроса на рекламу.
        var adRequest = new AdRequest.Builder().Build();

        // Асинхронная загрузка рекламы с вознаграждением.
        RewardedAd.Load(_rewardedAdUnitId, adRequest,
            (RewardedAd ad, LoadAdError error) =>
            {
                // Если возникла ошибка при загрузке.
                if (error != null || ad == null)
                {
                    Debug.LogErrorFormat("Rewarded ad failed to load with error : {0}",
                                            error != null ? error.GetMessage() : "Unknown Error");
                    return;
                }

                Debug.Log("Rewarded ad loaded successfully.");
                _rewardedAd = ad;

                // Подписка на события загруженного объявления.
                ListenToRewardedEvents(ad);
            });
    }

    /// 

    /// Показывает загруженную рекламу с вознаграждением.
    /// Следует вызывать только после успешной загрузки объявления.
    /// 
    public void ShowRewardedAd()
    {
        if (_rewardedAd != null && _rewardedAd.CanShowAd())
        {
            // Подписка на событие получения вознаграждения перед показом.
            // Это событие критически важно для выдачи вознаграждения пользователю.
            _rewardedAd.Show((RewardItem rewardItem) =>
            {
                // Пользователь успешно просмотрел рекламу и получил вознаграждение.
                // Здесь должна быть ваша игровая логика выдачи вознаграждения.
                // RewardItem содержит тип и количество вознаграждения, определенные в AdMob.
                Debug.LogFormat("User rewarded with type {0}, amount {1}.",
                                rewardItem.Type, rewardItem.Amount);

                // Пример: увеличение количества виртуальной валюты пользователя.
                GrantRewardToUser((int)rewardItem.Amount); // Приводим к int, если количество целочисленное
            });
        }
        else
        {
            Debug.LogError("Rewarded ad is not ready yet or already shown.");
            // Опционально: вызвать LoadRewardedAd() здесь или ранее.
        }
    }

    /// 

    /// Пример функции для выдачи вознаграждения пользователю.
    /// Реальная логика зависит от вашей игры (например, обновление UI, сохранение данных).
    /// 
    private void GrantRewardToUser(int amount)
    {
        // Здесь реализуйте логику выдачи вознаграждения.
        // Например, добавьте amount к текущему счету монет игрока.
        Debug.Log($"Выдано вознаграждение пользователю: {amount}");
        // GameManager.Instance.AddCoins(amount);
    }

    private void ListenToRewardedEvents(RewardedAd ad)
    {
        // Вызывается, когда объявление открывает полноэкранный контент.
        ad.OnAdFullScreenContentOpened += () =>
        {
            Debug.Log("Реклама с вознаграждением открыта.");
        };

        // Вызывается при сбое показа объявления.
        ad.OnAdFullScreenContentFailedToShow += (AdError error) =>
        {
            Debug.LogErrorFormat("Ошибка показа рекламы с вознаграждением: {0}", error.GetMessage());
            ad.Destroy();
            _rewardedAd = null;
        };

        // Вызывается, когда объявление закрывает полноэкранный контент.
        ad.OnAdFullScreenContentClosed += () =>
        {
            // Важно! Вознаграждение выдается в событии Show, а не здесь.
            Debug.Log("Реклама с вознаграждением закрыта.");
            ad.Destroy();
            _rewardedAd = null;

            // Рекомендуется загрузить новое объявление сразу после закрытия предыдущего.
            LoadRewardedAd();
        };

        // Вызывается при записи показа объявления (аналогично Impression).
        ad.OnAdImpressionRecorded += () =>
        {
            Debug.Log("Impression recorded for rewarded ad.");
        };

        // Вызывается при клике по объявлению.
        ad.OnAdClicked += () =>
        {
            Debug.Log("Реклама с вознаграждением была кликнута.");
        };
    }
}