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 Version dieses Leitfadens AdMob mit Firebase.

Die Einbindung des Google Mobile Ads C++ SDK in eine App ist der erste Schritt, um Anzeigen auszuliefern und Einnahmen zu erzielen. Nachdem Sie das SDK eingebunden haben, können Sie ein Anzeigenformat wie Interstitial oder Anzeige 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, um asynchrone Vorgänge zu unterstützen. Es befindet sich daher im Namespace firebase::gma.

Wenn Sie diesen Leitfaden zum ersten Mal durchgehen, empfehlen wir Ihnen, die Google Mobile Ads C++-Test-App herunterzuladen und die Schritte darin nachzuvollziehen.

Vorbereitung

App in Ihrem AdMob-Konto einrichten

So registrieren Sie Ihre App als AdMob-App:

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

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 in ein Verzeichnis Ihrer Wahl.

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

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

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 beim Aufrufen von Initialize() über das Google Mobile Ads C++ SDK oder die SDKs von Vermittlungspartnern vorab geladen werden. Wenn Sie die Einwilligung von Nutzern im Europäischen Wirtschaftsraum (EWR) einholen, anfragespezifische Flags (z. B. tag_for_child_directed_treatment oder tag_for_under_age_of_consent) festlegen oder andere Maßnahmen ergreifen müssen, bevor Sie Anzeigen laden, rufen Sie firebase::gma::SetRequestConfiguration() auf, bevor Sie das Google Mobile Ads C++ SDK initialisieren. Weitere Informationen finden Sie in unserem Leitfaden zum Targeting.

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

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

// 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 Anwendung 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 „Letztes Ergebnis“-Methode, 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 Anwendung den Status des letzten Aufrufs von firebase::gma::Initialize() prüfen kann.

Wenn der Status von Future „Abgeschlossen“ lautet und der 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.
  }
}

Anzeigenformat auswählen

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

Banner

Rechteckige Anzeigen, die oben oder unten auf dem Bildschirm des Geräts 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 neu im Bereich der mobilen Werbung sind, sind sie ein guter Ausgangspunkt.

Banneranzeigen implementieren

Interstitial

Vollbildanzeigen, die die Benutzeroberfläche einer App überlagern, bis sie vom Nutzer geschlossen werden. Sie sollten am besten bei 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

Verfügbar

Anzeigen, die Nutzer mit Prämien belohnen, wenn sie sich Kurzvideos ansehen oder mit spielbaren Anzeigen und Umfragen interagieren. Wird für die Monetarisierung von Free-to-Play-Apps verwendet.

Anzeigen mit Prämie implementieren