Zintegrowanie pakietu SDK do reklam mobilnych Google z aplikacją to pierwszy krok w kierunku wyświetlania reklam i zarabiania. Po zintegrowaniu pakietu SDK możesz wybrać format reklamy (np. reklamę natywną lub wideo z nagrodą) i postępować zgodnie z instrukcjami implementacji.
Zanim zaczniesz
Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.
Wymagania wstępne aplikacji
- Używaj Androida Studio 3.2 lub nowszego
Upewnij się, że plik kompilacji aplikacji używa tych wartości:
- Wartość
minSdkVersion
19
lub wyższa - Wartość
compileSdkVersion
28
lub wyższa
- Wartość
Skonfiguruj aplikację na koncie AdMob
Aby zarejestrować aplikację jako aplikację AdMob:
Zaloguj się na konto AdMob lub zarejestruj się.
Zarejestruj aplikację w AdMob. Ten krok tworzy aplikację AdMob z unikalnym identyfikatorem aplikacji AdMob, która jest potrzebna w dalszej części tego przewodnika.
Konfiguracja aplikacji
W pliku
build.gradle
na poziomie projektu umieść repozytorium Maven Google i centralne repozytorium Maven w sekcjachbuildscript
iallprojects
:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Dodaj zależności pakietu SDK do reklam mobilnych Google do pliku Gradle na poziomie aplikacji, zwykle
app/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-ads:22.1.0' }
Dodaj identyfikator aplikacji AdMob (zidentyfikowany w interfejsieAdMob) do pliku
AndroidManifest.xml
aplikacji. Aby to zrobić, dodaj tag<meta-data>
zandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Identyfikator aplikacji znajdziesz w AdMob interfejsie. W poluandroid:value
wpisz własny AdMob identyfikator aplikacji w cudzysłowie.<manifest> <application> <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 --> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> </application> </manifest>
W prawdziwej aplikacji użyj rzeczywistego AdMob identyfikatora aplikacji, a nie identyfikatora podanego wyżej. Jeśli chcesz po prostu wypróbować pakiet SDK w aplikacji Hello World, możesz użyć przykładowego identyfikatora widocznego powyżej.
Pamiętaj też, że niedodanie tagu
<meta-data>
(jak pokazano powyżej) powoduje awarię z komunikatem:The Google Mobile Ads SDK was initialized incorrectly.
(Opcjonalnie) Zadeklaruj uprawnienie
AD_ID
do działania z poprzednimi wersjami Androida 13.Jeśli Twoja aplikacja używa pakietu SDK do reklam mobilnych Google w wersji 20.4.0 lub nowszej, możesz pominąć ten krok, ponieważ pakiet SDK automatycznie deklaruje uprawnienia
com.google.android.gms.permission.AD_ID
i ma dostęp do identyfikatora wyświetlania reklam zawsze, gdy jest dostępny.W przypadku aplikacji, które używają pakietu SDK do reklam mobilnych Google w wersji 20.3.0 lub starszej i są kierowane na Androida 13, musisz dodać uprawnienie
com.google.android.gms.permission.AD_ID
w plikuAndroidManifest.xml
, aby pakiet SDK do reklam mobilnych Google miał dostęp do identyfikatora wyświetlania reklam:<manifest> <application> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> <-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower --> <uses-permission android:name="com.google.android.gms.permission.AD_ID"/> </application> </manifest>
Więcej informacji o deklaracji uprawnień
com.google.android.gms.permission.AD_ID
, w tym o tym, jak ją wyłączyć, znajdziesz w tym artykule na temat Konsoli Play.
Zainicjuj pakiet SDK do reklam mobilnych Google
Zanim załadujesz reklamy, Twoja aplikacja zainicjuje pakiet SDK do reklam mobilnych Google, wywołując pakiet MobileAds.initialize()
, który inicjuje pakiet SDK, a po jego zakończeniu (lub 30 sekundach bezczynności) wywołuje detektor. Wystarczy to zrobić raz, najlepiej przy uruchamianiu aplikacji.
Reklamy mogą być wstępnie wczytywane przez pakiet SDK do reklam mobilnych Google lub pakiety SDK zapośredniczenia partnerów po wywołaniu elementu MobileAds.initialize()
. Jeśli musisz uzyskać zgodę użytkowników z Europejskiego Obszaru Gospodarczego (EOG), ustaw flagi dotyczące tego żądania (np. tagForChildDirectedTreatment
lub tag_for_under_age_of_consent
) albo wykonaj inne czynności przed wczytaniem reklam, pamiętaj, by zrobić to przed zainicjowaniem pakietu SDK do reklam mobilnych Google.
Oto przykład wywołania metody initialize()
w aktywności:
Przykładowa główna aktywność (fragment)
Java
import com.google.android.gms.ads.MobileAds; import com.google.android.gms.ads.initialization.InitializationStatus; import com.google.android.gms.ads.initialization.OnInitializationCompleteListener; public class MainActivity extends AppCompatActivity { protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); MobileAds.initialize(this, new OnInitializationCompleteListener() { @Override public void onInitializationComplete(InitializationStatus initializationStatus) { } }); } }
Kotlin
import com.google.android.gms.ads.MobileAds class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) MobileAds.initialize(this) {} } }
Jeśli korzystasz z zapośredniczenia, przed wczytaniem reklam poczekaj, aż wywoła się moduł obsługi ukończenia, aby upewnić się, że wszystkie adaptery zapośredniczenia zostały zainicjowane.
Wybierz format reklamy
Pakiet SDK do reklam mobilnych Google jest teraz zaimportowany i możesz już zaimplementować reklamę. AdMob Oferuje wiele różnych formatów reklam, możesz więc wybrać taką, która najlepiej pasuje do Twojej aplikacji.
Baner
Prostokątne reklamy wyświetlane u góry lub u dołu ekranu urządzenia. Banery reklamowe pozostają widoczne na ekranie, gdy użytkownicy korzystają z aplikacji, a po określonym czasie mogą się automatycznie odświeżać. Jeśli dopiero zaczynasz przygodę z reklamami mobilnymi,
Implementowanie banerów reklamowych
Pełnoekranowa
reklamy pełnoekranowe, które zakrywają interfejs aplikacji do momentu ich zamknięcia przez użytkownika. Najlepiej robić to w naturalnych przerwach w wyświetlaniu aplikacji, np. między poziomami gry lub zaraz po ukończeniu zadania.
Stosowanie reklam pełnoekranowych
Natywny
Reklamy, które można dostosować do wyglądu i stylu aplikacji. Ty decydujesz, jak i gdzie się wyświetlają, więc ich układ jest bardziej spójny z aplikacją.
Implementowanie reklam natywnych
Otrzymano
Reklamy, które nagradzają użytkowników za oglądanie krótkich filmów oraz interakcje z reklamami i ankietami. Służy do zarabiania na bezpłatnych aplikacjach.
Dodatkowe materiały
Z repozytorium reklam mobilnych Google na GitHubie dowiesz się, jak używać różnych formatów reklam dostępnych w tym interfejsie API.