Erste Schritte mit AdMob in Ihrem C++-Projekt

Sie können die iOS- und Android-SDKs von AdMob verwenden.

Dieser Schnellstart-Leitfaden richtet sich an Publisher und Entwickler, die AdMob verwenden möchten, um eine App zu monetarisieren, die mit Firebase erstellt wurde. Wenn Sie Firebase nicht in Ihre App einbinden möchten, lesen Sie stattdessen den eigenständigen AdMob Leitfaden.

Wenn Sie es noch nicht getan haben, informieren Sie sich über alle die Vorteile der gemeinsamen Verwendung von AdMob, Firebase, und Google Analytics.

Wenn Sie diesen Leitfaden zum ersten Mal lesen, empfehlen wir Ihnen, die Google Mobile Ads C++ SDK-Test Appherunterzuladen und zu verwenden.

Vorbereitung

• Wenn Sie noch kein Firebase-Projekt und keine Firebase-App haben, folgen Sie der Anleitung unter 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 Projekterstellungsprozesses.

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

Schritt 1: App in Ihrem AdMob Konto einrichten

1. Registrieren Sie jede Plattformvariante Ihrer App als eine AdMob-App.

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

   2. Registrieren Sie jede Plattformvariante Ihrer App bei AdMob. Bei 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, das Mobile Ads SDK zu Ihrer App 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 Apps Dashboard Ihres AdMobKontos aus:

   1. Aktivieren Nutzermesswerte , damit AdMob kuratierte Analysedaten in Ihrem AdMob Konto verarbeiten und anzeigen kann. Diese Einstellung ist auch erforderlich, um Ihre AdMob App mit Firebase zu verknüpfen.

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

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

Schritt 2: AdMob App-ID zu Ihrer App hinzufügen

Android

Fügen Sie Ihre AdMob App-ID der Datei AndroidManifest.xml Ihrer App hinzu, indem Sie das Tag <meta-data> 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 App einen Schlüssel GADApplicationIdentifier mit dem Stringwert Ihrer AdMob App-ID hinzu.

Sie können diese Änderung programmatisch vornehmen:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Oder bearbeiten Sie sie im Editor für Eigenschaftslisten:

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

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 Ihres 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 Ihre 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 zu Ihrem iOS-Projekt hinzufügen.

1. Rufen Sie CocoaPods Version 1 oder höher ab, indem Sie Folgendes 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 noch keine vorhanden ist:

      cd YOUR_APP_DIRECTORY
      pod init

   2. Fügen Sie Ihrer Podfile-Datei 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

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

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