Konfigurowanie banerów reklamowych

Wybierz platformę: Android (beta) Android iOS Unity Flutter

Banery reklamowe 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 reklamą mobilną, banery reklamowe to dobry sposób na rozpoczęcie. Studium przypadku.

Z tego przewodnika dowiesz się, jak zintegrować banery reklamowe z aplikacją Unity. Oprócz fragmentów kodu i instrukcji znajdziesz tu też informacje o prawidłowym rozmiarze banerów i 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 żądania reklam testowych. Został on specjalnie skonfigurowany tak, aby przy każdym żądaniu zwracać reklamy testowe, a nie reklamy produkcyjne, dzięki czemu można go bezpiecznie używać.

Gdy zarejestrujesz aplikację w interfejsie AdMob i utworzysz własne identyfikatory jednostek reklamowych do użycia w aplikacji, podczas programowania wyraźnie skonfiguruj urządzenie jako urządzenie testowe.

Inicjowanie Google Mobile Ads Unity Plugin

Zanim aplikacja wczyta reklamy, musi zainicjować Google Mobile Ads Unity Plugin, wywołując 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 używasz 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 zawiera szczegółowe informacje o tym, jak używać banera reklamowego. W tym przykładzie tworzymy instancję banera reklamowego, używamy AdRequest do wczytania reklamy do banera reklamowego, a następnie rozszerzamy jego możliwości, obsługując zdarzenia cyklu życia.

Tworzenie banera reklamowego

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

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

Zastąp AD_UNIT_ID identyfikatorem jednostki reklamowej.

Konstruktor BannerView 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ą się znajdować banery reklamowe.

(Opcjonalnie) Tworzenie banera reklamowego z niestandardową pozycją

Aby mieć większą kontrolę nad tym, gdzie baner 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.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
BannerViewSnippets.cs

Lewy górny róg banera jest umieszczony w wartościach x i y przekazanych do konstruktora, gdzie początek układu to lewy górny róg ekranu.

(Opcjonalnie) Tworzenie banera reklamowego o niestandardowym rozmiarze

Oprócz używania 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);
bannerView = new BannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
BannerViewSnippets.cs

Wczytywanie banera reklamowego

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

// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
BannerViewSnippets.cs

Nasłuchiwanie zdarzeń banera reklamowego

Aby dostosować działanie reklamy, możesz podłączyć się do wielu zdarzeń w cyklu życia reklamy, takich jak wczytywanie, otwieranie czy zamykanie. Aby nasłuchiwać tych zdarzeń, zarejestruj delegata:

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

Niszczenie banera reklamowego

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

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

W przypadku banerów, których nie udało się wczytać, zalecamy odświeżenie banera 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 każdą częstotliwość odświeżania określoną w interfejsie AdMob. Jeśli nie masz włączonego odświeżania, wyślij nowe żądanie. Więcej informacji o odświeżaniu jednostek reklamowych, np. o ustawianiu częstotliwości odświeżania, znajdziesz w artykule Używanie opcji automatycznego odświeżania w przypadku banerów reklamowych.

Rozmiary banerów

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

Dodatkowe materiały

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

• Przykładowy przypadek użycia