Premiers pas avec AdMob dans votre projet C++

Ce guide de démarrage rapide s'adresse aux éditeurs et aux développeurs qui souhaitent utiliser AdMob pour monétiser une application créée avec Firebase. Si vous ne prévoyez pas d'inclure Firebase dans votre application, consultez plutôt le guide AdMob autonome .

Si vous ne l'avez pas encore fait, découvrez tous les avantages de l'utilisation conjointe d'AdMob, Firebase et Google Analytics.

Si c'est la première fois que vous consultez ce guide, nous vous recommandons de télécharger et de suivre en utilisant l' application de test du SDK C++ de Google Mobile Ads .

Avant que tu commences

  • Si vous n'avez pas encore de projet Firebase ni d'application Firebase, suivez le guide de démarrage de Firebase : Ajoutez Firebase à votre projet C++ .

  • Assurez-vous que Google Analytics est activé dans votre projet Firebase :

    • Si vous créez un nouveau projet Firebase, activez Google Analytics pendant le workflow de création du projet.

    • Si vous disposez d'un projet Firebase existant sur lequel Google Analytics n'est pas activé, vous pouvez activer Google Analytics à partir de l'onglet Intégrations de votre > Paramètres du projet .

Étape 1 : Configurez votre application dans votre compte AdMob

  1. Enregistrez chaque variante de plate-forme de votre application en tant qu'application AdMob.

    1. Connectez-vous ou créez un compte AdMob.

    2. Enregistrez chaque variante de plate-forme de votre application auprès d'AdMob . Cette étape crée une application AdMob avec un identifiant d'application AdMob unique dont vous aurez besoin plus loin dans ce guide.

    Il vous sera demandé d'ajouter le SDK Mobile Ads à votre application. Trouvez des instructions détaillées pour cette tâche plus loin dans ce guide.

  2. Associez chacune de vos applications AdMob à l'application Firebase correspondante.

    Cette étape est facultative mais fortement recommandée. Découvrez les avantages de l'activation des statistiques utilisateur et de l'association de vos applications AdMob à Firebase.

    Pour chaque variante de plate-forme, effectuez les deux étapes suivantes dans le tableau de bord des applications de votre compte AdMob :

    1. Activez les statistiques utilisateur pour permettre à AdMob de traiter et d'afficher des données analytiques sélectionnées dans votre compte AdMob. Il s'agit également d'un paramètre obligatoire pour associer votre application AdMob à Firebase.

    2. Associez votre application AdMob à votre projet Firebase existant et à l'application Firebase correspondante.

      Assurez-vous de saisir le même nom de package (Android) ou le même ID de package (iOS) que celui que vous avez saisi pour votre application Firebase. Recherchez le nom du package ou l'ID du package de votre application Firebase dans la fiche Vos applications de votre > Paramètres du projet .

Étape 2 : Ajoutez votre identifiant d'application AdMob à votre application

Android

Ajoutez votre identifiant d'application AdMob au fichier AndroidManifest.xml de votre application en ajoutant la balise <meta-data> comme indiqué ci-dessous.

<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

Dans le fichier Info.plist de votre application, ajoutez une clé GADApplicationIdentifier avec une valeur de chaîne correspondant à votre ID d'application AdMob .

Vous pouvez effectuer cette modification par programme :

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

Ou modifiez-le dans l'éditeur de liste de propriétés :

Éditeur de liste de propriétés

Étape 3 : Ajoutez le SDK Google Mobile Ads

Étant donné que le SDK C++ de Google Mobile Ads réside dans l'espace de noms firebase::gma , téléchargez le SDK Firebase C++ , puis décompressez-le dans le répertoire de votre choix.

Le SDK Firebase C++ n'est pas spécifique à la plate-forme, mais il nécessite des configurations de bibliothèque spécifiques à la plate-forme.

