Ta strona została przetłumaczona przez Cloud Translation API.

Wypróbuj

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 z 19 lub więcej
- compileSdkVersion z 33 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 i allprojects pliku build.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 parametrem android:name="com.google.android.gms.ads.APPLICATION_ID". Identyfikator aplikacji możesz znaleźć w AdMob interfejsie internetowym. W polu android:value wstaw własny AdMob identyfikator aplikacji (w cudzysłowie).
```
<manifest>
  <application>
    
    <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 uprawnienie com.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"/>

   
   <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.

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.

Wdrażanie reklam z nagrodą

Dodatkowe materiały

Repozytorium reklam mobilnych Google na GitHubie pokazuje, jak korzystać z różnych formatów reklam dostępnych w interfejsie API.