Jetzt starten

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 oder sehen Sie sich die AdMob- und Firebase-Version davon Anleitung.

Die Integration des Google Mobile Ads C++ SDK in eine App ist der erste Schritt zur Anzeigen schalten und Einnahmen erzielen. Nach der Integration des SDK können Sie wählen Sie ein Anzeigenformat aus, z. B. „Interstitial“ oder „Mit Prämie“, und folgen Sie der Anleitung, um sie zu implementieren.

Das Google Mobile Ads C++ SDK umschließt die Google Mobile Ads SDKs für iOS und Android und ist nur auf diesen Plattformen verfügbar. Mit dem Google Mobile Ads C++ SDK Verwendung von Firebase C++ Konstrukten zur Unterstützung asynchroner Vorgänge, sodass sie im Namespace firebase::gma.

Wenn Sie diesen Leitfaden zum ersten Mal durchgehen, sollten Sie Laden Sie den C++ Test für Google Mobile Anzeigen App.

Vorbereitung

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 App mit einer eindeutigen AdMob-App-ID die wir später in diesem Leitfaden benötigen.

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 beliebiges Verzeichnis.

Das Firebase C++ SDK ist nicht plattformspezifisch, erfordert aber plattformspezifischen Bibliothekskonfigurationen zu erstellen.

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

AdMob-App-ID der App konfigurieren

Google Mobile Ads SDK initialisieren

Bevor Anzeigen geladen werden, muss Ihre App das Google Mobile Ads C++ SDK initialisieren, indem Sie Aufrufen von firebase::gma::Initialize(), wodurch das SDK initialisiert und ein firebase::Future nach Abschluss der Initialisierung (oder nach 30 Sekunden Zeitüberschreitung). Dies muss nur einmal erfolgen, idealerweise beim Starten der App.

Anzeigen können vom Google Mobile Ads C++ SDK oder von den SDKs von Vermittlungspartnern 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 setzen oder vor dem Laden von Anzeigen andere Maßnahmen ergreifen müssen, 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 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.
}

Mit Future den Abschlussstatus eines Methodenaufrufs überwachen

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

Wenn Ihre App beispielsweise firebase::gma::Initialize() aufruft, wird eine neue firebase::Future wird 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 das resultierende AdapterInitializationStatus.

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

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

Sie können auch Callbacks registrieren, die aufgerufen werden, wenn eine Future abgeschlossen ist. In wird der Callback in einem anderen Thread ausgeführt. ist der Code threadsicher. In diesem Code-Snippet wird ein Funktionszeiger für den Rückruf 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 Nutzerfreundlichkeit 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. 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 verdecken, bis sie vom Nutzer geschlossen werden. Sie werden am besten bei natürlichen Pausen während der Ausführung einer App eingesetzt, z. B. zwischen den Leveln eines Spiels oder direkt nach Erledigung 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 kostenloser Apps verwendet.

Anzeigen mit Prämie implementieren