Konfigurowanie banerów reklamowych

Widoki banerów to prostokątne reklamy graficzne lub reklamy 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 reklamą mobilną, to świetny punkt wyjścia.

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

Wymagania wstępne

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads Unity Plugin.

Zawsze przeprowadzaj testy z użyciem reklam testowych

Poniższy przykładowy kod zawiera identyfikator jednostki reklamowej, którego możesz użyć do żądania reklam testowych. Został on specjalnie skonfigurowany tak, aby w odpowiedzi na każde żądanie zwracać reklamy testowe, a nie produkcyjne, dzięki czemu jest bezpieczny w użyciu.

Jednak po zarejestrowaniu aplikacji w interfejsie internetowym Ad Managera i utworzeniu własnych identyfikatorów jednostek reklamowych do użycia w aplikacji musisz podczas jej tworzenia skonfigurować swoje 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, aby mieć pewność, że wszystkie adaptery zapośredniczenia zostały zainicjowane.

Przykład BannerView

Poniższy przykładowy kod pokazuje, jak używać widoku banera. W tym przykładzie utworzymy instancję widoku banera, użyjemy AdManagerAdRequest do wczytania reklamy do widoku banera, a następnie rozszerzymy jego możliwości, obsługując zdarzenia cyklu życia.

Tworzenie widoku banera

Pierwszym krokiem do użycia 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 AdManagerBannerView ma te parametry:

  • adUnitId: identyfikator jednostki reklamowej banera reklamowego, który ma zostać wczytany.
  • AdSize: rozmiar banera, którego chcesz użyć.
  • AdPosition: pozycja, w której mają być umieszczane widoki banerów.

(Opcjonalnie) Tworzenie widoku banera z niestandardową pozycją

Aby mieć większą kontrolę nad miejscem umieszczenia widoku banera na ekranie, niż zapewniają wartości AdPosition, użyj konstruktora, który jako parametry ma współrzędne x i y:

// 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 w miejscu o współrzędnych x i y przekazanych do konstruktora, gdzie punktem początkowym jest lewy górny róg ekranu.

(Opcjonalnie) Tworzenie widoku banera o rozmiarze niestandardowym

Oprócz 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) Kilka rozmiarów reklam

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

Wczytywanie banera reklamowego

Po skonfigurowaniu AdManagerBannerView wczytaj reklamę za pomocą metody LoadAd() w klasie AdManagerBannerView. Przyjmuje parametr , który zawiera informacje o czasie działania, takie jak informacje o kierowaniu, etykiety wykluczenia i identyfikator podany przez wydawcę.

Aby wczytać reklamę, utwórz obiekt 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 podpiąć się pod różne zdarzenia w jej cyklu życia, takie jak wczytywanie, otwieranie czy zamykanie. Aby nasłuchiwać tych zdarzeń, zarejestruj obiekt delegowany:

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(), która zwolni zasoby:

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

Jeśli baner nie wczyta się, zalecamy jego odświeżenie zamiast niszczenia 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ć kolejnego żądania reklamy, gdy nie uda się jej wczytać. Google Mobile Ads Unity Plugin uwzględnia częstotliwość odświeżania określoną w interfejsie Ad Managera. Jeśli nie masz włączonego odświeżania, 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 bez przewijania. W porównaniu ze standardowymi zakotwiczonymi banerami adaptacyjnymi te banery mogą mieć 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 Średni prostokąt IAB Telefony i tablety MEDIUM_RECTANGLE
468 x 60 Pełnowymiarowy baner IAB Tablety FULL_BANNER
728 x 90 Długi baner IAB Tablety LEADERBOARD
Podana szerokość x wysokość adaptacyjna 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 umożliwiają tworzenie reklam, 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ń aplikacji Ad Managera za pomocą AppEvent. Te zdarzenia mogą wystąpić w dowolnym momencie cyklu życia reklamy, nawet przed wywołaniem wczytywania.

Zdarzenie OnAppEventReceived jest wywoływane, gdy w reklamie wystąpi zdarzenie w aplikacji. Oto przykład, jak obsłużyć to zdarzenie 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