Wypróbuj

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

Skonfiguruj aplikację na koncie AdMob

Aby zarejestrować aplikację jako aplikację AdMob:

  1. Zaloguj się na konto AdMob lub zarejestruj się.

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

  1. W pliku build.gradle na poziomie projektu umieść repozytorium Maven Google i centralne repozytorium Maven w sekcjach buildscript i allprojects:

    buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

  2. 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'
}

  3. Dodaj identyfikator aplikacji AdMob (zidentyfikowany w interfejsieAdMob) do pliku AndroidManifest.xml aplikacji. Aby to zrobić, dodaj tag <meta-data> z android:name="com.google.android.gms.ads.APPLICATION_ID". Identyfikator aplikacji znajdziesz w AdMob interfejsie. W polu android: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 pliku AndroidManifest.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.

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.

Wdrażanie reklam z nagrodą

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.