Erste Schritte

Dieser Leitfaden richtet sich an Publisher, die eine C++-App mit AdMob monetarisieren möchten, ohne Firebase zu verwenden. Wenn Sie Firebase in Ihre App einbinden möchten oder dies erwägen, lesen Sie stattdessen die Version AdMob mit Firebase.

Um Anzeigen zu schalten und Umsätze zu generieren, müssen Sie zuerst das Google Mobile Ads C++ SDK in eine App einbinden. Nachdem Sie das SDK eingebunden haben, können Sie ein Anzeigenformat wie „Interstitial“ oder „Mit Prämie“ auswählen und dann den Schritten zur Implementierung folgen.

Das Google Mobile Ads C++ SDK umschließt das Google Mobile Ads SDK für iOS und Android und ist nur auf diesen Plattformen verfügbar. Das Google Mobile Ads C++ SDK nutzt Firebase C++-Konstrukte, um asynchrone Vorgänge zu unterstützen. Daher befindet es sich im Namespace firebase::gma.

Wenn Sie diesen Leitfaden zum ersten Mal durchgehen, sollten Sie die Test-App für Google Mobile Ads C++ herunterladen und der Anleitung folgen.

Voraussetzungen

Android

  • Android Studio 3.2 oder höher verwenden
  • Achten Sie darauf, dass die Build-Datei Ihrer App die folgenden Werte verwendet:
    • minSdkVersion von 16 oder höher
    • compileSdkVersion von 28 oder höher

iOS

  • Verwenden Sie Xcode 13 oder höher.
  • Ausrichtung auf iOS 10.0 oder höher

App in Ihrem AdMob-Konto einrichten

So registrieren Sie Ihre App als AdMob-App:

  1. Melden Sie sich in einem AdMob-Konto an oder registrieren Sie sich.

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

Google Mobile Ads C++ SDK installieren

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

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

Android

Wir empfehlen die Verwendung von CMake. Anleitungen für „ndk-build“ findest du aber in unserem allgemeinen Startleitfaden für Firebase C++ SDK, in dem du libfirebase_app.a und libfirebase_gma.a mit deiner App verknüpfst.

  1. Geben Sie in der Datei gradle.properties Ihres Projekts den Speicherort des entpackten 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 Ihres Moduls (auf App-Ebene) – normalerweise app/build.gradle – den folgenden Inhalt hinzu, einschließlich der Bibliotheksabhängigkeit für das Google Mobile Ads C++ SDK.

    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 Anwendung, damit alle Abhängigkeiten die erforderlichen Versionen haben.

iOS

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

  1. Laden Sie CocoaPods Version 1 oder höher herunter, indem Sie folgenden Befehl 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 Sie noch keine haben:

      cd APP_DIRECTORY
      pod init
      
    2. Fügen Sie der Podfile-Datei die Pods für das Google Mobile Ads C++ SDK, das Google User Messaging Platform SDK und das mindestens erforderliche Firebase Core SDK (erforderlich für das GMA C++ SDK) hinzu:

      pod 'Firebase/CoreOnly'
      pod 'Google-Mobile-Ads-SDK'
      pod 'GoogleUserMessagingPlatform'
      
    3. Installieren Sie die Pods und öffnen Sie dann die Datei .xcworkspace in Xcode.

      pod install
      open 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 so konfiguriert, dass sie das Google Mobile Ads C++ SDK ohne andere Firebase-Dienste verwendet.

AdMob-App-ID Ihrer App konfigurieren

Android

Führen Sie Schritt 3 des Artikels App konfigurieren aus, wie im Mobile Ads SDK-Leitfaden für Android beschrieben, und kehren Sie dann zu dieser Seite zurück.

iOS

Folgen Sie dem Schritt Info.plist-Datei aktualisieren, wie im Mobile Ads SDK-Leitfaden für iOS beschrieben, und kehren Sie dann zu dieser Seite zurück.

Google Mobile Ads SDK initialisieren

Bevor Anzeigen geladen werden, muss Ihre App das Google Mobile Ads C++ SDK initialisieren. Rufen Sie dazu firebase::gma::Initialize() auf. Dadurch wird das SDK initialisiert und firebase::Future wird abgeschlossen, sobald die Initialisierung abgeschlossen ist (oder nach einer Zeitüberschreitung von 30 Sekunden). Dies muss nur einmal erfolgen, idealerweise beim Start der App.

Anzeigen können durch das Google Mobile Ads C++ SDK oder durch Vermittlungspartner-SDKs vorab geladen werden, wenn Initialize() aufgerufen wird. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen, anfragespezifische Flags wie tag_for_child_directed_treatment oder tag_for_under_age_of_consent festlegen oder andere Maßnahmen vor dem Laden von Anzeigen ergreifen müssen, rufen Sie firebase::gma::SetRequestConfiguration() vor der Initialisierung des Google Mobile Ads C++ SDK auf. Weitere Informationen finden Sie in unserem Leitfaden zum Targeting.

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

Future verwenden, um den Abschlussstatus eines Methodenaufrufs zu überwachen

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

Wenn Ihre Anwendung beispielsweise firebase::gma::Initialize() aufruft, wird eine neue firebase::Future erstellt und zurückgegeben. Deine App kann dann status() von Future abfragen, um festzustellen, wann die Initialisierung abgeschlossen ist. Wenn der Vorgang abgeschlossen ist, kann die Anwendung result() aufrufen, um das resultierende AdapterInitializationStatus abzurufen.

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

Wenn der Status von Future abgeschlossen ist und der Fehlercode firebase::gma::kAdErrorCodeNone lautet, wurde der Vorgang erfolgreich abgeschlossen.

Du kannst auch Callbacks registrieren, die aufgerufen werden sollen, wenn ein Future abgeschlossen wurde. In einigen Fällen wird der Callback in einem anderen Thread ausgeführt. Achten Sie also darauf, dass der Code Thread-sicher ist. Dieses Code-Snippet verwendet einen Funktionszeiger für den Callback:

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

Anzeigenformat auswählen

Das Google Mobile Ads C++ SDK wurde importiert und Sie können eine Anzeige implementieren. AdMob bietet eine Reihe von verschiedenen Anzeigenformaten, sodass Sie das für die Nutzererfahrung Ihrer App am besten geeignete auswählen können.

Rechteckige Anzeigen, die oben oder unten auf dem Gerätebildschirm erscheinen. 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 nicht mit mobiler Werbung vertraut sind, sind sie ein guter Ausgangspunkt.

Banneranzeigen implementieren

Interstitial

Vollbildanzeigen, die die Benutzeroberfläche einer App verdecken, bis sie vom Nutzer geschlossen werden. Sie eignen sich am besten für natürliche Pausen im Ablauf der App-Ausführung, z. B. zwischen Levels eines Spiels oder kurz nach Abschluss einer Aufgabe.

Interstitial-Anzeigen implementieren

Verfügbar

Das sind Anzeigen, in denen Nutzer belohnt werden, wenn sie sich kurze Videos ansehen oder mit spielbaren Anzeigen und Umfragen interagieren. Wird für die Monetarisierung kostenloser Apps verwendet.

Anzeigen mit Prämie implementieren