Konfigurowanie banerów reklamowych

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

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ą być automatycznie odświeżane po upływie określonego czasu. Jeśli dopiero zaczynasz przygodę z reklamami mobilnymi, to świetny sposób na rozpoczęcie.

Z tego przewodnika dowiesz się, jak zintegrować wyświetlenia banerów z aplikacją Unity. Oprócz fragmentów kodu i instrukcji zawiera on też informacje o prawidłowym rozmiarze banerów oraz linki do dodatkowych materiałów.

Wymagania wstępne

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads Unity Plugin.

Zawsze testuj za pomocą reklam testowych

Poniższy przykładowy kod zawiera identyfikator jednostki reklamowej, którego możesz użyć do wysyłania żądań reklam testowych. Został on specjalnie skonfigurowany tak, aby w przypadku każdego żądania zwracać reklamy testowe zamiast reklam produkcyjnych, dzięki czemu jest bezpieczny w użyciu.

Gdy jednak zarejestrujesz aplikację w interfejsie internetowym Ad Managera i utworzysz własne identyfikatory jednostek reklamowych do użycia w aplikacji, podczas tworzenia aplikacji skonfiguruj urządzenie jako urządzenie testowe.

/21775744923/example/interstitial

Inicjowanie Google Mobile Ads Unity Plugin

Zanim aplikacja wczyta reklamy, musi zainicjować Google Mobile Ads Unity Plugin, wywołując funkcję MobileAds.Initialize(). Należy to zrobić tylko raz, najlepiej przy uruchomieniu aplikacji.

using GoogleMobileAds;
using GoogleMobileAds.Api;

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

Jeśli korzystasz z zapośredniczenia, przed wczytaniem reklam poczekaj na wywołanie zwrotne, ponieważ dzięki temu wszystkie adaptery zapośredniczenia zostaną zainicjowane.

BannerView example

Poniższy przykładowy kod pokazuje, jak używać widoku banera. W tym przykładzie utwórz instancję widoku banera, użyj AdManagerAdRequest, aby wczytać reklamę do widoku banera, a następnie rozszerz jego możliwości, obsługując zdarzenia cyklu życia.

Tworzenie widoku banera

Pierwszym krokiem w korzystaniu z widoku banera jest utworzenie jego instancji.

// Create a 320x50 banner at top of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);

Zastąp AD_UNIT_ID identyfikatorem jednostki reklamowej.

Konstruktor klasy AdManagerBannerView ma te parametry:

  • adUnitId: identyfikator jednostki reklamowej banera reklamowego, który ma zostać wczytany.
  • AdSize: rozmiar banera, którego chcesz użyć.
  • AdPosition: miejsce, w którym mają się wyświetlać banery.

(Opcjonalnie) Utwórz widok banera z niestandardową pozycją

Aby mieć większą kontrolę nad tym, gdzie widok banera jest umieszczany na ekranie, niż oferują wartości AdPosition, użyj konstruktora, który ma współrzędne x i y jako parametry:

// Create a 320x50 banner views at coordinate (0,50) on screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);

Lewy górny róg widoku banera jest umieszczony na wartościach x i y przekazanych do konstruktora, gdzie punkt początkowy to lewy górny róg ekranu.

(Opcjonalnie) Utwórz widok banera o niestandardowym rozmiarze

Oprócz użycia stałej AdSize możesz też określić niestandardowy rozmiar reklamy:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);

(Opcjonalnie) Reklamy w kilku rozmiarach

Ad Manager umożliwia określenie wielu rozmiarów reklam, które mogą się wyświetlać w AdManagerBannerView. Przed wdrożeniem tej funkcji w pakiecie SDK utwórz element zamówienia kierowany na te same jednostki reklamowe powiązane z kreacjami o różnych rozmiarach.

W aplikacji przekaż wiele parametrów AdSize do funkcji ValidAdSizes:

// Create a 250x250 banner at the bottom of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);

// Add multiple ad sizes.
adManagerBannerView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner,
    new AdSize(120, 20),
    new AdSize(250, 250),
};

Jeśli AdManagerAdView zmieni rozmiar w momencie odświeżania, układ powinien automatycznie dostosować się do nowego rozmiaru. AdManagerAdView domyślnie przyjmuje rozmiar przekazany w pierwszym parametrze, dopóki nie zostanie zwrócona następna reklama.

Ładowanie banera reklamowego

