Rozpocznij

Integracja pakietu SDK do reklam mobilnych Google z aplikacją to pierwszy krok wyświetlanie reklam i zarabianie na nich. Po zintegrowaniu pakietu SDK możesz: wybierz format reklamy (np. reklamę natywną lub reklamę z nagrodą) i postępuj zgodnie z instrukcjami go wdrożyć.

Zanim zaczniesz

Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.

Wymagania wstępne aplikacji

  • Upewnij się, że plik kompilacji aplikacji używa tych wartości:

    • Minimalna wersja pakietu SDK 21 lub więcej
    • Skompiluj wersję pakietu SDK 33 lub więcej

Konfigurowanie aplikacji na koncie AdMob

Aby zarejestrować swoją aplikację jako aplikację AdMob, wykonaj te czynności:

  1. Zaloguj się lub zarejestruj się konta AdMob.

  2. Zarejestruj aplikację w AdMob. W tym kroku utworzysz aplikację AdMob z unikalną aplikacją AdMob Identyfikator, który będzie potrzebny później w tym polu Google.

Konfiguracja aplikacji

  1. W pliku ustawień Gradle dodaj parametr repozytorium Google Maven oraz 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")

    Zakręcony

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include ':app'
  2. Dodaj zależności pakietu SDK do reklam mobilnych Google do kompilacji na poziomie aplikacji plik:

    Kotlin

    dependencies {
      implementation("com.google.android.gms:play-services-ads:23.3.0")
    }

    Zakręcony

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.0'
    }
  3. Dodaj AdMob identyfikator aplikacji określony w AdMob do AndroidManifest.xml. Aby to zrobić, dodaj tag <meta-data> z android:name="com.google.android.gms.ads.APPLICATION_ID" Więcej identyfikator aplikacji w AdMob interfejsie internetowym. Dla: android:value, wstaw swój identyfikator AdMob własnej 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 rzeczywistej aplikacji zastąp przykładowy identyfikator aplikacji rzeczywistym identyfikatorem AdMob identyfikator aplikacji. Możesz użyć identyfikatora próbki, jeśli: tylko eksperymentujesz z pakietem SDK w aplikacji Hello World.

    Pamiętaj też, że dodanie tagu <meta-data> dokładnie w takiej postaci, w jakiej wyświetlają się wyniki, jeśli wykryje wypadek z taką informacją:

    Missing application ID.
    

    (Opcjonalnie) Zadeklaruj Uprawnienia AD_ID, aby poprzednie wersje działały z Androidem 13.

    Jeśli Twoja aplikacja korzysta z pakietu SDK do reklam mobilnych Google w wersji 20.4.0 lub wyżej, możesz pominąć ten krok, ponieważ pakiet SDK automatycznie deklaruje com.google.android.gms.permission.AD_ID i może zawsze, gdy jest dostępny.

    W przypadku aplikacji, które korzystają z pakietu SDK do reklam mobilnych Google w wersji 20.3.0 lub niższych wersji i są kierowane na Androida 13, musisz dodać com.google.android.gms.permission.AD_ID w AndroidManifest.xml pliku SDK do reklam mobilnych Google do znaleźć identyfikator 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>

    Aby dowiedzieć się więcej na temat: com.google.android.gms.permission.AD_ID deklaracja uprawnień, , w tym instrukcje, jak ją wyłączyć, znajdziesz w tym artykule w Google Play Artykuł na temat konsoli.

Zainicjowanie pakietu SDK do reklam mobilnych Google

Przed wczytaniem reklam zainicjuj pakiet SDK do reklam mobilnych Google, wywołując polecenie MobileAds.initialize()

Ta metoda inicjuje pakiet SDK i wywołuje detektor ukończenia, gdy Inicjowanie pakietu SDK do reklam mobilnych Google i adaptatora zostało ukończone lub po Limit czasu wynosi 30 sekund. Wystarczy to zrobić tylko raz, najlepiej podczas uruchamiania aplikacji.

Reklamy mogą być wstępnie wczytywane przez pakiet SDK do reklam mobilnych Google lub pakiety SDK partnera zapośredniczenia podczas inicjowania. Jeśli konieczne jest uzyskanie zgody od użytkowników z Europy, z Europejskiego Obszaru Gospodarczego (EOG), ustaw flagi dotyczące konkretnych żądań, np. setTagForChildDirectedTreatment() lub setTagForUnderAgeOfConsent(), lub w przeciwnym razie podejmij działanie przed wczytaniem reklam, pamiętaj, aby zrobić to przed zainicjowaniem pakiet SDK do reklam mobilnych Google.

Oto przykład wywołania metody initialize() w tle w ramach aktywności:

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);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
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 the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

Wybierz format reklamy

Pakiet SDK do reklam mobilnych Google został zaimportowany i możesz już zaimplementować reklamę. AdMob udostępnia wiele różnych formatów reklam, możesz wybrać takie, które najlepiej odpowiada użytkownikom Twojej aplikacji.

W jednostkach banerów reklamowych wyświetlane są prostokątne reklamy, które zajmują część układ. Mogą być automatycznie odświeżane po upływie określonego czasu. Oznacza to, że użytkownicy oglądają nową reklamę w regularnych odstępach czasu, nawet jeśli nie zmieniają się ekranu w aplikacji. Jest to również najprostszy do wdrożenia format reklamy.

Implementowanie banerów reklamowych

Pełnoekranowa

Jednostki reklamy pełnoekranowej umożliwiają wyświetlanie w aplikacji reklam zajmujących całą stronę. Ustaw je w naturalnym przerwy i przejścia w interfejsie aplikacji, np. po ukończeniu poziomu; w grze mobilnej.

Zastosuj reklamy pełnoekranowe

Natywna

Reklamy natywne to reklamy, w których możesz dostosować sposób, w jaki zasoby, takie jak nagłówki, Wezwania do działania są wyświetlane w aplikacjach. Dostosowując styl reklamy, możesz: tworzyć naturalne, dyskretne prezentacje, które wzbudzą zainteresowanie z myślą o użytkownikach.

Implementowanie reklam natywnych

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 poszczególnych jednostkach reklamowych i określać wartości nagród produkty otrzymane przez użytkownika.

Wdróż reklamy z nagrodą

Reklama pełnoekranowa z nagrodą

Reklama pełnoekranowa z nagrodą to nowy format reklam zachęcających do działania, oferuj nagrody, takie jak monety lub dodatkowe życia, za reklamy, które wyświetlają się automatycznie w naturalnych momentach przejściowych aplikacji.

W przeciwieństwie do reklam z nagrodą użytkownicy nie muszą wyrazić zgody na obejrzenie reklamy z nagrodą. reklama pełnoekranowa.

Zamiast prośby o zgodę na wykorzystanie danych w reklamach z nagrodą reklamy pełnoekranowe z nagrodą wymagają: z informacją o nagrodzie i możliwości rezygnacji, jeśli że chcą to robić.

Implementowanie reklam pełnoekranowych z nagrodą

Reklama przy otwarciu aplikacji

Reklamy wyświetlane przy otwarciu aplikacji pojawiają się, gdy użytkownicy otwierają . Reklama nakłada się na ekran wczytywania.

Wdrażanie reklam wyświetlanych przy otwarciu aplikacji

Dodatkowe materiały

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