Erste Schritte mit AdMob in Ihrem C++-Projekt


Diese Kurzanleitung richtet sich an Publisher und Entwickler, die AdMob verwenden möchten, um eine mit Firebase erstellte App zu monetarisieren. Wenn Sie Firebase nicht in Ihre App einbinden möchten, lesen Sie stattdessen den AdMobAdMob-Leitfaden.

Falls noch nicht geschehen, informieren Sie sich über die Vorteile der gemeinsamen Verwendung von AdMob, Firebase und Google Analytics.

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

Hinweis

  • Wenn Sie noch kein Firebase-Projekt und keine Firebase-App haben, folgen Sie der Anleitung zum Einstieg in Firebase: 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 des Projekterstellungsworkflows.

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

Schritt 1: App in deinem AdMob-Konto einrichten

  1. Registriere jede Plattformvariante deiner App als AdMob-App.

    1. Melden Sie sich an oder erstellen erstellen Sie 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, Ihrer App das Mobile Ads SDK hinzuzufügen. Eine detaillierte Anleitung dazu 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 der Aktivierung von Nutzermesswerten und der Verknüpfung Ihrer AdMob-Apps mit Firebase.

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

    1. Aktivieren Sie Nutzermesswerte, damit AdMob ausgewählte Analysedaten in Ihrem AdMob-Konto verarbeiten und anzeigen kann. Außerdem ist diese Einstellung erforderlich, um Ihre AdMob-App mit Firebase zu verknüpfen.

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

      Geben Sie denselben Paketnamen (Android) oder dieselbe Bundle-ID (iOS) ein, die Sie für Ihre Firebase-App verwendet haben. Sie finden den Paketnamen oder die Bundle-ID Ihrer Firebase-App auf der Karte Meine Apps Ihres  > Projekteinstellungen.

Schritt 2: App-ID von AdMob der App hinzufügen

Android

Fügen Sie der Datei AndroidManifest.xml Ihrer App die AdMob-App-ID hinzu, indem Sie das <meta-data>-Tag wie unten gezeigt hinzufü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 Anwendung einen GADApplicationIdentifier-Schlüssel mit einem Stringwert Ihrer AdMob-App-ID hinzu.

Du kannst 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 die Eigenschaftenliste bearbeiten:

Bearbeiter von Property-Listen

Schritt 3: Google Mobile Ads SDK hinzufügen

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 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 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 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 die 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 sind ein Beispiel dafür, wie Sie das Google Mobile Ads C++ SDK Ihrem iOS-Projekt hinzufügen.

  1. Führen Sie folgenden Befehl aus, um CocoaPods Version 1 oder höher abzurufen:

    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 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 den 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, bevor Sie Anzeigen laden, indem Sie firebase::gma::Initialize() aufrufen.

Dieser Aufruf gibt eine firebase::Future zurück, die 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 Starten 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.
}

Mit Future den Abschlussstatus eines Methodenaufrufs überwachen

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

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

Methoden, die eine Future zurückgeben, haben eine entsprechende Methode „Letztes Ergebnis“, mit der Apps die neueste Future für eine bestimmte Aktion abrufen können. 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 ist und der Fehlercode firebase::gma::kAdErrorCodeNone lautet, wurde der Vorgang erfolgreich abgeschlossen.

Sie können auch Callbacks registrieren, die aufgerufen werden, wenn eine Future abgeschlossen ist. In einigen Fällen wird der Rückruf 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 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.
  }
}

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 in der AdMob-Dokumentation eine detaillierte Implementierungsanleitung aufzurufen.

Rechteckige Anzeigen, die oben oder unten auf dem Display 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 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 eignen sich am besten für natürliche Pausen bei der Ausführung einer App, z. B. zwischen den Levels eines Spiels oder kurz nach Abschluss einer Aufgabe.

Interstitial-Anzeigen implementieren

Mit Prämie

Anzeigen, bei denen Nutzer für das Ansehen von Kurzvideos und die Interaktion mit spielbaren Anzeigen und Umfragen belohnt werden

Anzeigen mit Prämie (oder „prämienbasiert“) eignen sich gut zur Monetarisierung von Free-to-Play-Nutzern.

Anzeigen mit Prämie implementieren

Weitere Interessensgebiete

Nutzermesswerte und Analysedaten ansehen

Nach der Initialisierung des Mobile Ads SDK werden automatisch Analytics-Ereignisse und Nutzereigenschaften aus Ihrer App protokolliert. Sie können diese Daten aufrufen, ohne zusätzlichen Code in Ihre App einzufügen oder Anzeigen zu implementieren. Hier können Sie diese Analysedaten einsehen:

Damit ARPU- und ARPPU-Messwerte besser dargestellt werden können, 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 verwenden

Sie haben mehr Möglichkeiten und Funktionen, um die App-Monetarisierung und die 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 kannst du das Verhalten und Erscheinungsbild deiner App für unbegrenzte, täglich aktive Nutzer kostenlos ändern, ohne ein App-Update zu veröffentlichen.

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