Wczytywanie reklamy natywnej

Wybierz platformę: Android iOS Flutter Unity Android (starsza wersja)

Reklamy natywne to komponenty reklamowe, które są prezentowane użytkownikom za pomocą komponentów interfejsu natywnych dla platformy. Wyświetlają się one w tych samych typach widoków, których używasz do tworzenia układów, i można je sformatować tak, aby pasowały do wyglądu aplikacji.

Gdy reklama natywna się wczyta, aplikacja otrzymuje obiekt reklamy zawierający jej komponenty, a za ich wyświetlanie odpowiada aplikacja, a nie Google Mobile Ads SDK (Legacy).

Ogólnie rzecz biorąc, pomyślna implementacja reklam natywnych składa się z 2 części: wczytania reklamy za pomocą pakietu SDK i wyświetlenia treści reklamy w aplikacji.

Na tej stronie dowiesz się, jak używać pakietu SDK do wczytywania reklam natywnych.

Wymagania wstępne

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads SDK (Legacy).

Zawsze testuj za pomocą reklam testowych

Podczas tworzenia i testowania aplikacji używaj reklam testowych, a nie reklam produkcyjnych.

Najłatwiejszym sposobem na wczytanie reklam testowych jest użycie naszego specjalnego identyfikatora jednostki reklamowej do testowania reklam natywnych na Androidzie:

/21775744923/example/native

Jest 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 Google Mobile Ads SDK (Legacy) reklamach testowych znajdziesz w artykule Włączanie reklam testowych.

Wczytywanie reklam

Reklamy natywne są wczytywane za pomocą klasy AdLoader, która ma własną klasę Builder umożliwiającą dostosowanie jej podczas tworzenia. Dodając do klasy AdLoader detektory podczas jej tworzenia, aplikacja określa, jakie typy reklam natywnych jest gotowa odbierać. Klasa AdLoader wysyła wtedy żądania tylko tych typów.

Tworzenie klasy AdLoader

Poniższy kod pokazuje, jak utworzyć klasę AdLoader, która może wczytywać reklamy natywne:

Java

// It is recommended to call AdLoader.Builder on a background thread.
new Thread(
        () -> {
          AdLoader adLoader =
              new AdLoader.Builder(context, "AD_UNIT_ID")
                  .forNativeAd(
                      new NativeAd.OnNativeAdLoadedListener() {
                        @Override
                        // The native ad loaded successfully. You can show the ad.
                        public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {}
                      })
                  .withAdListener(
                      new AdListener() {
                        @Override
                        // The native ad load failed. Check the adError message for failure
                        // reasons.
                        public void onAdFailedToLoad(@NonNull LoadAdError adError) {}
                      })
                  // Use the NativeAdOptions.Builder class to specify individual options
                  // settings.
                  .withNativeAdOptions(new NativeAdOptions.Builder().build())
                  .build();
        })
    .start();
NativeAdSnippets.java

Kotlin

// It is recommended to call AdLoader.Builder on a background thread.
CoroutineScope(Dispatchers.IO).launch {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forNativeAd { nativeAd ->
        // The native ad loaded successfully. You can show the ad.
      }
      .withAdListener(
        object : AdListener() {
          override fun onAdFailedToLoad(adError: LoadAdError) {
            // The native ad load failed. Check the adError message for failure reasons.
          }
        }
      )
      // Use the NativeAdOptions.Builder class to specify individual options settings.
      .withNativeAdOptions(NativeAdOptions.Builder().build())
      .build()
}
NativeAdSnippets.kt

Zastąp AD_UNIT_ID identyfikatorem urządzenia testowego.

Ostrzeżenie: zdecydowanie odradzamy próbę wczytania nowej reklamy za pomocą metody onAdFailedToLoad(). Jeśli musisz wczytać reklamę za pomocą metody onAdFailedToLoad(), ogranicz liczbę ponownych prób wczytania reklamy, aby uniknąć ciągłych nieudanych żądań reklamy w sytuacjach takich jak ograniczona łączność z siecią.

Metoda forNativeAd() odpowiada za przygotowanie klasy AdLoader do formatu NativeAd. Gdy reklama zostanie wczytana, wywoływana jest metoda onNativeAdLoaded() obiektu detektora.

Konfigurowanie klasy AdListener za pomocą klasy AdLoader (opcjonalnie)

Podczas tworzenia klasy AdLoader funkcja withAdListener ustawia dla modułu wczytującego klasę AdListener. Metoda ta przyjmuje jako jedyny parametr klasę AdListener, która otrzymuje wywołania zwrotne z klasy AdLoader w przypadku wystąpienia zdarzeń cyklu życia reklamy:

Java

adLoaderBuilder.withAdListener(
    // Override AdListener callbacks here.
    new AdListener() {});
NativeAdSnippets.java

Kotlin

adLoaderBuilder.withAdListener(
  // Override AdListener callbacks here.
  object : AdListener() {}
)
NativeAdSnippets.kt

Wysyłanie żądań reklam

Wskazówka: możesz używać wywołań wczytywania reklam, aby utworzyć pamięć podręczną wstępnie wczytanych reklam, zanim zaczniesz je wyświetlać. Dzięki temu reklamy będą mogły wyświetlać się bez opóźnienia, gdy będzie to konieczne. Reklamy wygasają po godzinie, dlatego co godzinę należy czyścić pamięć podręczną i wczytywać nowe reklamy.

