Объявления при запуске приложения

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

Объявления при запуске приложения – это особый формат объявления, предназначенный для издателей, которые хотят монетизировать экраны загрузки своих приложений. Объявления при запуске приложения можно закрыть в любой момент. Они показываются, когда пользователь открывает приложение.

В объявлениях при запуске приложения автоматически показывается небольшая область с брендингом, чтобы пользователи знали, что они находятся в вашем приложении. Вот пример такого объявления:

Требования

Прежде чем продолжить, сделайте следующее:

• Настройте Google Mobile Ads Unity Plugin.
• Установите плагин Unity версии 7.1.0 или более поздней.

Всегда используйте тестовые объявления

В приведенном ниже образце кода содержится идентификатор рекламного блока, который можно использовать для запроса тестовых объявлений. Он специально настроен так, чтобы в ответ на каждый запрос возвращать тестовые объявления, а не рабочие.

Однако после того, как вы зарегистрируете приложение в веб-интерфейсе AdMob и создадите собственные идентификаторы рекламных блоков для использования в приложении, вам нужно будет настроить свое устройство как тестовое.

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Реализация

Основные этапы интеграции объявлений при запуске приложения:

1. Создайте служебный класс
2. Загрузите объявление при запуске приложения
3. Как отслеживать события объявлений при запуске приложения
4. Определите срок действия объявлений
5. Как отслеживать события состояния приложения
6. Показ объявления при запуске приложения
7. Удалите объявление при запуске приложения
8. Предварительно загружайте следующее объявление при запуске приложения

Создайте служебный класс

Создайте класс AppOpenAdController для загрузки объявления. Этот класс управляет переменной экземпляра, чтобы отслеживать загруженное объявление и идентификатор рекламного блока для каждой платформы.

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

/// <summary>
/// Demonstrates how to use the Google Mobile Ads app open ad format.
/// </summary>
[AddComponentMenu("GoogleMobileAds/Samples/AppOpenAdController")]
public class AppOpenAdController : MonoBehaviour
{

    // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
    private string _adUnitId = "ca-app-pub-3940256099942544/9257395921";
#elif UNITY_IPHONE
    string _adUnitId = "ca-app-pub-3940256099942544/5575463023";
#else
    private string _adUnitId = "unused";
#endif

    public bool IsAdAvailable
    {
        get
        {
            return _appOpenAd != null;
        }
    }

    public void Start()
    {
        // Initialize Google Mobile Ads Unity Plugin.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }

    /// <summary>
    /// Loads the app open ad.
    /// </summary>
    public void LoadAppOpenAd()
    {
    }

    /// <summary>
    /// Shows the app open ad.
    /// </summary>
    public void ShowAppOpenAd()
    {
    }
}

Загрузите объявление при запуске приложения

Чтобы загрузить объявление при запуске приложения, используйте статический метод Load() класса AppOpenAd. Для метода load требуется идентификатор рекламного блока, объект AdRequest и обработчик завершения, который вызывается при успешной или неудавшейся загрузке объявления. Загруженный объект AppOpenAd предоставляется в качестве параметра в обработчике завершения. В примере ниже показано, как загрузить AppOpenAd.

 // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
   private string _adUnitId = "ca-app-pub-3940256099942544/9257395921";
#elif UNITY_IPHONE
   string _adUnitId = "ca-app-pub-3940256099942544/5575463023";
#else
  private string _adUnitId = "unused";
#endif

  private AppOpenAd appOpenAd;

