Reklamy pełnoekranowe

Reklamy pełnoekranowe zakrywają interfejs aplikacji, w której się wyświetlają. Zwykle wyświetlają się w naturalnych punktach przejścia w aplikacji, np. podczas przerw między poziomami gry. Gdy w aplikacji wyświetla się reklama pełnoekranowa, użytkownik może ją kliknąć i przejść do miejsca docelowego lub zamknąć aplikację i wrócić do aplikacji. Studium przypadku.

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

Wymagania wstępne

• Zapoznaj się z przewodnikiem dla początkujących.

Zawsze korzystaj z reklam testowych

Poniższy przykładowy kod 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 reklam produkcyjnych, dzięki czemu można z niego korzystać.

Gdy jednak zarejestrujesz aplikację wAdMob interfejsie internetowym i utworzysz własne identyfikatory jednostek reklamowych do wykorzystania w niej, podczas jej tworzenia 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

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ą

Reklamę pełnoekranową można wczytać za pomocą statycznej metody Load() w klasie InterstitialAd. Metoda wczytywania wymaga identyfikatora jednostki reklamowej, obiektu AdRequest i modułu obsługi ukończenia, który jest wywoływany w przypadku udanego lub nieudanego wczytywania reklamy. Wczytany obiekt InterstitialAd jest podawany jako parametr w module obsługi uzupełniania. 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 wczytać reklamę z bloku realizacji żądania reklamy, ogranicz ponowne próby wczytania reklamy, aby uniknąć ciągłego nieudanych żądań reklamy w sytuacjach takich jak ograniczone połączenie sieciowe.

Wskazówka: za pomocą wywołań wczytywania reklam możesz utworzyć pamięć podręczną wstępnie wczytywanych reklam, zanim postanowisz je wyświetlić. Dzięki temu w razie potrzeby reklamy będą mogły się wyświetlać bez opóźnień. Reklamy wygasają po godzinie, dlatego należy wyczyścić tę pamięć podręczną i co godzinę odświeżyć stronę.

Pokaż reklamę pełnoekranową

Aby wyświetlić wczytaną reklamę pełnoekranową, wywołaj w wystąpieniu InterstitialAd metodę Show(). Reklama może być wyświetlana raz na wczytanie. Użyj metody CanShowAd(), aby sprawdzić, czy reklama jest gotowa do wyświetlenia.

Uwaga: reklamy pełnoekranowe powinny wyświetlać się podczas naturalnych przerw w korzystaniu z aplikacji, np. między poziomami gry lub po wykonaniu 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ń reklamy pełnoekranowej

Aby jeszcze bardziej dostosować działanie reklamy, możesz uwzględnić wiele zdarzeń w jej cyklu życia. Nasłuchuj tych zdarzeń przez zarejestrowanie 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 InterstitialAd, pamiętaj, by wywołać metodę Destroy(), zanim przeniesiesz do niego odwołanie:

_interstitialAd.Destroy();

Wtyczka powiadomi wtyczkę, że obiekt nie jest już używany, a zajmowaną przez niego 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 po wyświetleniu reklamy pełnoekranowej nie można ponownie użyć obiektu. Aby poprosić o kolejną reklamę pełnoekranową, utwórz nowy obiekt InterstitialAd.

Aby przygotować reklamę pełnoekranową na następne wyświetlenie, wczytaj ją wstępnie po wywołaniu zdarzenia 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 punktami przejściowymi. Może to być na przykład zakończenie zadania w aplikacji (np. udostępnienie obrazu lub ukończenie poziomu gry). Zastanów się, na którym etapie procesu w aplikacji najlepiej wyświetlać reklamy pełnoekranowe i jak najprawdopodobniej zareagują użytkownicy.

Możesz wstrzymać działanie podczas wyświetlania reklamy pełnoekranowej.

Jest wiele różnych typów reklam pełnoekranowych, takich jak tekstowe, graficzne i wideo. Gdy aplikacja wyświetla reklamę pełnoekranową, nie może też korzystać z niektórych zasobów, by reklama mogła z nich korzystać. Na przykład gdy wywołujesz żądanie wyświetlenia reklamy pełnoekranowej, pamiętaj, by wstrzymać odtwarzanie dźwięku generowanego przez aplikację. Możesz wznowić odtwarzanie dźwięków w zdarzeniu OnAdFullScreenContentClosed(), które może być wywoływane, gdy użytkownik zakończy interakcję z reklamą. Oprócz tego na czas wyświetlania reklamy rozważ tymczasowe przerwanie wykonywania bardziej intensywnych zadań obliczeniowych (np. pętli w grze). Dzięki temu użytkownik nie zobaczy powolnej lub niereagującej grafiki albo zacinania się filmów.

Nie zasypuj reklam 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, by przerywanie pracy użytkowników nie było tak częste, że nie mogliby już korzystać z Twojej aplikacji.

Dodatkowe materiały

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

* Przykładowy przypadek użycia