Gdy skończysz tworzyć klasę AdLoader, możesz jej użyć do wysyłania żądań reklam. Dostępne są 2 metody: loadAd() i loadAds().

Ważne: metoda loadAds() działa tylko w przypadku reklam Google. W przypadku reklam z pośrednictwem użyj metody loadAd().

loadAd()

Ta metoda wysyła żądanie jednej reklamy.

Java

adLoader.loadAd(new AdManagerAdRequest.Builder().build());
NativeAdSnippets.java

Kotlin

adLoader.loadAd(AdManagerAdRequest.Builder().build())
NativeAdSnippets.kt

loadAds()

Ta metoda wysyła żądanie kilku reklam (maksymalnie 5):

Java

// Load three native ads.
adLoader.loadAds(new AdManagerAdRequest.Builder().build(), 3);
NativeAdSnippets.java

Kotlin

// Load three native ads.
adLoader.loadAds(AdManagerAdRequest.Builder().build(), 3)
NativeAdSnippets.kt

Obie metody przyjmują jako pierwszy parametr obiekt AdManagerAdRequest. Jest to ta sama AdManagerAdRequest klasa używana przez banery i reklamy pełnoekranowe, a także możesz używać metod klasy AdManagerAdRequest do dodawania informacji o kierowaniu, tak jak w przypadku innych formatów reklam.

Wczytywanie kilku reklam (opcjonalnie)

Metoda loadAds() przyjmuje dodatkowy parametr – liczbę reklam, które pakiet SDK ma próbować wczytać w odpowiedzi na żądanie. Ta liczba jest ograniczona do 5. Nie ma też gwarancji, że pakiet SDK zwróci dokładnie taką liczbę reklam.

Zwrócone reklamy Google będą się od siebie różnić, ale nie ma gwarancji, że reklamy z zarezerwowanych zasobów reklamowych lub od kupujących innych firm będą unikalne.

Jeśli używasz pośrednictwa, nie używaj metody loadAds(), ponieważ żądania kilku reklam natywnych nie działają w przypadku identyfikatorów jednostek reklamowych skonfigurowanych pod kątem pośrednictwa.

Wywołania zwrotne

Po wywołaniu metody loadAd() następuje pojedyncze wywołanie zwrotne do wcześniej zdefiniowanych metod detektora, aby dostarczyć obiekt reklamy natywnej lub zgłosić błąd.

Zwalnianie zasobów

Pamiętaj, aby w przypadku wczytanych reklam natywnych używać metody destroy(). Zwalnia ona wykorzystywane zasoby i zapobiega wyciekom pamięci.

Ważne: destroy() należy wywołać w przypadku wszystkich reklam, nawet jeśli nie były używane ani do nich się nie odwoływano.

Sprawdź, czy wszystkie odwołania do klasy NativeAd są niszczone w metodzie onDestroy() aktywności.

W wywołaniu zwrotnym onNativeAdLoaded zniszcz wszystkie istniejące reklamy natywne, do których nie będzie już odwołań.

Kolejnym ważnym krokiem jest sprawdzenie, czy aktywność została zniszczona. Jeśli tak, wywołaj metodę destroy() w przypadku zwróconej reklamy i natychmiast zakończ działanie:

Java

nativeAd.destroy();
NativeAdSnippets.java

Kotlin

nativeAd.destroy()
NativeAdSnippets.kt

Sprawdzone metody

Podczas wczytywania reklam przestrzegaj tych zasad.

• Aplikacje, które używają reklam natywnych na liście, powinny wstępnie wczytywać listę reklam.

• Podczas wstępnego wczytywania reklam czyść pamięć podręczną i wczytuj reklamy ponownie co godzinę.

• Nie wywołuj metody loadAd() w przypadku klasy AdLoader, dopóki nie zakończy się wczytywanie pierwszego żądania.

• Ogranicz buforowanie reklam natywnych tylko do tego, co jest potrzebne. Na przykład podczas wstępnego wczytywania buforuj tylko reklamy, które są od razu widoczne na ekranie. Reklamy natywne mają duże wykorzystanie pamięci, a buforowanie reklam natywnych bez ich niszczenia powoduje nadmierne zużycie pamięci.

• Niszcz reklamy natywne, gdy nie są już używane.

Akceleracja sprzętowa w przypadku reklam wideo

Aby reklamy wideo mogły się wyświetlać w widokach reklam natywnych, musi być włączona akceleracja sprzętowa.

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ą, użyj atrybutu android:hardwareAccelerateddla <application> i <activity> elementów w pliku AndroidManifest.xml. Poniższy 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>
HardwareAccelerationSnippet.xml

Więcej informacji o opcjach sterowania akceleracją sprzętową znajdziesz w przewodniku dotyczącym akceleracji sprzętowej. Pamiętaj, że w przypadku wyłączonej aktywności nie można włączyć akceleracji sprzętowej w poszczególnych widokach reklam, dlatego akceleracja sprzętowa musi być włączona w samej aktywności.

Wyświetlanie reklamy

Gdy reklama zostanie wczytana, wystarczy ją wyświetlić użytkownikom. Aby dowiedzieć się, jak to zrobić, zapoznaj się z przewodnikiem dotyczącym zaawansowanych reklam natywnych.