Android

  1. Dans le fichier gradle.properties de votre projet, spécifiez l'emplacement du SDK décompressé :

    systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK
  2. Au fichier settings.gradle de votre projet, ajoutez le contenu suivant :

    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. À votre fichier Gradle de module (au niveau de l'application) (généralement app/build.gradle ), ajoutez le contenu suivant, qui inclut la dépendance de bibliothèque pour le SDK C++ de Google Mobile Ads.

    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. Au fichier CMakeLists.txt de votre projet, ajoutez le contenu suivant.

    # 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. Synchronisez votre application pour vous assurer que toutes les dépendances disposent des versions nécessaires.

Vous êtes prêt ! Votre application C++ est configurée pour utiliser le SDK C++ de Google Mobile Ads.

IOS

Les étapes de cette section sont un exemple de la façon d'ajouter le SDK Google Mobile Ads C++ à votre projet iOS.

  1. Obtenez CocoaPods version 1 ou ultérieure en exécutant :

    sudo gem install cocoapods --pre
  2. Ajoutez le module Google Mobile Ads à partir du SDK décompressé.

    1. Créez un Podfile si vous n'en avez pas déjà un :

      cd YOUR_APP_DIRECTORY
      pod init
    2. À votre Podfile, ajoutez le pod pour le SDK Google Mobile Ads C++ :

      pod 'Google-Mobile-Ads-SDK'
    3. Installez le pod, puis ouvrez le fichier .xcworkspace dans Xcode.

      pod install
      open YOUR_APP.xcworkspace
    4. Ajoutez les frameworks suivants du SDK Firebase C++ au projet :

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

Vous êtes prêt ! Votre application C++ est configurée pour utiliser le SDK C++ de Google Mobile Ads.

Étape 4 : Initialisez le SDK Google Mobile Ads

Avant de charger des annonces, initialisez le SDK Mobile Ads en appelant firebase::gma::Initialize() .

Cet appel renvoie un firebase::Future qui se termine une fois l'initialisation terminée (ou après un délai d'attente de 30 secondes). Appelez cette méthode une seule fois et le plus tôt possible, idéalement au lancement de l'application.

Voici un exemple de la façon d'appeler 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.
}

Utiliser un Future pour surveiller l'état d'achèvement d'un appel de méthode

Un Future vous offre un moyen de déterminer l'état d'achèvement de vos appels de méthode asynchrone.

Par exemple, lorsque votre application appelle firebase::gma::Initialize() , un nouveau firebase::Future est créé et renvoyé. Votre application peut ensuite interroger le status() du Future pour déterminer quand l'initialisation est terminée. Une fois terminée, votre application peut appeler result() pour obtenir le AdapterInitializationStatus résultant.

Les méthodes qui renvoient un Future ont une méthode correspondante de « dernier résultat » que les applications peuvent utiliser pour récupérer le Future le plus récent pour une action donnée. Par exemple, firebase::gma::Initialize() a une méthode correspondante appelée firebase::gma::InitializeLastResult() , qui renvoie un Future que votre application peut utiliser pour vérifier l'état du dernier appel à firebase::gma::Initialize() .

Si l'état du Future est terminé et que son code d'erreur est firebase::gma::kAdErrorCodeNone , alors l'opération s'est terminée avec succès.

Vous pouvez également enregistrer des rappels à appeler lorsqu'un Future est terminé. Dans certains cas, le rappel s'exécutera dans un thread différent, alors assurez-vous que votre code est thread-safe. Cet extrait de code utilise un pointeur de fonction pour le rappel :

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

Étape 5 : Choisissez un format d'annonce à mettre en œuvre dans votre application

AdMob propose un certain nombre de formats d'annonces différents. Vous pouvez donc choisir celui qui correspond le mieux à l'expérience utilisateur de votre application. Cliquez sur le bouton d'un format d'annonce pour afficher les instructions détaillées de mise en œuvre dans la documentation AdMob.

Annonces rectangulaires qui apparaissent en haut ou en bas de l'écran de l'appareil

Les bannières publicitaires restent à l'écran pendant que les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement après un certain temps. Si vous débutez dans la publicité mobile, c'est un excellent point de départ.

Mettre en œuvre des bannières publicitaires

Interstitiel

Annonces plein écran qui couvrent l'interface d'une application jusqu'à sa fermeture par l'utilisateur

Il est préférable d'utiliser les publicités interstitielles lors des pauses naturelles dans le flux d'exécution d'une application, par exemple entre les niveaux d'un jeu ou juste après la fin d'une tâche.

Mettre en œuvre des annonces interstitielles

Récompensé

Annonces qui récompensent les utilisateurs qui regardent de courtes vidéos et interagissent avec des annonces et des enquêtes jouables

Les publicités avec récompense (ou « basées sur les récompenses ») peuvent aider à monétiser les utilisateurs free-to-play.

Mettre en œuvre des annonces avec récompense

Autres sujets d'intérêt

Afficher les métriques utilisateur et les données analytiques

Après son initialisation, le SDK Mobile Ads démarre automatiquement la journalisation des événements d'analyse et des propriétés utilisateur à partir de votre application. Vous pouvez afficher ces données sans ajouter de code supplémentaire à votre application ni mettre en œuvre d'annonces. Voici où vous pouvez voir ces données analytiques :

Notez que pour mieux représenter les métriques ARPU et ARPPU , vous souhaiterez peut-être inclure les données d'un événement d'analyse personnalisé appelé ecommerce_purchase dans le calcul des revenus pour ces métriques ( découvrez comment ).

(Facultatif) Utilisez davantage de fonctionnalités de Google Analytics et Firebase

Profitez de davantage d'opportunités et de fonctionnalités pour améliorer la monétisation des applications et l'engagement des utilisateurs :