Gdy AdManagerBannerView jest na miejscu, wczytaj reklamę za pomocą metody LoadAd() w klasie AdManagerBannerView. Przyjmuje on parametr, który zawiera informacje o czasie działania, takie jak informacje o kierowaniu, etykiety wykluczeń i identyfikator podany przez wydawcę.

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

// Send a request to load an ad into the banner view.
adManagerBannerView.LoadAd(new AdManagerAdRequest());

Nasłuchiwanie zdarzeń wyświetlenia banera

Aby dostosować działanie reklamy, możesz połączyć się z wieloma zdarzeniami w cyklu życia reklamy, takimi jak wczytywanie, otwieranie lub zamykanie. Aby nasłuchiwać tych zdarzeń, zarejestruj delegata:

adManagerBannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
adManagerBannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
adManagerBannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
adManagerBannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
adManagerBannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
adManagerBannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
adManagerBannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};

Zniszcz widok banera

Aby zniszczyć baner, wywołaj metodę Destroy(), aby zwolnić zasoby:

if (adManagerBannerView != null)
{
    // Always destroy the banner view when no longer needed.
    adManagerBannerView.Destroy();
    adManagerBannerView = null;
}

W przypadku banerów, które nie wczytują się prawidłowo, zalecamy odświeżenie banera zamiast usuwania go i tworzenia nowego. Więcej informacji znajdziesz w artykule Odświeżanie reklamy.

Odświeżanie reklamy

Jeśli jednostka reklamowa jest skonfigurowana do odświeżania, nie musisz wysyłać kolejnej prośby o reklamę, gdy nie uda się jej wczytać. Google Mobile Ads Unity Plugin uwzględnia każdą częstotliwość odświeżania określoną w interfejsie Ad Managera. Jeśli odświeżanie nie zostało włączone, wyślij nową prośbę. Więcej informacji o odświeżaniu jednostek reklamowych, np. o ustawianiu częstotliwości odświeżania, znajdziesz w artykule Częstotliwość odświeżania reklam w aplikacjach mobilnych.

Duże banery adaptacyjne to większy format przeznaczony do układów, których nie trzeba przewijać. W porównaniu ze standardowymi zakotwiczonymi banerami adaptacyjnymi te banery mają większą maksymalną wysokość (do 20% wysokości ekranu, od 50 do 150 dp). Ta większa przestrzeń jest zoptymalizowana pod kątem treści wideo.

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

Rozmiar w dp (szer. x wys.) Opis Dostępność Stała AdSize
320 x 50 Standardowy baner Telefony i tablety BANNER
320 x 100 Duży baner Telefony i tablety LARGE_BANNER
300 x 250 IAB Medium Rectangle Telefony i tablety MEDIUM_RECTANGLE
468 x 60 Baner pełnowymiarowy IAB Tablety FULL_BANNER
728 x 90 Długi baner IAB Tablety LEADERBOARD
Podana szerokość x adaptacyjna wysokość Baner adaptacyjny Telefony i tablety Nie dotyczy
Szerokość ekranu x 32|50|90 Baner inteligentny Telefony i tablety SMART_BANNER
Dowiedz się więcej o banerach adaptacyjnych, które mają zastąpić banery inteligentne.

Zdarzenia w aplikacji

Zdarzenia w aplikacjach pozwalają tworzyć reklamy, które mogą wysyłać komunikaty do kodu aplikacji. Aplikacja może następnie podejmować działania na podstawie tych wiadomości.

Możesz nasłuchiwać zdarzeń w aplikacji związanych z usługą Ad Manager za pomocą interfejsu AppEvent. Te zdarzenia mogą wystąpić w dowolnym momencie cyklu życia reklamy, nawet przed wywołaniem wczytania.

OnAppEventReceived jest wywoływane, gdy w reklamie wystąpi zdarzenie w aplikacji. Oto przykład obsługi tego zdarzenia w kodzie:

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

Oto przykład pokazujący, jak zmienić kolor tła aplikacji w zależności od zdarzenia w aplikacji o nazwie color:

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    if (args.Name == "color")
    {
        Color color;
        if (ColorUtility.TryParseHtmlString(args.Data, out color))
        {
            renderer.material.color = color;
        }
    }
};

A oto odpowiednia kreacja, która wysyła zdarzenie w aplikacji dotyczące 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: 0;
      left: 0;
      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>

Dodatkowe materiały