Reklamy pełnoekranowe

Reklamy pełnoekranowe zakrywają interfejs aplikacji, w której się wyświetlają. Zazwyczaj wyświetlają się w naturalnych punktach przejścia w aplikacji. np. podczas przerwy między poziomami w grze. Gdy aplikacja wyświetla reklama pełnoekranowa, użytkownik może ją kliknąć i przejść do jej stronę docelową lub zamknąć ją i wrócić do aplikacji.

Z tego przewodnika dowiesz się, jak zintegrować reklamy pełnoekranowe z aplikacją w Unity.

Wymagania wstępne

Zawsze testuj reklamy za pomocą reklam testowych

Poniższy przykładowy kod zawiera identyfikator jednostki reklamowej, którego możesz użyć do żądania reklam testowych. Został on skonfigurowany tak, aby wyświetlać reklamy testowe, a nie aby tworzyć bezpieczne reklamy dla każdego żądania.

Jeśli jednak zarejestrujesz aplikację w Interfejs internetowy Ad Managera i utworzona własną jednostkę reklamową Identyfikatory do wykorzystania w aplikacji; jawnie skonfiguruj urządzenie jako testowe urządzenia w trakcie w Google Cloud.

/21775744923/example/interstitial

Inicjowanie pakietu SDK do reklam mobilnych

Przed wczytaniem reklam poproś aplikację o zainicjowanie pakietu SDK do reklam mobilnych, wywołując MobileAds.Initialize() Wystarczy to zrobić tylko raz, najlepiej podczas uruchamiania aplikacji.

using GoogleMobileAds;
using GoogleMobileAds.Api;

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

Jeśli korzystasz z zapośredniczenia, poczekaj, aż nastąpi wywołanie zwrotne, zanim wczytasz reklamy jako Dzięki temu wszystkie adaptery zapośredniczenia zostaną zainicjowane.

Implementacja

Główne etapy integracji reklam pełnoekranowych:

  1. Wczytaj reklamę pełnoekranową
  2. Pokaż reklamę pełnoekranową
  3. Odsłuchiwanie zdarzeń reklamy pełnoekranowej
  4. Wyczyść reklamę pełnoekranową
  5. Wstępnie wczytaj następną reklamę pełnoekranową

Wczytaj reklamę pełnoekranową

Ładowanie reklamy pełnoekranowej odbywa się za pomocą statycznej metody Load() w klasie InterstitialAd. Metoda wczytywania wymaga identyfikatora jednostki reklamowej, AdManagerAdRequest i moduł obsługi uzupełniania, jest wywoływana, gdy reklama zostanie wczytana lub nie uda się. Wczytany Obiekt AdManagerInterstitialAd jest podawany jako parametr w z modułu obsługi uzupełniania. Przykład poniżej pokazuje, jak wczytać plik AdManagerInterstitialAd.


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

  private InterstitialAd _interstitialAd;

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

      Debug.Log("Loading the interstitial ad.");

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

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

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

              _interstitialAd = ad;
          });
  }

Wyświetlanie reklamy pełnoekranowej

Aby wyświetlić wczytaną reklamę pełnoekranową, wywołaj metodę Show() w AdManagerInterstitialAd instancję. Reklamy mogą być wyświetlane raz na strony. Użyj metody CanShowAd(), aby sprawdzić, czy reklama jest gotowa do wyświetlenia.

/// <summary>
/// Shows the interstitial ad.
/// </summary>
public void ShowInterstitialAd()
{
    if (_interstitialAd != null && _interstitialAd.CanShowAd())
    {
        Debug.Log("Showing interstitial ad.");
        _interstitialAd.Show();
    }
    else
    {
        Debug.LogError("Interstitial ad is not ready yet.");
    }
}

Odsłuchiwanie zdarzeń reklamy pełnoekranowej

Aby jeszcze bardziej dostosować działanie swojej reklamy, możesz wykorzystać różne zdarzenia w cyklu życia reklamy. Wykrywaj te zdarzenia, rejestrując przedstawiciela jak pokazano poniżej.

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

Wyczyść reklamę pełnoekranową

Gdy skończysz pracę z AdManagerInterstitialAd, zrób pamiętaj, aby przed usunięciem odwołania wywołać do niej metodę Destroy():

_interstitialAd.Destroy();

Wtyczka powiadomi wtyczkę, że obiekt nie jest już używany, a także jego pamięć można odzyskać. Niewywołanie tej metody może spowodować wycieki pamięci.

