Banery reklamowe

Wyświetlenia banerów to prostokątne reklamy graficzne lub tekstowe, które zajmują miejsce na ekranie. Pozostają na ekranie, gdy użytkownicy wchodzą w interakcję z aplikacją i mogą się odświeżać automatycznie po upływie określonego czasu. Jeśli dopiero zaczynasz korzystać z urządzeń mobilnych reklamy, to dobry punkt wyjścia. Studium przypadku

Z tego przewodnika dowiesz się, jak zintegrować widoki banerów z aplikacją Unity. Dodatkowo do fragmentów kodu i instrukcji, a także informacje o rozmiarach prawidłowe banery oraz linki do dodatkowych materiałów.

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 żą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 interfejsu internetowego AdMob i utworzenie własnej jednostki reklamowej. Identyfikatory do wykorzystania w aplikacji; jawnie skonfiguruj urządzenie jako testowe urządzenia w trakcie w Google Cloud.

Zainicjowanie 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.

Przykład BannerView

Poniższy przykładowy kod zawiera szczegółowe informacje o korzystaniu z widoku banera. W tym przykładzie utwórz instancję widoku banera, użyj tagu AdRequest, aby wczytać reklamę w widoku banera, oraz a potem rozszerz jego możliwości przez obsługę zdarzeń cyklu życia.

Tworzenie widoku banera

Pierwszym krokiem w używaniu widoku banera jest utworzenie jego wystąpienia w skrypcie C# dołączonym do GameObject.

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

  BannerView _bannerView;

  /// <summary>
  /// Creates a 320x50 banner view at top of the screen.
  /// </summary>
  public void CreateBannerView()
  {
      Debug.Log("Creating banner view");

      // If we already have a banner, destroy the old one.
      if (_bannerView != null)
      {
          DestroyAd();
      }

      // Create a 320x50 banner at top of the screen
      _bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
  }

Konstruktor obiektu BannerView ma ten element parametry:

• adUnitId: identyfikator jednostki reklamowej, z której BannerView ma wczytywać reklamy.
• AdSize: rozmiar reklamy, którego chcesz użyć. Sprawdź rozmiary banerów. .
• AdPosition: pozycja, na której powinny się wyświetlać wyświetlenia banera. Wyliczenie AdPosition zawiera prawidłowe wartości pozycji reklamy.

Zwróć uwagę na to, jak używane są różne jednostki reklamowe w zależności od platformy. Musisz użyć Jednostkę reklamową iOS do wysyłania żądań reklamy w systemie iOS oraz jednostkę na Androida do tworzenia żądań na Androidzie.

(Opcjonalnie) Tworzenie widoku banera z pozycją niestandardową

Większa kontrola nad tym, gdzie znajduje się BannerView umieszczone na ekranie niż ta, którą oferują wartości AdPosition, użyj konstruktora dla którego parametry to współrzędne X i Y:

// Create a 320x50 banner views at coordinate (0,50) on screen.
_bannerView = new BannerView(_adUnitId, AdSize.Banner, 0, 50);

W lewym górnym rogu BannerView jest jest umieszczone na wartościach x i y przekazywanych do konstruktora, gdzie początek w lewym górnym rogu ekranu.

(Opcjonalnie) Tworzenie widoku banera o niestandardowym rozmiarze

Oprócz korzystania ze stałej AdSize możesz też określić rozmiar niestandardowy dla reklamy:

// Use the AdSize argument to set a custom size for the ad.
AdSize adSize = new AdSize(250, 250);
_bannerView = new BannerView(_adUnitId, adSize, AdPosition.Bottom);

Wczytywanie banera reklamowego

Aby wczytać reklamę, utwórz AdRequest i przekaż go do: metody LoadAd().

/// <summary>
/// Creates the banner view and loads a banner ad.
/// </summary>
public void LoadAd()
{
    // create an instance of a banner view first.
    if(_bannerView == null)
    {
        CreateBannerView();
    }

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

    // send the request to load the ad.
    Debug.Log("Loading banner ad.");
    _bannerView.LoadAd(adRequest);
}

Nasłuchiwanie zdarzeń wyświetlenia banera

Aby dostosować działanie reklamy, możesz dodać do niej wiele zdarzeń cyklu życia reklamy, np. wczytanie, otwarcie lub zamknięcie. Aby wsłuchać się w te utwory , zarejestruj przedstawiciela:

/// <summary>
/// listen to events the banner view may raise.
/// </summary>
private void ListenToAdEvents()
{
    // Raised when an ad is loaded into the banner view.
    _bannerView.OnBannerAdLoaded += () =>
    {
        Debug.Log("Banner view loaded an ad with response : "
            + _bannerView.GetResponseInfo());
    };
    // Raised when an ad fails to load into the banner view.
    _bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
    {
        Debug.LogError("Banner view failed to load an ad with error : "
            + error);
    };
    // Raised when the ad is estimated to have earned money.
    _bannerView.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Banner view paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    _bannerView.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Banner view recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    _bannerView.OnAdClicked += () =>
    {
        Debug.Log("Banner view was clicked.");
    };
    // Raised when an ad opened full screen content.
    _bannerView.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Banner view full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    _bannerView.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Banner view full screen content closed.");
    };
}

Zniszcz widok banera

Gdy skończysz korzystać z widoku banera, wywołaj Destroy(), aby zwolnić i zasobami Google Cloud.

/// <summary>
/// Destroys the banner view.
/// </summary>
public void DestroyAd()
{
    if (_bannerView != null)
    {
        Debug.Log("Destroying banner view.");
        _bannerView.Destroy();
        _bannerView = null;
    }
}

Znakomicie. Twoja aplikacja jest już gotowa do wyświetlania banerów reklamowych.

Rozmiary banerów

W tabeli poniżej znajdziesz standardowe rozmiary banerów.

Dodatkowe materiały

• Przykład HelloWorld: Minimalne wdrożenie wszystkich formatów reklam.

• Przykładowe zastosowanie etui