Erste Schritte mit AdMob in Ihrem C++-Projekt


Dieser Schnellstart richtet sich an Publisher und Entwickler, die AdMob verwenden möchten, um mit einer App, die mit Firebase erstellt wurde, Einnahmen zu erzielen. Wenn Sie Firebase nicht in Ihre App einbinden möchten, lesen Sie stattdessen die Anleitung für die eigenständige AdMob.

Hier finden Sie Informationen zu den Vorteilen der gemeinsamen Verwendung von AdMob, Firebase und Google Analytics.

Wenn Sie diese Anleitung zum ersten Mal durcharbeiten, empfehlen wir Ihnen, die Google Mobile Ads C++ SDK-Test-App herunterzuladen und zu verwenden.

Hinweis

  • Wenn Sie noch kein Firebase-Projekt und keine Firebase-App haben, folgen Sie der Firebase-Kurzanleitung: Firebase zu einem C++-Projekt hinzufügen.

  • Prüfen Sie, ob Google Analytics in Ihrem Firebase-Projekt aktiviert ist:

    • Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während der Projekterstellung.

    • Wenn Sie ein vorhandenes Firebase-Projekt haben, für das Google Analytics nicht aktiviert ist, können Sie Google Analytics auf dem Tab Integrationen unter  > Projekteinstellungen aktivieren.

Schritt 1:App in Ihrem AdMob-Konto einrichten

  1. Registrieren Sie jede Plattformvariante Ihrer App als AdMob-App.

    1. Melden Sie sich an oder registrieren Sie sich für ein AdMob-Konto.

    2. Registrieren Sie jede Plattformvariante Ihrer App bei AdMob. In diesem Schritt wird eine AdMob-App mit einer eindeutigen AdMob-App-ID erstellt, die Sie später in diesem Leitfaden benötigen.

    Sie werden aufgefordert, das Mobile Ads SDK in Ihre App einzufügen. Eine detaillierte Anleitung für diese Aufgabe finden Sie weiter unten in diesem Leitfaden.

  2. Verknüpfen Sie jede Ihrer AdMob-Apps mit der entsprechenden Firebase-App.

    Dieser Schritt ist optional, wird aber dringend empfohlen. Weitere Informationen zu den Vorteilen, die sich durch das Aktivieren von Nutzermesswerten und das Verknüpfen Ihrer AdMob-Apps mit Firebase ergeben

    Führen Sie für jede Plattformvariante die folgenden beiden Schritte im Dashboard Apps Ihres AdMob-Kontos aus:

    1. Aktivieren Sie Nutzermesswerte, damit AdMob kuratierte Analytics-Daten in Ihrem AdMob-Konto verarbeiten und anzeigen kann. Sie ist auch erforderlich, um Ihre AdMob-App mit Firebase zu verknüpfen.

    2. Verknüpfen Sie Ihre AdMob-App mit Ihrem vorhandenen Firebase-Projekt und der entsprechenden Firebase-App.

      Achten Sie darauf, dass Sie denselben Paketnamen (Android) oder dieselbe Bundle-ID (iOS) eingeben wie für Ihre Firebase-App. Den Paketnamen oder die Bundle-ID Ihrer Firebase-App finden Sie auf der Karte Meine Apps unter  > Projekteinstellungen.

Schritt 2:AdMob-App-ID zur App hinzufügen

Android

Fügen Sie die AdMob-App-ID der Datei AndroidManifest.xml Ihrer App hinzu, indem Sie das <meta-data>-Tag wie unten dargestellt einfügen.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

iOS

Fügen Sie in der Datei Info.plist Ihrer App einen GADApplicationIdentifier-Schlüssel mit einem Stringwert Ihrer AdMob-App-ID hinzu.

Sie können diese Änderung programmatisch vornehmen:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Alternativ können Sie sie im Editor für Eigenschaftslisten bearbeiten:

Editor für Property-Listen

Schritt 3:Google Mobile Ads SDK hinzufügen

Da sich das Google Mobile Ads C++ SDK im Namespace firebase::gma befindet, laden Sie das Firebase C++ SDK herunter und entpacken Sie es in einem beliebigen Verzeichnis.

Das Firebase C++ SDK ist nicht plattformspezifisch, erfordert aber plattformspezifische Bibliothekskonfigurationen.

