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

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

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

Требования

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

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

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

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

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

/21775744923/example/interstitial

Реализация

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

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
{

    // This ad unit is configured to always serve test ads.
    private string _adUnitId = "/21775744923/example/app-open";

    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 требует идентификатор рекламного блока, объект AdManagerAdRequest и обработчик завершения, который вызывается при успешной или неудачной загрузке объявления. Загруженный объект AppOpenAd передается в качестве параметра в обработчик завершения. В примере ниже показано, как загрузить AppOpenAd.

  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/21775744923/example/app-open";

  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 AdManagerAdRequest();

      // 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 – минимальная реализация всех форматов объявлений.