Z tego przewodnika dowiesz się, jak wczytać zakotwiczony baner adaptacyjny do aplikacji na Androida.
Wymagania wstępne
- Skonfiguruj Google Mobile Ads SDK.
- Opcjonalnie: aby zobaczyć przykład implementacji banerów reklamowych, wybierz jedną z tych aplikacji:
- Przykład zakotwiczonych banerów adaptacyjnych w języku Java, Kotlin, lub Jetpack Compose.
- Pokaz funkcji zaawansowanych w języku Java lub Kotlin.
Zawsze testuj reklamy testowe
Podczas tworzenia i testowania aplikacji używaj reklam testowych, a nie reklam produkcyjnych. Jeśli tego nie zrobisz, Twoje konto może zostać zawieszone.
Najłatwiejszym sposobem na wczytanie reklam testowych jest użycie naszego specjalnego identyfikatora jednostki reklamowej na banery na Androida:
ca-app-pub-3940256099942544/9214589741
Został on specjalnie skonfigurowany tak, aby zwracać reklamy testowe w odpowiedzi na każde żądanie. Możesz go używać w swoich aplikacjach podczas kodowania, testowania i debugowania. Pamiętaj tylko, aby przed opublikowaniem aplikacji zastąpić go własnym identyfikatorem jednostki reklamowej.
Więcej informacji o tym, jak działają Google Mobile Ads SDK reklamy testowe, znajdziesz w artykule Włączanie reklam testowych.
Określanie wyświetlenia reklamy
Układ XML
Dodaj widok do pliku XML układu, który będzie służyć jako kontener zakotwiczonego banera adaptacyjnego:
<!-- Ad view container that fills the width of the screen and adjusts its
height to the content of the ad. -->
<FrameLayout
android:id="@+id/ad_view_container"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:layout_alignParentBottom="true" />
Jetpack Compose
Dołącz folder JetpackCompose Utilities. Ten folder zawiera pomocnicze funkcje do tworzenia obiektu
AdViewi komponentów.Utwórz
AdView:
// Place the ad view at the bottom of the screen.
Column(modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.Bottom) {
Box(modifier = modifier.fillMaxWidth()) { BannerAd(adView, modifier) }
}
Ustawianie rozmiaru reklamy
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 i od 50 do 150 dp. Ta dodatkowa przestrzeń jest zoptymalizowana pod kątem treści wideo.
Ustaw AdSize na an
zakotwiczonego banera adaptacyjnego o określonej szerokości:
Java
// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360));
Kotlin
// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360))
Jetpack Compose
// Set a large anchored adaptive banner ad size with a given width.
val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(LocalContext.current, 360)
adView.setAdSize(adSize)
Dodawanie AdView do układu
Utwórz AdView o rozmiarze reklamy, który chcesz dodać do
układu aplikacji:
Java
// Create a new ad view.
adView = new AdView(this);
adView.setAdUnitId(AD_UNIT_ID);
// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360));
// Replace ad container with new ad view.
adContainerView.removeAllViews();
adContainerView.addView(adView);
Kotlin
// Create a new ad view.
val adView = AdView(this)
adView.adUnitId = AD_UNIT_ID
// Request a large anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getLargeAnchoredAdaptiveBannerAdSize(this, 360))
this.adView = adView
// Replace ad container with new ad view.
binding.adViewContainer.removeAllViews()
binding.adViewContainer.addView(adView)
Jetpack Compose
val adView = remember { AdView(context) }
// Setup and load the adview.
// Set the unique ID for this specific ad unit.
adView.adUnitId = BANNER_AD_UNIT_ID
// Set a large anchored adaptive banner ad size with a given width.
val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(LocalContext.current, 360)
adView.setAdSize(adSize)
// Place the ad view at the bottom of the screen.
Column(modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.Bottom) {
Box(modifier = modifier.fillMaxWidth()) { BannerAd(adView, modifier) }
}
Wczytywanie reklamy
Ten przykład wczytuje zakotwiczony baner adaptacyjny o szerokości 360 dp do obiektu AdView:
Java
AdRequest adRequest = new AdRequest.Builder().build();
adView.loadAd(adRequest);
Kotlin
val adRequest = AdRequest.Builder().build()
adView.loadAd(adRequest)
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 SDK uwzględnia częstotliwość odświeżania określoną w interfejsie AdMob. Jeśli odświeżanie nie jest włączone, 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.
Zwalnianie zasobów reklamy
Gdy skończysz korzystać z banera reklamowego, możesz zwolnić jego zasoby.
Aby zwolnić zasoby reklamy, usuń ją z hierarchii widoków i odrzuć wszystkie odwołania do niej:
Java
public void destroyBanner() {
// Remove banner from view hierarchy.
if (adView != null) {
View parentView = (View) adView.getParent();
if (parentView instanceof ViewGroup) {
((ViewGroup) parentView).removeView(adView);
}
// Destroy the banner ad resources.
adView.destroy();
}
// Drop reference to the banner ad.
adView = null;
}
Kotlin
fun destroyBanner() {
// Remove banner from view hierarchy.
val parentView = adView?.parent
if (parentView is ViewGroup) {
parentView.removeView(adView)
}
// Destroy the banner ad resources.
adView?.destroy()
// Drop reference to the banner ad.
adView = null
}
Zdarzenia reklamowe
Możesz nasłuchiwać różnych zdarzeń w cyklu życia reklamy, w tym zdarzeń wczytywania, wyświetlenia i kliknięcia reklamy oraz zdarzeń otwarcia i zamknięcia reklamy. Zalecamy ustawienie wywołania zwrotnego przed wczytaniem banera.
Java
if (adView != null) {
adView.setAdListener(
new AdListener() {
@Override
public void onAdClicked() {
// Code to be executed when the user clicks on an ad.
}
@Override
public void onAdClosed() {
// Code to be executed when the user is about to return
// to the app after tapping on an ad.
}
@Override
public void onAdFailedToLoad(@NonNull LoadAdError adError) {
// Code to be executed when an ad request fails.
}
@Override
public void onAdImpression() {
// Code to be executed when an impression is recorded
// for an ad.
}
@Override
public void onAdLoaded() {
// Code to be executed when an ad finishes loading.
}
@Override
public void onAdOpened() {
// Code to be executed when an ad opens an overlay that
// covers the screen.
}
});
}
Kotlin
adView?.adListener =
object : AdListener() {
override fun onAdClicked() {
// Code to be executed when the user clicks on an ad.
}
override fun onAdClosed() {
// Code to be executed when the user is about to return
// to the app after tapping on an ad.
}
override fun onAdFailedToLoad(adError: LoadAdError) {
// Code to be executed when an ad request fails.
}
override fun onAdImpression() {
// Code to be executed when an impression is recorded
// for an ad.
}
override fun onAdLoaded() {
// Code to be executed when an ad finishes loading.
}
override fun onAdOpened() {
// Code to be executed when an ad opens an overlay that
// covers the screen.
}
}
Każda z metod, które można zastąpić w AdListener
odpowiada zdarzeniu w cyklu życia reklamy.
| Metody, które można zastąpić | |
|---|---|
onAdClicked() |
Metoda onAdClicked()
jest wywoływana, gdy zostanie zarejestrowane kliknięcie reklamy.
|
onAdClosed() |
Metoda onAdClosed()
jest wywoływana, gdy użytkownik wraca do aplikacji po wyświetleniu docelowego adresu URL reklamy. Aplikacja może jej używać do wznawiania zawieszonych działań lub
wykonywania innych czynności niezbędnych do przygotowania się na interakcję.
Implementację metod detektora reklam w aplikacji w wersji demonstracyjnej interfejsu API Androida znajdziesz w przykładzie AdMob AdListener.
|
onAdFailedToLoad() |
Metoda onAdFailedToLoad()
jest jedyną, która zawiera parametr. Parametr error typu
LoadAdError opisuje, jaki błąd wystąpił. Więcej informacji znajdziesz w dokumentacji Debugowanie błędów wczytywania reklam.
|
onAdImpression() |
Metoda onAdImpression()
jest wywoływana, gdy zostanie zarejestrowane wyświetlenie reklamy.
|
onAdLoaded() |
Metoda onAdLoaded()
jest wykonywana, gdy reklama zostanie wczytana. Jeśli chcesz opóźnić
dodanie AdView
do aktywności lub fragmentu, dopóki nie będziesz mieć pewności, że reklama zostanie wczytana, na
przykład, możesz to zrobić tutaj.
|
onAdOpened() |
Metoda onAdOpened()
jest wywoływana, gdy reklama otwiera nakładkę, która zasłania ekran.
|
Akceleracja sprzętowa w przypadku reklam wideo
Aby reklamy wideo mogły się wyświetlać w widokach banerów reklamowych, akceleracja sprzętowa musi być włączona.
Akceleracja sprzętowa jest domyślnie włączona, ale niektóre aplikacje mogą ją wyłączyć. Jeśli dotyczy to Twojej aplikacji, zalecamy włączenie akceleracji sprzętowej w przypadku klas Activity, które używają reklam.
Włączanie akceleracji sprzętowej
Jeśli Twoja aplikacja nie działa prawidłowo przy włączonej akceleracji sprzętowej, możesz ją kontrolować także w przypadku poszczególnych aktywności. Aby włączyć lub
wyłączyć akcelerację sprzętową, możesz użyć android:hardwareAccelerated
atrybutu dla
<application>
i
<activity>
elementów w pliku AndroidManifest.xml. Ten przykład włącza akcelerację sprzętową w całej aplikacji, ale wyłącza ją w przypadku jednej aktywności:
<application android:hardwareAccelerated="true">
<!-- For activities that use ads, hardwareAcceleration should be true. -->
<activity android:hardwareAccelerated="true" />
<!-- For activities that don't use ads, hardwareAcceleration can be false. -->
<activity android:hardwareAccelerated="false" />
</application>
Więcej informacji o opcjach sterowania akceleracją sprzętową znajdziesz w przewodniku Akceleracja sprzętowa. Pamiętaj, że w przypadku wyłączenia aktywności nie można włączyć akceleracji sprzętowej w poszczególnych widokach reklam, więc akceleracja sprzętowa musi być włączona w samej aktywności.
Dalsze kroki
Banery zwijane
Banery zwijane to banery, które początkowo wyświetlają się jako większa nakładka z przyciskiem umożliwiającym zwinięcie reklamy do mniejszego rozmiaru. Możesz ich użyć do dalszej optymalizacji skuteczności. Więcej informacji znajdziesz w artykule Zwijane banery reklamowe.
Wbudowane banery adaptacyjne
Wbudowane banery adaptacyjne są większe i wyższe niż zakotwiczone banery adaptacyjne. Mają zmienną wysokość i mogą zajmować całą wysokość ekranu urządzenia. W przypadku aplikacji, które umieszczają banery reklamowe w treściach, które można przewijać, zalecamy używanie wbudowanych banerów adaptacyjnych zamiast zakotwiczonych banerów adaptacyjnych. Więcej informacji znajdziesz w artykule Wbudowane banery adaptacyjne