Jetzt starten


Diese Anleitung 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 in Erwägung ziehen, lesen Sie stattdessen die AdMob-Version dieser Anleitung.

Um Anzeigen in Ihrer App zu präsentieren und damit Umsätze zu erzielen, müssen Sie als Erstes das Google Mobile Ads C++ SDK in die App einbinden. Anschließend können Sie ein Anzeigenformat wie Interstitial oder Anzeigen mit Prämie auswählen und die Schritte zur Implementierung ausführen.

Das Google Mobile Ads C++ SDK umschließt die Google Mobile Ads iOS- und Android-SDKs und ist nur auf diesen Plattformen verfügbar. Das Google Mobile Ads C++ SDK verwendet Firebase C++-Konstrukte zur Unterstützung asynchroner Vorgänge und befindet sich daher im Namespace firebase::gma.

Wenn Sie diese Anleitung zum ersten Mal lesen, empfehlen wir Ihnen, die Google Mobile Ads C++-Test App herunterzuladen und die Schritte darin auszuführen.

Vorbereitung

Android

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

iOS

  • Verwenden Sie Xcode 13 oder höher.
  • Richten Sie Ihre App auf iOS 10.0 oder höher aus.

App in Ihrem AdMob-Konto einrichten

Registrieren Sie Ihre App als AdMob-App. Führen Sie dazu die folgenden Schritte aus:

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

  2. Registrieren Sie Ihre App bei AdMob. Dadurch wird eine AdMob App mit einer eindeutigen AdMob-App-ID erstellt, die später in dieser Anleitung benötigt wird.

Google Mobile Ads C++ SDK installieren

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

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

Android

Wir empfehlen die Verwendung von CMake. Eine Anleitung für ndk-build finden Sie in unserer allgemeinen Anleitung zum Einstieg in das Firebase C++ SDK. Dort wird beschrieben, wie Sie libfirebase_app.a und libfirebase_gma.a mit Ihrer App verknüpfen.

  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, in der Regel app/build.gradle) den folgenden Inhalt hinzu. Er enthält die 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 App, damit für alle Abhängigkeiten die erforderlichen Versionen vorliegen.

iOS

Die Schritte in diesem Abschnitt sind ein Beispiel dafür, wie Sie das Google Mobile Ads C++ SDK zu Ihrem iOS-Projekt hinzufügen.

  1. Rufen Sie CocoaPods Version 1 oder höher auf:

    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 noch keine vorhanden ist:

      cd APP_DIRECTORY
pod init

    2. Fügen Sie Ihrer Podfile-Datei die Pods für das Google Mobile Ads C++ SDK, das Google User Messaging Platform SDK und das minimale Firebase Core SDK hinzu (erforderlich für das GMA C++ SDK):

      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 unter App konfigurieren aus, wie in der Mobile Ads SDK Android-Anleitung beschrieben, und kehren Sie dann zu dieser Seite zurück.

iOS

Führen Sie den Schritt Info.plist aktualisieren aus, wie in der Anleitung zum Mobile Ads SDK für iOS beschrieben, und kehren Sie dann zu dieser Seite zurück.

Google Mobile Ads SDK initialisieren

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

Anzeigen können vom Google Mobile Ads C++ SDK oder von SDKs von Vermittlungspartnern vorab geladen werden, wenn Initialize() aufgerufen wird. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen, anfragespezifische Flags festlegen (z. B. tag_for_child_directed_treatment oder tag_for_under_age_of_consent) oder andere Maßnahmen ergreifen müssen, bevor Sie Anzeigen laden, müssen Sie dies tun, indem Sie firebase::gma::SetRequestConfiguration() aufrufen, bevor Sie das Google Mobile Ads C++ SDK initialisieren. Weitere Informationen finden Sie in unserer Anleitung zum Targeting.

Hier ist ein Beispiel dafür, wie Sie Initialize() aufrufen:

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 beobachten

Mit 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() von Future abfragen, um zu ermitteln, wann die Initialisierung abgeschlossen ist. Sobald die Initialisierung abgeschlossen ist, kann Ihre App result() aufrufen, um den resultierenden AdapterInitializationStatus zu erhalten.

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. Für firebase::gma::Initialize() gibt es beispielsweise die entsprechende Methode 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 ist und der Fehlercode firebase::gma::kAdErrorCodeNone lautet, 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.
  }
}

Anzeigenformat auswählen

Das Google Mobile Ads C++ SDK wurde jetzt importiert und Sie können eine Anzeige implementieren. AdMob bietet eine Reihe verschiedener Anzeigenformate, sodass Sie das Format auswählen können, das am besten zur Nutzererfahrung Ihrer App passt.

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. Sie eignen sich am besten für natürliche Pausen im Ablauf einer App, z. B. zwischen den Levels eines Spiels oder direkt nach Abschluss einer Aufgabe.

Interstitial-Anzeigen implementieren

Verfügbar

Anzeigenformat, bei dem Nutzer, die sich kurze Videos ansehen oder mit spielbaren Anzeigen oder Umfragen interagieren, mit Prämien belohnt werden. Wird zur Monetarisierung von kostenlosen Apps verwendet.

Anzeigen mit Prämie implementieren