Android

  1. Geben Sie in der Datei gradle.properties Ihres Projekts den Speicherort des entzippten SDK an:

    systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK
  2. Fügen Sie der Datei settings.gradle Ihres Projekts den folgenden Inhalt hinzu:

    def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')
    
    gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
    includeBuild "$firebase_cpp_sdk_dir"
  3. Fügen Sie der Gradle-Datei des Moduls (auf Anwendungsebene, in der Regel app/build.gradle) den folgenden Inhalt hinzu, der die Bibliotheksabhängigkeit für das Google Mobile Ads C++ SDK enthält.

    android.defaultConfig.externalNativeBuild.cmake {
      arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
    }
    
    # Add the dependency for the Google Mobile Ads C++ SDK
    apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
    firebaseCpp.dependencies {
      gma
    }
  4. Fügen Sie der Datei CMakeLists.txt Ihres Projekts den folgenden Inhalt hinzu.

    # Add Firebase libraries to the target using the function from the SDK.
    add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)
    
    # Add the Google Mobile Ads C++ SDK.
    
    # The Firebase C++ library `firebase_app` is required,
    # and it must always be listed last.
    
    set(firebase_libs
      firebase_gma
      firebase_app
    )
    
    target_link_libraries(${target_name} "${firebase_libs}")
  5. Synchronisieren Sie Ihre App, damit für alle Abhängigkeiten die erforderlichen Versionen vorliegen.

Fertig! Ihre C++-App ist für die Verwendung des Google Mobile Ads C++ SDK konfiguriert.

iOS

Die Schritte in diesem Abschnitt zeigen ein Beispiel dafür, wie Sie das Google Mobile Ads C++ SDK in Ihr iOS-Projekt einbinden.

  1. Rufen Sie CocoaPods Version 1 oder höher ab, indem Sie Folgendes ausführen:

    sudo gem install cocoapods --pre
  2. Fügen Sie den Google Mobile Ads-Pod aus dem entpackten SDK hinzu.

    1. Erstellen Sie eine Podfile-Datei, falls keine vorhanden ist:

      cd YOUR_APP_DIRECTORY
      pod init
    2. Fügen Sie Ihrem Podfile den Pod für das Google Mobile Ads C++ SDK hinzu:

      pod 'Google-Mobile-Ads-SDK'
    3. Installieren Sie das Pod und öffnen Sie dann die Datei .xcworkspace in Xcode.

      pod install
      open YOUR_APP.xcworkspace
    4. Fügen Sie dem Projekt die folgenden Frameworks aus dem Firebase C++ SDK hinzu:

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

Fertig! Ihre C++-App ist für die Verwendung des Google Mobile Ads C++ SDK konfiguriert.

Schritt 4:Google Mobile Ads SDK initialisieren

Initialisieren Sie das Mobile Ads SDK vor dem Laden von Anzeigen, indem Sie firebase::gma::Initialize() aufrufen.

Dieser Aufruf gibt ein firebase::Future zurück, das abgeschlossen wird, sobald die Initialisierung abgeschlossen ist (oder nach einer 30-sekündigen Zeitüberschreitung). Rufen Sie diese Methode nur einmal und so früh wie möglich auf, idealerweise beim Start der App.

Hier ein Beispiel für den Aufruf von Initialize():

Android

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing dependency.
  // Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

iOS

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing dependency.
  // Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

Verwenden Sie ein Future, um den Abschlussstatus eines Methodenaufrufs zu überwachen.

Mit einem Future können Sie den Abschlussstatus Ihrer asynchronen Methodenaufrufe ermitteln.

Wenn Ihre App beispielsweise firebase::gma::Initialize() aufruft, wird ein neues firebase::Future erstellt und zurückgegeben. Ihre App kann dann den status() des Future abfragen, um festzustellen, wann die Initialisierung abgeschlossen ist. Anschließend kann Ihre App result() aufrufen, um die resultierende AdapterInitializationStatus abzurufen.

Methoden, die ein Future zurückgeben, haben eine entsprechende Methode für das letzte Ergebnis, mit der Apps das letzte Future für eine bestimmte Aktion abrufen können. firebase::gma::Initialize() hat beispielsweise eine entsprechende Methode namens firebase::gma::InitializeLastResult(), die ein Future zurückgibt, mit dem Ihre App den Status des letzten Aufrufs von firebase::gma::Initialize() prüfen kann.

Wenn der Status von Future „Abgeschlossen“ lautet und der zugehörige Fehlercode firebase::gma::kAdErrorCodeNone ist, wurde der Vorgang erfolgreich abgeschlossen.

