Wbudowane banery adaptacyjne

Banery adaptacyjne umożliwiają określenie szerokości reklamy, aby wybrać optymalny rozmiar reklamy. Banery adaptacyjne maksymalizują też skuteczność kampanii dzięki optymalizacji rozmiaru reklamy na każdym urządzeniu. Takie podejście stwarza możliwości poprawy skuteczności.

W porównaniu z zakotwiczonymi banerami adaptacyjnymi banery śródtekstowe są większe i wyższe oraz używają zmiennych zamiast stałych wysokości. Wbudowane banery adaptacyjne mają zmienną wysokość i mogą zajmować cały ekran lub mieć maksymalną wysokość określoną przez Ciebie.

Banery adaptacyjne umieszczasz w przewijanych treściach, np.:

Zanim zaczniesz

Zanim przejdziesz dalej, zapoznaj się z przewodnikiem Reklamy w formie banera.

Wdrażanie banerów adaptacyjnych

W przeciwieństwie do zakotwiczonych banerów adaptacyjnych wbudowane banery adaptacyjne są wczytywane z użyciem rozmiaru banera śródtekstowego. Aby utworzyć rozmiar reklamy dopasowującej się do miejsca docelowego, wykonaj te czynności:

1. Uzyskaj szerokość używanego urządzenia lub ustaw własną szerokość, jeśli nie chcesz używać pełnej szerokości ekranu.
2. Użyj odpowiednich metod statycznych klasy rozmiaru reklamy, takich jak AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) aby uzyskać obiekt rozmiaru reklamy adaptacyjnej w ramce wybranej orientacji.
3. Jeśli chcesz ograniczyć wysokość banera, użyj metody statycznej AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight)

W tym przykładzie pokazano te czynności:

Java

// Step 1: Create an inline adaptive banner ad size using the activity context.
AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
AdManagerAdView bannerView = new AdManagerAdView(this);
bannerView.setAdUnitId("ad unit ID");

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER);

// Step 3: Load an ad.
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
bannerView.loadAd(adRequest);
// TODO: Insert banner view in list view or scroll view, etc.

Kotlin

// Step 1: Create an inline adaptive banner ad size using the activity context.
val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
val bannerView = AdManagerAdView(this)
bannerView.adUnitId = "ad unit ID"

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER)

// Step 3: Load an ad.
val adRequest = AdManagerAdRequest.Builder().build()
bannerView.loadAd(adRequest)
// TODO: Insert banner view in list view or scroll view, etc.

Ważne: rozmiary reklam rezerwowanych w Ad Managerze mogą być wyświetlane w tym samym boksie reklamowym co reklamy o dopasowanym rozmiarze banera. Aby używać banerów adaptacyjnych z rezerwacjami reklam Ad Managera w tym samym boksie reklamowym, wywołaj funkcję setAdSizes z listą rozmiarów zawierającą rozmiar adaptacyjny oraz wszystkie rozmiary rezerwacji reklam.

Podczas implementowania banerów adaptacyjnych w aplikacji pamiętaj o tych kwestiach:

• Rozmiary banerów adaptacyjnych w linii tekstu najlepiej sprawdzają się, gdy wykorzystuje się całą dostępną szerokość. W większości przypadków jest to pełna szerokość ekranu urządzenia lub pełna szerokość treści nadrzędnych banera. Musisz znać szerokość widoku, który chcesz umieścić w reklamie, szerokość urządzenia, szerokość treści nadrzędnych oraz odpowiednie bezpieczne obszary.

• Aby korzystać z rozmiarów dostosowujących się do ekranu, konieczne może być zaktualizowanie lub utworzenie nowych elementów zamówienia. Więcej informacji

Orientacja rozmiaru banera adaptacyjnego w tekście

Aby wstępnie załadować inline adaptacyjny baner reklamowy w określonej orientacji, użyj jednej z tych metod:

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

Jeśli Twoja aplikacja obsługuje zarówno orientację pionową, jak i poziomą, a Ty chcesz wstępnie wczytać baner adaptacyjny w bieżącej orientacji, użyj metody AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width). Ta metoda wczytuje reklamę w bieżącej orientacji.

Ograniczanie wysokości wbudowanego banera adaptacyjnego

Domyślnie wbudowane banery adaptacyjne tworzone bez wartości maxHeight mają maxHeight równe wysokości urządzenia. Aby ograniczyć wysokość banera adaptacyjnego w linii, użyj metody AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).

Dodatkowe materiały

Przykłady w GitHub

Pobierz przykładową aplikację, aby zobaczyć, jak działają banery adaptacyjne wbudowane.

Java Kotlin