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ą 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. Studium przypadku.

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

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

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 AdMob i utworzysz własne identyfikatory jednostek reklamowych do użycia w aplikacji, podczas tworzenia aplikacji skonfiguruj urządzenie jako urządzenie testowe.

Inicjowanie pakietu SDK do reklam mobilnych

Przed wczytaniem reklam aplikacja musi zainicjować pakiet SDK do reklam mobilnych Google, wywołując funkcję MobileAds.Initialize(). Należy to zrobić tylko raz, najlepiej przy uruchamianiu aplikacji.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize Google Mobile Ads SDK.
        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, ponieważ dzięki temu wszystkie adaptery zapośredniczenia zostaną zainicjowane.

Przykład BannerView

Poniższy przykładowy kod pokazuje, jak używać widoku banera. W tym przykładzie utwórz instancję widoku banera, użyj AdRequest, 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 używaniu widoku banera 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, który ma się wczytać.
• AdSize: rozmiar banera, którego chcesz użyć.
• AdPosition: miejsce, w którym mają się wyświetlać banery.

(Opcjonalnie) Tworzenie widoku banera z niestandardową pozycją

Aby mieć większą kontrolę nad tym, gdzie na ekranie ma się wyświetlać widok banera, niż zapewniają 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 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) Tworzenie widoku banera o niestandardowym rozmiarze

Oprócz używania AdSize stałej 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

Ładowanie banera reklamowego

Aby wczytać reklamę, utwórz obiekt 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ń wyświetlenia banera

Aby dostosować działanie reklamy, możesz połączyć ją z wieloma zdarzeniami w jej cyklu życia, takimi jak wczytywanie, otwieranie lub 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

Usuwanie widoku banera

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óre nie wczytują się prawidłowo, zalecamy odświeżenie banera zamiast jego usuwania 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ć. Pakiet SDK do reklam mobilnych Google 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 nową prośbę. 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 tej tabeli znajdziesz standardowe rozmiary banerów:

Dodatkowe materiały

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

• Przykładowy przypadek użycia