Sie können auch Callbacks registrieren, die aufgerufen werden, wenn ein Future abgeschlossen ist. In einigen Fällen wird der Callback in einem anderen Thread ausgeführt. Achten Sie daher darauf, dass Ihr Code threadsicher ist. In diesem Code-Snippet wird ein Funktionszeiger für den Callback verwendet:

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
  /*user_data=*/nullptr);

// The OnCompletion callback function.
static void OnCompletionCallback(
  const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
  // Called when the Future is completed for the last call to firebase::gma::Initialize().
  // If the error code is firebase::gma::kAdErrorCodeNone,
  // then the SDK has been successfully initialized.
  if (future.error() == firebase::gma::kAdErrorCodeNone) {
    // success!
  } else {
    // failure.
  }
}

Schritt 5:Anzeigenformat für die Implementierung in Ihrer App auswählen

AdMob bietet eine Reihe verschiedener Anzeigenformate, sodass Sie das Format auswählen können, das am besten zur Nutzerfreundlichkeit Ihrer App passt. Klicken Sie auf eine Schaltfläche für ein Anzeigenformat, um eine detaillierte Implementierungsanleitung in der AdMob-Dokumentation aufzurufen.

Rechteckige Anzeigen, die oben oder unten auf dem Gerätebildschirm eingeblendet werden

Banneranzeigen bleiben auf dem Bildschirm, während Nutzer mit der App interagieren, und können nach einer bestimmten Zeit automatisch aktualisiert werden. Wenn Sie noch keine Erfahrung mit mobiler Werbung haben, sind sie ein guter Ausgangspunkt.

Banneranzeigen implementieren

Interstitial

Vollbildanzeigen, die die Benutzeroberfläche einer App überlagern, bis sie vom Nutzer geschlossen werden

Interstitial-Anzeigen sollten am besten an natürlichen Pausen im Ablauf einer App eingeblendet werden, z. B. zwischen den Levels eines Spiels oder direkt nach Abschluss einer Aufgabe.

Interstitial-Anzeigen implementieren

Mit Prämie

Anzeigenformat, bei dem Nutzer, die sich kurze Videos ansehen oder mit spielbaren Anzeigen oder Umfragen interagieren, mit Prämien belohnt werden

Anzeigen mit Prämie können zur Monetarisierung von Free-to-Play-Nutzern beitragen.

Anzeigen mit Prämie implementieren

Weitere Themen von Interesse

Nutzermesswerte und Analysedaten ansehen

Nach der Initialisierung beginnt das Mobile Ads SDK automatisch mit der Erfassung von Analytics-Ereignissen und Nutzerattributen aus Ihrer App. Sie können diese Daten ansehen, ohne zusätzlichen Code in Ihre App einzufügen oder Anzeigen zu implementieren. So rufen Sie diese Analysedaten auf:

Damit die Messwerte ARPU und ARPPU besser dargestellt werden, sollten Sie Daten aus einem benutzerdefinierten Analytics-Ereignis namens ecommerce_purchase in die Umsatzberechnung für diese Messwerte einbeziehen (weitere Informationen).

Optional: Weitere Funktionen von Google Analytics und Firebase nutzen

Sie haben mehr Möglichkeiten und Funktionen, um die App-Monetarisierung und Nutzerinteraktionen zu verbessern:

  • Firebase SDK für Google Analytics hinzufügen und verwenden

    Weitere Informationen finden Sie in der Anleitung zur Verwendung von Google Analytics und Firebase mit AdMob-Apps.

  • Andere Firebase-Produkte in Ihrer App verwenden

    Nachdem Sie das Firebase SDK für Google Analytics hinzugefügt haben, können Sie andere Firebase-Produkte verwenden, um Anzeigen in Ihrer App zu optimieren.

    • Mit Remote Config können Sie das Verhalten und die Darstellung Ihrer App ändern, ohne ein App-Update veröffentlichen zu müssen. Das ist kostenlos und für eine unbegrenzte Anzahl täglich aktiver Nutzer möglich.

    • Mit A/B Testing können Sie Änderungen an der Benutzeroberfläche, den Funktionen oder den Interaktionen Ihrer App testen, um herauszufinden, ob sie sich auf wichtige Messwerte wie Umsatz und Kundenbindung auswirken, bevor Sie die Änderungen einführen.