Reklamy pełnoekranowe

Reklamy pełnoekranowe zakrywają interfejs aplikacji, w której się wyświetlają. Zwykle wyświetlają się w naturalnych momentach przejściowych w aplikacji, np. podczas przerwy między poziomami gry. Gdy aplikacja wyświetla reklamę pełnoekranową, użytkownik może ją kliknąć, przejść do strony docelowej lub ją zamknąć. Studium przypadku.

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

Wymagania wstępne

• Wykonaj czynności opisane w przewodniku dla początkujących.

Zawsze testuj za pomocą reklam testowych

Przykładowy kod poniżej zawiera identyfikator jednostki reklamowej, którego możesz użyć do wysłania żądania reklam testowych. Został on specjalnie skonfigurowany tak, aby w przypadku każdego żądania zwracać reklamy testowe zamiast produkcyjnych, dzięki czemu można z niego korzystać bez obaw.

Gdy jednak zarejestrujesz aplikację wAdMob interfejsie internetowym i utworzysz własne identyfikatory jednostek reklamowych do wykorzystania w niej, na etapie tworzenia aplikacji skonfiguruj urządzenie jako urządzenie testowe.

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Inicjowanie pakietu SDK do reklam mobilnych

Przed wczytaniem reklam Twoja aplikacja musi zainicjować pakiet SDK do reklam mobilnych, wywołując MobileAds.Initialize(). Wystarczy to zrobić tylko raz, najlepiej przy uruchomieniu 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 używasz zapośredniczenia, poczekaj z załadowaniem reklam na wywołanie zwrotne, ponieważ dzięki temu wszystkie adaptery zapośredniczenia zostaną zainicjowane.

Implementacja

Najważniejsze czynności, jakie musisz wykonać, aby zintegrować reklamy pełnoekranowe:

1. Wczytywanie reklamy pełnoekranowej
2. Wyświetlanie reklamy pełnoekranowej
3. Odsłuchiwanie zdarzeń reklam pełnoekranowych
4. Wyczyść reklamę pełnoekranową
5. Wstępnie wczytuj następną reklamę pełnoekranową

Wczytywanie reklamy pełnoekranowej

Wczytywanie reklamy pełnoekranowej odbywa się za pomocą statycznej metody Load() w klasie InterstitialAd. Metoda wczytywania wymaga identyfikatora jednostki reklamowej, obiektu AdRequest oraz modułu obsługi zakończenia, który jest wywoływany po pomyślnym lub nieudanym wczytaniu reklamy. Wczytywany obiekt InterstitialAd jest podawany jako parametr w module obsługi zakończenia. Przykład poniżej pokazuje, jak wczytać InterstitialAd.

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

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

      // send the request to load the ad.
      InterstitialAd.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;
          });
  }

Ostrzeżenie: zdecydowanie odradzamy próby wczytania nowej reklamy z bloku realizacji żądania reklamy, gdy nie udało się jej wczytać. Jeśli musisz wczytywać reklamę z bloku realizacji żądania reklamy, ogranicz liczbę ponownych prób wczytania, aby uniknąć ciągłego nieudanych żądań reklamy w sytuacjach takich jak ograniczona połączenie sieciowe.

Wskazówka: za pomocą wywołań wczytywania reklam możesz utworzyć pamięć podręczną wstępnie wczytanych reklam przed ich wyświetleniem, co pozwoli Ci w razie potrzeby wyświetlać reklamy z zerowym czasem oczekiwania. Reklamy wygasają po godzinie, należy więc wyczyścić pamięć podręczną i co godzinę odświeżać stronę z nowymi reklamami.

Wyświetlanie reklamy pełnoekranowej

Aby wyświetlić załadowaną reklamę pełnoekranową, wywołaj w wystąpieniu InterstitialAd metodę Show(). Reklamy mogą wyświetlać się raz na każde wczytanie. Aby sprawdzić, czy reklama jest gotowa do wyświetlania, użyj metody CanShowAd().

Uwaga: reklamy pełnoekranowe powinny wyświetlać się podczas naturalnych przerw w korzystaniu z aplikacji, np. między poziomami gry lub po ukończeniu zadania przez użytkownika.

/// <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ń reklam pełnoekranowych

Aby jeszcze bardziej dostosować działanie reklamy, możesz uwzględnić pewną liczbę zdarzeń w jej cyklu życia. Wykryj 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 korzystać z funkcji InterstitialAd, pamiętaj, aby wywołać metodę Destroy(), zanim umieścisz w niej odwołanie:

_interstitialAd.Destroy();

Informuje to wtyczkę, że obiekt nie jest już używany, a zajmowaną przez niego pamięć można odzyskać. Jeśli ta metoda nie zostanie wywołana, dochodzi do wycieku pamięci.

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

Reklamy pełnoekranowe są obiektami jednorazowymi. Oznacza to, że po wyświetleniu reklamy pełnoekranowej obiektu nie można ponownie użyć. Aby zażądać kolejnej reklamy pełnoekranowej, utwórz nowy obiekt InterstitialAd.

Aby przygotować reklamę pełnoekranową na kolejną możliwość wyświetlenia, wczytaj ją z wyprzedzeniem po wywołaniu zdarzenia reklamy OnAdFullScreenContentClosed lub OnAdFullScreenContentFailed.

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

sprawdzone metody

Ustal, czy reklamy pełnoekranowe to odpowiedni typ reklamy do Twojej aplikacji.

Reklamy pełnoekranowe sprawdzają się najlepiej w aplikacjach z naturalnymi momentami przejściowymi. Takie zakończenie stanowi zakończenie zadania w aplikacji, np. udostępnienie obrazu lub ukończenie poziomu w grze. Zastanów się, w których momentach aplikacji chcesz wyświetlać najlepsze reklamy pełnoekranowe i jaka jest skłonność użytkownika do reakcji.

Wstrzymaj działanie podczas wyświetlania reklamy pełnoekranowej.

Jest wiele różnych typów reklam pełnoekranowych, np. tekstowych, graficznych lub wideo. Ważne jest, by aplikacja, która wyświetla reklamę pełnoekranową, zawieszała wykorzystanie pewnych zasobów, by mogła je wykorzystać w aplikacji. Jeśli np. wywołujesz reklamę pełnoekranową, wstrzymaj odtwarzanie dźwięku generowanego przez aplikację. Możesz wznowić odtwarzanie dźwięków w zdarzeniu OnAdFullScreenContentClosed(), które można wywołać, gdy użytkownik zakończy interakcję z reklamą. Warto też tymczasowo wstrzymać wykonywanie skomplikowanych zadań obliczeniowych, takich jak pętla gry, podczas wyświetlania reklamy. Dzięki temu użytkownik nie zobaczy wolnej i brakującej reakcji grafiki czy zacinania się filmu.

Nie zasyp użytkowników reklamami.

Zwiększenie częstotliwości wyświetlania reklam pełnoekranowych w aplikacji może wydawać się świetnym sposobem na zwiększenie przychodów, ale może też pogorszyć wrażenia użytkowników i obniżyć współczynniki klikalności. Zadbaj o to, aby użytkownicy nie przeszkadzali im tak często, że nie będą mogli z niej korzystać.

Dodatkowe materiały

• Przykład witryny HelloWorld: Minimalna implementacja wszystkich formatów reklam.

* Przykładowy przypadek użycia