Wstępnie wczytaj następną reklamę pełnoekranową

Reklamy pełnoekranowe są przeznaczone do jednorazowego użytku. Oznacza to, że reklama pełnoekranowa obiektu, nie można go użyć ponownie. Aby poprosić o wyświetlenie kolejnej reklamy przejściowej, utwórz nowy obiekt AdManagerInterstitialAd.

Aby przygotować reklamę pełnoekranową na następne wyświetlenie, wczytaj wstępnie element reklama pełnoekranowa po OnAdFullScreenContentClosed lub Zgłoszono OnAdFullScreenContentFailed zdarzenie reklamowe.

private void RegisterReloadHandler(InterstitialAd interstitialAd)
{
    // Raised when the ad closed full screen content.
    interstitialAd.OnAdFullScreenContentClosed += ()
    {
        Debug.Log("Interstitial Ad full screen content closed.");

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

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

Zdarzenia w aplikacjach

Zdarzenia w aplikacji pozwalają tworzyć reklamy, które mogą wysyłać komunikaty do kodu aplikacji. Aplikacja mogą podejmować działania na podstawie tych komunikatów.

Możesz nasłuchiwać zdarzeń Ad Managera w aplikacjach za pomocą narzędzia AppEvent. Te wydarzenia może wystąpić w dowolnym momencie cyklu życia reklamy, nawet przed wywołaniem wczytywania.

namespace GoogleMobileAds.Api.AdManager;

/// The App event message sent from the ad.
public class AppEvent
{
    // Name of the app event.
    string Name;
    // Argument passed from the app event.
    string Value;
}

Wartość OnAppEventReceived jest podwyższana, gdy w reklamie wystąpi zdarzenie w aplikacji. Oto przykład obsługi tego zdarzenia w kodzie:

_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
    Debug.Log($"Received app event from the ad: {args.Name}, {args.Value}.");
};

Oto przykład, który pokazuje, jak zmienić kolor tła aplikacji w zależności od zdarzenia w aplikacji o nazwie koloru:

_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
  if (args.Name == "color")
  {
    Color color;
    if (ColorUtility.TryParseColor(arg.Value, out color))
    {
      gameObject.GetComponent<Renderer>().material.color = color;
    }
  }
};

A oto odpowiednia kreacja wysyłająca zdarzenie w aplikacji koloru:

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

Sprawdzone metody

Ustal, czy reklamy pełnoekranowe to odpowiedni typ reklamy do Twojej aplikacji.
Reklamy pełnoekranowe sprawdzają się najlepiej w aplikacjach z naturalnymi punktami przejściowymi. Zakończenie zadania w aplikacji, np. udostępnienie obrazu lub ukończenie zadania poziom gry, tworzy taki punkt. Zastanów się, w jakich momentach w przebiegu aplikacji najlepiej wyświetlać reklamy przejściowe i jak użytkownik zareaguje na nie.
Możesz wstrzymać działanie podczas wyświetlania reklamy pełnoekranowej.
Jest wiele różnych typów reklam pełnoekranowych, takich jak reklamy tekstowe, graficzny lub wideo. Upewnij się, że gdy aplikacja wyświetla reklama pełnoekranowa wstrzymuje również korzystanie z niektórych zasobów, aby umożliwić jak je wykorzystać. Na przykład gdy wykonujesz wywołanie dotyczące wyświetlenia reklama pełnoekranowa, pamiętaj o wstrzymaniu wszystkich wyjść audio generowanych przez aplikację. Możesz wznowić odtwarzanie dźwięków w zdarzeniu OnAdFullScreenContentClosed(), który można wywołać, gdy użytkownik zakończy interakcję z reklamą. Dodatkowo rozważ tymczasowe wstrzymanie intensywnych zadań obliczeniowych, takich jak pętla gry, podczas wyświetlania reklamy. Dzięki temu użytkownik nie będzie wolno lub nie reaguje na obraz albo zacina się podczas odtwarzania filmu.
Nie zasypuj reklam reklamami.
Zwiększenie częstotliwości wyświetlania reklam pełnoekranowych w aplikacji może się wydawać świetnym sposobem na zwiększenie przychodów, ale może też pogarszać wrażenia użytkowników i niższych współczynnikach klikalności. Zadbaj o to, aby użytkownicy nie byli zbyt często przerywane, ponieważ uniemożliwia im to korzystanie z aplikacji.

Dodatkowe materiały