Erste Schritte

Die Einbindung des Google Mobile Ads SDK in die App ist der erste Schritt zur Anzeigen schalten und Einnahmen erzielen. Nach der Integration des SDK können Sie ein Anzeigenformat auswählen (z. B. native Anzeigen oder Videoanzeigen mit Prämie) und folgen Sie der Anleitung, um sie zu implementieren.

Hinweis

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre App vorzubereiten.

Voraussetzungen für Apps

  • Achten Sie darauf, dass die Build-Datei Ihrer App die folgenden Werte enthält:

    • Mindestversion des SDK von 21 oder höher
    • Kompilieren Sie die SDK-Version von 33 oder höher

App in Ihrem AdMob-Konto einrichten

So registrieren Sie Ihre App als AdMob-App:

  1. Anmelden in oder registrieren für ein AdMob-Konto.

  2. Registrieren Sie Ihre App bei AdMob. In diesem Schritt wird eine AdMob-App mit einer eigenen AdMob-App erstellt. ID, die Sie später benötigen, .

Eigene App konfigurieren

  1. Fügen Sie in der Gradle-Einstellungsdatei den Das Maven-Repository von Google und Maven Central Repository:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. Abhängigkeiten für das Google Mobile Ads SDK zu Ihrem Build auf App-Ebene hinzufügen Datei:

    Kotlin

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

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.2.0'
}

  3. Füge deine AdMob App-ID hinzu, wie in den AdMob über die Weboberfläche, AndroidManifest.xml-Datei. Fügen Sie dazu ein <meta-data>-Tag mit android:name="com.google.android.gms.ads.APPLICATION_ID". Sie finden App-ID in der AdMob Weboberfläche Für android:value, fügen Sie Ihre eigene AdMob App-ID ein, in Anführungszeichen gesetzt ist.

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

    In einer echten App ersetzen Sie die Beispiel-App-ID durch Ihre tatsächliche AdMob App-ID. Sie können die Beispiel-ID verwenden, wenn testen Sie einfach das SDK in einer Hello World App.

    Beachten Sie auch, dass das <meta-data>-Tag nicht genau wie in den Ergebnissen hinzugefügt wurde. bei einem Absturz mit der Meldung:

    Missing application ID.

    (Optional) Deklarieren AD_ID-Berechtigung für vorherige Versionen, um mit Android zu funktionieren 13.

    Wenn Sie in Ihrer App Version 20.4.0 des Google Mobile Ads SDK oder höher ist, können Sie diesen Schritt überspringen, da das SDK die com.google.android.gms.permission.AD_ID und kann um auf die Werbe-ID zuzugreifen, wann immer diese verfügbar ist.

    Für Apps, in denen Version 20.3.0 des Google Mobile Ads SDK oder und auf Android 13 ausgerichtet sind, müssen Sie den Berechtigung com.google.android.gms.permission.AD_ID in der AndroidManifest.xml-Datei für das Google Mobile Ads SDK, um Zugriff auf die Werbe-ID:

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

    Weitere Informationen zur Erklärung zur Berechtigung „com.google.android.gms.permission.AD_ID“, und wie Sie ihn deaktivieren, finden Sie in diesem Konsolenartikel.

Google Mobile Ads SDK initialisieren

Initialisieren Sie das Google Mobile Ads SDK, bevor Sie Anzeigen laden. Rufen Sie dazu MobileAds.initialize().

Diese Methode initialisiert das SDK und ruft einen Abschluss-Listener auf, sobald sowohl die Die Initialisierungen des Google Mobile Ads SDK und des Adapters sind abgeschlossen oder 30-sekündiges Zeitlimit Dieser Vorgang muss nur einmal durchgeführt werden, idealerweise beim Start der App.

Anzeigen können über das Google Mobile Ads SDK oder SDKs von Vermittlungspartnern vorab geladen werden bei der Initialisierung an. Wenn Sie die Einwilligung von Nutzern in der EU (EWR) können Sie anfragespezifische Flags festlegen, z. B. setTagForChildDirectedTreatment() oder setTagForUnderAgeOfConsent(), oder Führen Sie andernfalls vor dem Laden der Anzeigen diese Schritte aus, bevor Sie sie initialisieren das Google Mobile Ads SDK.

Hier ein Beispiel für den Aufruf der initialize()-Methode auf einem Hintergrund Thread innerhalb einer Activity:

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) {}
    }
  }
}

Anzeigenformat auswählen

Das Google Mobile Ads SDK wurde importiert und Sie können eine Anzeige implementieren. AdMob bietet verschiedene Anzeigenformate, können Sie diejenige auswählen, die am besten zur Nutzererfahrung Ihrer App passt.

Banneranzeigenblöcke enthalten rechteckige Werbeanzeigen, die einen Teil der Layout. Sie können nach einer bestimmten Zeit automatisch aktualisiert werden. Das bedeutet, Nutzer sehen sich regelmäßig eine neue Anzeige an, auch wenn sie nicht verändert wurden. in deiner App. Dieses Anzeigenformat ist am einfachsten zu implementieren.

Banneranzeigen implementieren

Interstitial

Mit Interstitial-Anzeigenblöcken werden ganzseitige Anzeigen in Ihrer App bereitgestellt. Platzieren Sie sie in einer natürlichen Unterbrechungen und Übergänge auf der Benutzeroberfläche Ihrer App, z. B. nach Abschluss eines Levels in einer Gaming-App.

Interstitial-Anzeigen implementieren

Nativ

Bei nativen Anzeigen können Sie anpassen, wie Assets wie Anzeigentitel und und Calls-to-Action in Ihren Apps präsentieren. Wenn Sie die Anzeige selbst gestalten, Erstellen Sie natürliche, unaufdringliche Anzeigenpräsentationen, die einen aussagekräftigen Nutzererfahrung.

Native Anzeigen implementieren

Verfügbar

Mit Anzeigenblöcken für Anzeigen mit Prämie können Nutzer Spiele spielen, an Umfragen teilnehmen oder Videos ansehen, um In-App-Prämien wie Münzen, Extraleben oder Punkte erhalten Sie können unterschiedliche Prämien für unterschiedliche Anzeigenblöcke festlegen und die Prämienwerte und Elemente, die der Nutzer erhalten hat.

Anzeigen mit Prämie implementieren

Interstitial mit Prämie

Interstitials mit Prämie sind ein neues Anzeigenformat, bei dem Sie bieten Prämien wie Münzen oder Extraleben für Anzeigen an, die automatisch an natürlichen App-Übergängen.

Im Gegensatz zu Anzeigen mit Prämie müssen Nutzer der Anzeige von Anzeigen mit Prämie nicht zustimmen. Interstitial.

Anstelle der Aufforderung zur Aktivierung in Anzeigen mit Prämie ist bei Interstitials mit Prämie ein Eingangsbildschirm, auf dem die Prämie angekündigt wird und Nutzer die Möglichkeit haben, die Anzeige zu deaktivieren, wenn sie das möchten.

Interstitial-Anzeigen mit Prämie implementieren

App-Start-Anzeige

App-Start-Anzeigen sind ein Anzeigenformat, das eingeblendet wird, wenn Nutzer die App öffnen oder zu ihr zurückkehren. Die Anzeige überlagert den Ladebildschirm.

App-Start-Anzeigen implementieren

Zusätzliche Ressourcen

Das Google Mobile Ads Repository auf GitHub veranschaulicht, wie die verschiedenen Anzeigenformate dieser API verwendet werden.