Premiers pas avec AdMob dans votre projet C++

pensez à utiliser les SDK iOS et Android d'AdMob.


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 ce n'est pas déjà fait, découvrez tous les avantages à utiliser AdMob, Firebase et Google Analytics ensemble.

Si vous consultez ce guide pour la première fois, nous vous recommandons de le télécharger et de le suivre à l'aide de l'application de test du SDK C++ Google Mobile Ads.

Avant de commencer

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

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

    • S'il s'agit d'un nouveau projet Firebase, activez Google Analytics pendant que vous le créez.

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

É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 inscrivez-vous pour créer un compte AdMob.

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

    Vous serez invité à ajouter le SDK Mobile Ads à votre application. Vous trouverez 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 vivement recommandée. Découvrez les avantages de l'activation des métriques 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 Applications de votre compte AdMob :

    1. Activez les métriques 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 du bundle (iOS) que celui que vous avez saisi pour votre application Firebase. Pour trouver le nom de package ou l'ID du bundle de votre application Firebase, consultez la fiche Vos applications dans > Paramètres du projet.

Étape 2 : Ajoutez l'ID de votre application AdMob à votre application

Android

Ajoutez votre ID 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 à l'ID de votre application AdMob.

Vous pouvez effectuer cette modification de manière programmatique :

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

Vous pouvez également le modifier 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 Google Mobile Ads C++ se trouve 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 C++ Firebase n'est pas spécifique à une 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. Ajoutez le contenu suivant au fichier settings.gradle de votre projet :

    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. Dans le fichier Gradle de votre 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 Google Mobile Ads C++.

    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. Ajoutez le contenu suivant au fichier CMakeLists.txt de votre projet.

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

C’est terminé ! Votre application C++ est configurée pour utiliser le SDK C++ Google Mobile Ads.

iOS

Les étapes de cette section montrent comment ajouter le SDK Google Mobile Ads C++ à votre projet iOS.

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

    sudo gem install cocoapods --pre

  2. Ajoutez le pod Google Mobile Ads à partir du SDK décompressé.

    1. Créez un fichier Podfile si vous n'en possédez pas :

      cd YOUR_APP_DIRECTORY
pod init

    2. Ajoutez le pod pour le SDK Google Mobile Ads C++ à votre fichier Podfile :

      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

C’est terminé ! Votre application C++ est configurée pour utiliser le kit de développement logiciel (SDK) C++ de Google Mobile Ads.

Étape 4 : Initialiser 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 de 30 secondes). N'appelez cette méthode qu'une seule fois et le plus tôt possible, idéalement au lancement de l'application.

Voici un exemple d'appel de 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.
}

Utilisez un Future pour surveiller l'état d'exécution d'un appel de méthode.

Un Future vous permet de déterminer l'état d'achèvement de vos appels de méthode asynchrones.

Par exemple, lorsque votre application appelle firebase::gma::Initialize(), un 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 cette opération terminée, votre application peut appeler result() pour obtenir le AdapterInitializationStatus résultant.

Les méthodes qui renvoient un Future ont une méthode "dernier résultat" correspondante 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() possède 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 de Future est "Terminé" et que son code d'erreur est firebase::gma::kAdErrorCodeNone, 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. Assurez-vous donc 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 à implémenter dans votre application

AdMob propose différents formats d'annonces. Vous pouvez ainsi choisir celui qui correspond le mieux à l'expérience utilisateur de votre application. Cliquez sur un bouton de format d'annonce pour afficher des instructions d'implémentation détaillées dans la documentation AdMob.

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

Les bannières restent à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement au bout d'un certain temps. Si vous débutez dans la publicité mobile, elles constituent un excellent point de départ.

Intégrer des bannières publicitaires

Interstitiel

Publicités plein écran qui recouvrent l'interface d'une application jusqu'à ce que l'utilisateur les ferme.

Les publicités interstitielles sont plus efficaces lors des pauses naturelles dans le déroulement d'une application, par exemple entre les niveaux d'un jeu ou juste après l'achèvement d'une tâche.

Implémenter les publicités interstitielles

Avec récompense

Des publicités qui récompensent les utilisateurs pour le visionnage de courtes vidéos et leur interaction avec des publicités interactives et des sondages.

Les publicités récompensées (ou « à récompense ») peuvent contribuer à monétiser les utilisateurs de jeux sans frais.

Mettre en œuvre des publicités récompensées

Autres sujets d'intérêt

Consultez les statistiques et les données analytiques des utilisateurs

Après son initialisation, leMobile Ads Le SDK démarre automatiquement l'enregistrement des données analytiques. événements etpropriétés de l'utilisateur Depuis votre application, vous pouvez consulter ces données sans ajouter de code supplémentaire ni intégrer de publicités. Vous pouvez consulter ces données analytiques ici :

Notez que pour mieux représenter les indicateurs ARPU et ARPPU, vous pouvez inclure les données d'un événement analytique custom appelé ecommerce_purchase dans le calcul des revenus pour ces indicateurs (apprendre 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 de votre application et l'engagement des utilisateurs :

  • Ajoutez et utilisez le SDK Firebase pour Google Analytics

    Pour en savoir plus, consultez le guide sur l'utilisation de Google Analytics et de Firebase avec les applications AdMob.

  • Utiliser d'autres produits Firebase dans votre application

    Après avoir ajouté le SDK Firebase pour Google Analytics, utilisez d'autres produits Firebase pour optimiser les annonces dans votre application.

    • Remote Config vous permet de modifier le comportement et l'apparence de votre application sans publier de mise à jour, sans frais et pour un nombre illimité d'utilisateurs actifs par jour.

    • A/B Testing vous permet de tester les modifications apportées à l'UI, aux fonctionnalités ou aux campagnes axées sur l'engagement de votre application afin de déterminer si elles ont un impact sur vos métriques clés (comme les revenus et la fidélisation) avant de les déployer à grande échelle.