  /// <summary>
  /// Loads the app open ad.
  /// </summary>
  public void LoadAppOpenAd()
  {
      // Clean up the old ad before loading a new one.
      if (appOpenAd != null)
      {
            appOpenAd.Destroy();
            appOpenAd = null;
      }

      Debug.Log("Loading the app open ad.");

      // Create our request used to load the ad.
      var adRequest = new AdRequest();

      // send the request to load the ad.
      AppOpenAd.Load(_adUnitId, adRequest,
          (AppOpenAd ad, LoadAdError error) =>
          {
              // if error is not null, the load request failed.
              if (error != null || ad == null)
              {
                  Debug.LogError("app open ad failed to load an ad " +
                                 "with error : " + error);
                  return;
              }

              Debug.Log("App open ad loaded with response : "
                        + ad.GetResponseInfo());

              appOpenAd = ad;
              RegisterEventHandlers(ad);
          });
  }

Предупреждение. Настоятельно не рекомендуется пытаться загрузить новое объявление из блока завершения запроса объявления, если объявление не удалось загрузить. Если вам необходимо загрузить объявление из блока завершения запроса объявления, ограничьте количество повторных попыток загрузки, чтобы избежать непрерывных неудачных запросов объявлений в таких ситуациях, как ограниченное сетевое подключение.

Как отслеживать события объявлений при запуске приложения

Чтобы настроить поведение объявления, вы можете подключить ряд событий в его жизненном цикле: открытие, закрытие и т. д. Чтобы прослушивать эти события, зарегистрируйте делегат, как показано ниже.

private void RegisterEventHandlers(AppOpenAd ad)
{
    // Raised when the ad is estimated to have earned money.
    ad.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("App open ad paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    ad.OnAdImpressionRecorded += () =>
    {
        Debug.Log("App open ad recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    ad.OnAdClicked += () =>
    {
        Debug.Log("App open ad was clicked.");
    };
    // Raised when an ad opened full screen content.
    ad.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("App open ad full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    ad.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("App open ad full screen content closed.");
    };
    // Raised when the ad failed to open full screen content.
    ad.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("App open ad failed to open full screen content " +
                       "with error : " + error);
    };
}

Определите срок действия объявлений

Важно! Срок действия объявлений при запуске приложения истекает через четыре часа. Объявления, показанные более чем через четыре часа после запроса, будут недействительны и могут перестать приносить доход.

Чтобы не показывать просроченное объявление, добавьте в класс AppOpenAdController метод, который будет проверять, сколько времени прошло с момента загрузки объявления. Затем используйте этот метод, чтобы проверить, действительно ли объявление.

Время ожидания для объявления при запуске приложения составляет 4 часа. Кешируйте время загрузки в переменной _expireTime.

// send the request to load the ad.
AppOpenAd.Load(_adUnitId, adRequest,
    (AppOpenAd ad, LoadAdError error) =>
    {
        // If the operation failed, an error is returned.
        if (error != null || ad == null)
        {
            Debug.LogError("App open ad failed to load an ad with error : " +
                            error);
            return;
        }

        // If the operation completed successfully, no error is returned.
        Debug.Log("App open ad loaded with response : " + ad.GetResponseInfo());

        // App open ads can be preloaded for up to 4 hours.
        _expireTime = DateTime.Now + TimeSpan.FromHours(4);

        _appOpenAd = ad;
    });

Обновите свойство IsAdAvailable, чтобы проверить _expireTime и убедиться, что загруженное объявление по-прежнему действительно.

public bool IsAdAvailable
{
    get
    {
        return _appOpenAd != null
               && _appOpenAd.IsLoaded()
               && DateTime.Now < _expireTime;
    }
}

Как отслеживать события состояния приложения

Используйте AppStateEventNotifier, чтобы отслеживать события на переднем и заднем плане приложения. Этот класс будет вызывать событие AppStateChanged каждый раз, когда приложение переходит в активный или фоновый режим.

private void Awake()
{
    // Use the AppStateEventNotifier to listen to application open/close events.
    // This is used to launch the loaded ad when we open the app.
    AppStateEventNotifier.AppStateChanged += OnAppStateChanged;
}

private void OnDestroy()
{
    // Always unlisten to events when complete.
    AppStateEventNotifier.AppStateChanged -= OnAppStateChanged;
}

Когда мы обрабатываем состояние AppState.Foreground и IsAdAvailable имеет значение true, мы вызываем ShowAppOpenAd(), чтобы показать объявление.

private void OnAppStateChanged(AppState state)
{
    Debug.Log("App State changed to : "+ state);

    // if the app is Foregrounded and the ad is available, show it.
    if (state == AppState.Foreground)
    {
        if (IsAdAvailable)
        {
            ShowAppOpenAd();
        }
    }
}

Показ объявления при запуске приложения

Чтобы показать загруженное объявление при запуске приложения, вызовите метод Show() для экземпляра AppOpenAd. Объявления могут показываться только один раз за загрузку. Чтобы проверить, готово ли объявление к показу, используйте метод CanShowAd().

Примечание. Объявления при запуске приложения должны показываться во время естественных пауз в работе приложения, например между уровнями игры или после выполнения пользователем задачи.

/// <summary>
/// Shows the app open ad.
/// </summary>
public void ShowAppOpenAd()
{
    if (appOpenAd != null && appOpenAd.CanShowAd())
    {
        Debug.Log("Showing app open ad.");
        appOpenAd.Show();
    }
    else
    {
        Debug.LogError("App open ad is not ready yet.");
    }
}

Удалите объявление при запуске приложения

Завершив работу с AppOpenAd, вызовите метод Destroy(), прежде чем удалять ссылку на него.

appOpenAd.Destroy();

Это уведомляет плагин о том, что объект больше не используется и занимаемая им память может быть освобождена. Если этого не сделать, произойдет утечка памяти.

Предварительно загружайте следующее объявление при запуске приложения

AppOpenAd – это одноразовый объект. Это означает, что после показа объявления при запуске приложения объект нельзя использовать повторно. Чтобы запросить другое объявление при запуске приложения, создайте новый объект AppOpenAd.

Чтобы подготовить объявление при запуске приложения к следующей возможности показа, выполните предварительную загрузку, когда произойдет событие OnAdFullScreenContentClosed или OnAdFullScreenContentFailed.

private void RegisterReloadHandler(AppOpenAd ad)
{
    ...
    // Raised when the ad closed full screen content.
    ad.OnAdFullScreenContentClosed += ()
    {
        Debug.Log("App open ad full screen content closed.");

        // Reload the ad so that we can show another as soon as possible.
        LoadAppOpenAd();
    };
    // Raised when the ad failed to open full screen content.
    ad.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("App open ad failed to open full screen content " +
                       "with error : " + error);

        // Reload the ad so that we can show another as soon as possible.
        LoadAppOpenAd();
    };
}

Холодный запуск и экраны загрузки

До сих пор в документации предполагалось, что вы показываете объявления при запуске приложения, только когда пользователи выводят приложение на передний план, когда оно приостановлено в памяти. Холодный запуск происходит, когда приложение запускается, но ранее не было приостановлено в памяти.

Например, холодный запуск происходит, когда пользователь впервые открывает приложение. При холодном запуске у вас не будет предварительно загруженного объявления при запуске приложения, готового к показу. Задержка между запросом и получением объявления может привести к тому, что пользователь начнет работать с приложением, а затем неожиданно увидит рекламу, не связанную с контекстом. Это неудобно для пользователей, поэтому так делать не рекомендуется.

При холодном запуске рекомендуется показывать объявления при запуске приложения на экране загрузки, пока загружаются объекты игры или приложения. Если приложение уже загрузилось и пользователь перешел к основному контенту, не показывайте объявление.

Важно! Чтобы объекты приложения продолжали загружаться во время показа объявления при запуске приложения, всегда загружайте объекты в фоновом потоке.

Рекомендации

Объявления при запуске приложения позволяют монетизировать экран загрузки, который показывается при первом запуске приложения и при переключении между приложениями. Чтобы не ухудшать удобство использования приложения, следуйте приведенным ниже рекомендациям.

• Первое объявление при запуске приложения лучше показывать после того, как пользователи воспользуются вашим приложением несколько раз.
• Показывайте объявления при запуске приложения, когда пользователи ждут его загрузки.
• Если экран загрузки скрыт под объявлением при запуске приложения и приложение загружается до закрытия объявления, то вам может потребоваться закрыть экран загрузки в обработчике событий OnAdDidDismissFullScreenContent.
• На платформе iOS AppStateEventNotifier создает экземпляр AppStateEventClient GameObject. Этот GameObject необходим для активации событий, поэтому не удаляйте его. События перестают срабатывать, если GameObject удален.

Дополнительные ресурсы

• Пример HelloWorld. Минимальная реализация всех форматов объявлений.