Zintegrowanie GMA Next-Gen SDK z aplikacją to pierwszy krok do wyświetlania reklam i zarabiania. Po zintegrowaniu pakietu SDK możesz wybrać format reklamy (np. natywną lub wideo z nagrodą) i postępować zgodnie z instrukcjami, aby go wdrożyć.
Zanim zaczniesz
Aby przygotować aplikację, wykonaj czynności opisane w tych sekcjach.
Wymagania wstępne dotyczące aplikacji
Sprawdź, czy w pliku kompilacji Twojej aplikacji znajdują się te wartości:
- Minimalna wersja pakietu SDK:
24lub nowsza - Wersja pakietu SDK do kompilacji:
35lub nowsza
- Minimalna wersja pakietu SDK:
- W przypadku aplikacji w języku Kotlin używaj minimalnej wersji Kotlin 1.9.
Konfiguracja aplikacji
W pliku ustawień Gradle dodaj repozytorium Google Maven i centralne repozytorium Maven:
Kotlin
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include(":app")
Groovy
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include ':app'
Dodaj zależności pakietu GMA Next-Gen SDK do pliku build na poziomie aplikacji:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1' }
Kliknij Synchronizuj teraz. Więcej informacji o synchronizacji znajdziesz w artykule Synchronizowanie projektów z plikami Gradle.
Inicjowanie pakietu GMA Next-Gen SDK
Aby zainicjować GMA Next-Gen SDK, wywołaj metodę
MobileAds.initialize(). Należy ją wywołać w wątku w tle. W przeciwnym razie może wystąpić błąd „Aplikacja nie odpowiada” (ANR).
Kotlin
import com.google.android.libraries.ads.mobile.sdk.MobileAds import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig import kotlinx.coroutines.CoroutineScope import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.launch class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val backgroundScope = CoroutineScope(Dispatchers.IO) backgroundScope.launch { // Initialize GMA Next-Gen SDK on a background thread. MobileAds.initialize( this@MainActivity, // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 InitializationConfig.Builder("SAMPLE_APP_ID").build() ) { // Adapter initialization is complete. } // SDK initialization is complete. If you don't want to wait for bidding adapters to finish // initializing, start loading ads now. } } }
Java
import com.google.android.libraries.ads.mobile.sdk.MobileAds; import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig; public class MainActivity extends AppCompatActivity { protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); new Thread( () -> { // Initialize GMA Next-Gen SDK on a background thread. MobileAds.initialize( this, // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 new InitializationConfig.Builder("SAMPLE_APP_ID") .build(), initializationStatus -> { // Adapter initialization is complete. }); // SDK initialization is complete. If you don't want to wait for bidding adapters to // finish initializing, start loading ads now. }) .start(); } }
Ta metoda inicjuje pakiet SDK i wywołuje detektor zakończenia po zakończeniu inicjowania pakietu GMA Next-Gen SDK i adaptera lub po 30 sekundach bezczynności. Należy to zrobić tylko raz, najlepiej przy uruchomieniu aplikacji.
Jeśli korzystasz z mediacji, przed wczytaniem reklam poczekaj na wywołanie procedury obsługi zakończenia. Dzięki temu wszystkie adaptery mediacji zostaną zainicjowane.
Reklamy mogą być wstępnie wczytywane przez GMA Next-Gen SDK lub pakiety SDK partnerów mediacji
podczas inicjowania. Jeśli musisz uzyskać zgodę użytkowników z Europejskiego
Obszaru Gospodarczego (EOG), Wielkiej Brytanii lub Szwajcarii, przed wczytaniem reklam ustaw flagi specyficzne dla żądania, takie jak
RequestConfiguration.TagForChildDirectedTreatment
lub
RequestConfiguration.TagForUnderAgeOfConsent,
albo
podejmij inne działania. Pamiętaj, aby zrobić to przed zainicjowaniem
GMA Next-Gen SDK.
Wybierz format reklamy
GMA Next-Gen SDK został zaimportowany i możesz wdrożyć reklamę. Ad Manager oferuje wiele różnych formatów reklam, dzięki czemu możesz wybrać ten, który najlepiej pasuje do wrażeń użytkowników w Twojej aplikacji.
Baner
W jednostkach banerów reklamowych wyświetlane są prostokątne reklamy, które zajmują część układu aplikacji. Mogą one być automatycznie odświeżane po upływie określonego czasu. Oznacza to, że użytkownicy zobaczą nowe reklamy w regularnych odstępach czasowych, nawet jeśli pozostaną na tym samym ekranie w aplikacji. Jest to format reklamy najprostszy do wdrożenia.
Pełnoekranowa
Jednostki reklam pełnoekranowych wyświetlają w aplikacji reklamy zajmujące całą stronę. Umieść je między elementami lub w przejściach aplikacji, tak aby pasowały do interfejsu, np. po ukończeniu poziomu w grze w aplikacji z grą mobilną.
Wdrażanie reklam pełnoekranowych
Natywna
Reklamy natywne to reklamy, w których możesz dostosować sposób prezentowania zasobów, takich jak nagłówki i wezwania do działania, w swoich aplikacjach. Dzięki samodzielnemu stylowi reklamy możesz tworzyć naturalne, nienachalne prezentacje reklam, które mogą wzbogacić wrażenia użytkowników.
Google Ad Manager oferuje 2 sposoby wdrażania reklam natywnych: style natywne i standardowe reklamy natywne z renderowaniem niestandardowym.
Style natywne zostały zaprojektowane tak, aby uprościć wdrażanie reklam natywnych. Jest to świetny wybór, jeśli dopiero zaczynasz korzystać z tego formatu. Renderowanie niestandardowe zostało zaprojektowane tak, aby zapewnić Ci jak największą swobodę w tworzeniu prezentacji.
Wdrażanie stylów natywnych Wdrażanie reklam natywnych (renderowanie niestandardowe)
Z nagrodą
Jednostki reklamowe z nagrodą umożliwiają użytkownikom granie w gry, wypełnianie ankiet lub oglądanie filmów, aby zdobywać nagrody w aplikacji, takie jak monety, dodatkowe życia lub punkty. Możesz ustawić różne nagrody w różnych jednostkach reklamowych i określić wartości nagród oraz elementy, które otrzymają użytkownicy.
Reklama pełnoekranowa z nagrodą
Reklama pełnoekranowa z nagrodą to nowy format reklamy zachęcającej użytkownika do jej obejrzenia. Umożliwia uzyskanie nagród w aplikacji, takich jak monety lub dodatkowe życia. Reklamy tego typu wyświetlają się automatycznie w naturalnych momentach przejściowych w aplikacji.
W przeciwieństwie do reklam z nagrodą użytkownicy nie muszą wyrazić zgody na wyświetlenie reklamy pełnoekranowej z nagrodą.
Zamiast prośby o zgodę stosowanej w reklamach z nagrodą reklamy pełnoekranowe z nagrodą na początku wyświetlają ekran z informacjami o nagrodzie za obejrzenie danej reklamy i dają użytkownikowi możliwość jej pominięcia.
Wdrażanie reklam pełnoekranowych z nagrodą
Przy otwarciu aplikacji
Reklama wyświetlana przy otwarciu aplikacji to format reklamy, który pojawia się, gdy użytkownicy otwierają Twoją aplikację lub do niej wracają. Reklama nakłada się na wczytywany ekran.
Wdrażanie reklam wyświetlanych przy otwarciu aplikacji