Pierwszym krokiem na drodze do wyświetlania reklam i zarabiania jest zintegrowanie pakietu SDK do reklam mobilnych Google z aplikacją. Po zintegrowaniu pakietu SDK możesz wybrać format reklamy (np. natywną lub wideo z nagrodą) i wykonać odpowiednie czynności, aby go zaimplementować.
Zanim zaczniesz
Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.
Wymagania wstępne aplikacji
Upewnij się, że plik kompilacji aplikacji zawiera te wartości:
minSdkVersion
z19
lub więcejcompileSdkVersion
z33
lub więcej
Konfigurowanie aplikacji na koncie AdMob
Zarejestruj aplikację jako aplikację AdMob, wykonując te czynności:
Zaloguj się lub zarejestruj konto AdMob.
Zarejestruj aplikację w AdMob. Ten krok umożliwia utworzenie aplikacji AdMob z unikalnym identyfikatorem aplikacji AdMob, który będzie potrzebny w dalszej części tego przewodnika.
Konfiguracja aplikacji
W sekcji
buildscript
iallprojects
plikubuild.gradle
na poziomie projektu umieść repozytorium Google Maven i centralne repozytorium Maven: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.5.0' }
Dodaj identyfikator AdMob aplikacji zidentyfikowany w interfejsie internetowymAdMob do pliku
AndroidManifest.xml
Twojej aplikacji. Aby to zrobić, dodaj tag<meta-data>
z parametremandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Identyfikator aplikacji możesz znaleźć w AdMob interfejsie internetowym. W poluandroid:value
wstaw 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 tego wymienionego powyżej. Jeśli chcesz po prostu poeksperymentować z pakietem SDK w aplikacji Hello World, możesz wykorzystać widoczny powyżej identyfikator przykładowej aplikacji.
Pamiętaj też, że jeśli nie dodasz tagu
<meta-data>
, jak widać powyżej, wystąpi awaria z komunikatem:The Google Mobile Ads SDK was initialized incorrectly.
(Opcjonalnie) Zadeklaruj uprawnienia
AD_ID
, aby poprzednie wersje działały z Androidem 13.Możesz pominąć ten krok, jeśli Twoja aplikacja korzysta z pakietu SDK do reklam mobilnych Google w wersji 20.4.0 lub nowszej, ponieważ pakiet SDK automatycznie deklaruje uprawnienie
com.google.android.gms.permission.AD_ID
i uzyskuje dostęp do identyfikatora wyświetlania reklam, gdy jest dostępny.W przypadku aplikacji, które korzystają z pakietu SDK do reklam mobilnych Google w wersji 20.3.0 lub starszej i są kierowane na Androida 13, musisz dodać w pliku
AndroidManifest.xml
uprawnieniecom.google.android.gms.permission.AD_ID
, 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 je wyłączyć, znajdziesz w tym artykule na temat Konsoli Play.
Zainicjowanie pakietu SDK do reklam mobilnych Google
Przed wczytaniem reklam aplikacja musi zainicjować pakiet SDK do reklam mobilnych Google, wywołując metodę MobileAds.initialize()
, która inicjuje pakiet SDK i wywołuje detektor ukończenia po zakończeniu inicjowania lub po upływie 30 sekund. Wystarczy to zrobić tylko raz, najlepiej na etapie uruchamiania aplikacji.
Reklamy mogą być wstępnie wczytywane przez pakiet SDK do reklam mobilnych Google lub pakiety SDK partnerów zapośredniczenia po wywołaniu metody MobileAds.initialize()
. Jeśli musisz uzyskać zgodę użytkowników z Europejskiego Obszaru Gospodarczego (EOG), ustaw flagi dotyczące żądań, takie jak tagForChildDirectedTreatment
lub tag_for_under_age_of_consent
, albo wykonaj inne działanie przed wczytaniem reklam, pamiętaj, by to zrobić przed zainicjowaniem pakietu SDK do reklam mobilnych Google.
Oto przykład wywołania metody initialize()
w aktywności:
Przykładowy element MainActivity (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ż moduł obsługi zakończenia zostanie wywołany, ponieważ dzięki temu wszystkie adaptery zapośredniczenia zostaną zainicjowane.
Wybierz format reklamy
Pakiet SDK do reklam mobilnych Google został zaimportowany i możesz już zaimplementować reklamę. AdMob oferuje wiele różnych formatów reklam, więc możesz wybrać ten, który najlepiej pasuje do wygody użytkowników Twojej aplikacji.
Baner
Prostokątne reklamy wyświetlane u góry lub u dołu ekranu urządzenia. Banery reklamowe pozostają na ekranie, gdy użytkownicy korzystają z aplikacji, i mogą być automatycznie odświeżane po pewnym czasie. Jeśli nie masz doświadczenia w korzystaniu z reklam mobilnych, będą one doskonałym punktem wyjścia.
Implementowanie banerów reklamowych
Pełnoekranowa
Reklamy pełnoekranowe, które zasłaniają interfejs aplikacji do momentu zamknięcia przez użytkownika Najlepiej sprawdza się w naturalnych przerwach w działaniu aplikacji, np. między poziomami gry lub tuż po ukończeniu zadania.
Stosowanie reklam pełnoekranowych
Natywna
Reklamy z możliwością dostosowania pasują do wyglądu i stylu Twojej aplikacji. To 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, wchodzenie w interakcje z reklamami demonstracyjnymi gier i korzystanie z ankiet. Służy do zarabiania na aplikacjach bezpłatnych.
Dodatkowe materiały
Repozytorium reklam mobilnych Google na GitHubie pokazuje, jak korzystać z różnych formatów reklam dostępnych w interfejsie API.