Commencer

Pour afficher des annonces et générer des revenus, vous devez commencer par intégrer le SDK Google Mobile Ads dans une application. Une fois le SDK intégré, vous pouvez choisir un format d'annonce (annonce vidéo native ou avec récompense, par exemple) et suivre les étapes pour l'implémenter.

Avant de commencer

Pour préparer votre application, procédez comme indiqué dans les sections suivantes.

Conditions requises pour l'application

  • Assurez-vous que le fichier de compilation de votre application utilise les valeurs suivantes :

    • minSdkVersion égal à 19 ou plus
    • compileSdkVersion égal à 33 ou plus

Configurer votre application dans votre compte AdMob

Enregistrez votre application en tant qu'application AdMob en procédant comme suit:

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

  2. Enregistrez votre application auprès d'AdMob. Cette étape permet de créer une application AdMob avec un ID d'application AdMob unique dont vous aurez besoin ultérieurement dans ce guide.

Configurer votre application

  1. Dans le fichier build.gradle au niveau du projet, incluez le dépôt Maven de Google et le dépôt central Maven dans vos sections buildscript et allprojects:

    buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

  2. Ajoutez les dépendances du SDK Google Mobile Ads au fichier Gradle au niveau de l'application de votre module, normalement app/build.gradle:

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:22.5.0'
}

  3. Ajoutez l' AdMob ID de votre application, tel qu'identifié dans l'interface WebAdMob, au fichier AndroidManifest.xml de votre application. Pour ce faire, ajoutez une balise <meta-data> avec android:name="com.google.android.gms.ads.APPLICATION_ID". Vous trouverez l'ID de votre application dans l' AdMob interface Web. Pour android:value, insérez votre propre AdMob ID d'application, en l'entourant de guillemets.

    <manifest>
  <application>
    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

    Dans une application réelle, utilisez votre ID AdMob d'application réel, et non celui indiqué ci-dessus. Si vous souhaitez simplement tester le SDK dans une application Hello World, vous pouvez utiliser l'ID d'application exemple présenté ci-dessus.

    Notez également que l'échec de l'ajout de la balise <meta-data> comme indiqué ci-dessus entraîne un plantage avec le message:

    The Google Mobile Ads SDK was initialized incorrectly.

    (Facultatif) Déclarez l'autorisation AD_ID pour que les versions précédentes fonctionnent avec Android 13.

    Si votre application utilise la version 20.4.0 ou ultérieure du SDK Google Mobile Ads, vous pouvez ignorer cette étape. En effet, le SDK déclare automatiquement l'autorisation com.google.android.gms.permission.AD_ID et peut accéder à l'identifiant publicitaire lorsqu'il est disponible.

    Pour les applications qui utilisent la version 20.3.0 ou antérieure du SDK Google Mobile Ads et qui ciblent Android 13, vous devez ajouter l'autorisation com.google.android.gms.permission.AD_ID dans le fichier AndroidManifest.xml pour que le SDK Google Mobile Ads puisse accéder à l'identifiant publicitaire:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    Pour en savoir plus sur la déclaration d'autorisation com.google.android.gms.permission.AD_ID et découvrir comment la désactiver, consultez cet article de la Play Console.

Initialiser le SDK Google Mobile Ads

Avant de charger des annonces, demandez à votre application d'initialiser le SDK Google Mobile Ads en appelant MobileAds.initialize(), qui initialise le SDK et appelle un écouteur de lecture complète une fois l'initialisation terminée ou après un délai de 30 secondes. Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application.

Les annonces peuvent être préchargées par le SDK Google Mobile Ads ou les SDK des partenaires de médiation lors de l'appel de MobileAds.initialize(). Si vous devez obtenir le consentement des utilisateurs de l'Espace économique européen (EEE), définissez des options propres aux demandes, telles que tagForChildDirectedTreatment ou tag_for_under_age_of_consent, ou prenez des mesures avant de charger des annonces. Assurez-vous de le faire avant d'initialiser le SDK Google Mobile Ads.

Voici un exemple d'appel de la méthode initialize() dans une activité:

Exemple de MainActivity (extrait)

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}
    }
}

Si vous utilisez la médiation, attendez que le gestionnaire d'achèvement soit appelé avant de charger les annonces, car cela garantira que tous les adaptateurs de médiation seront initialisés.

Sélectionnez un format d'annonce

Le SDK Google Mobile Ads est maintenant importé et vous êtes prêt à intégrer une annonce. AdMob propose de nombreux formats d'annonces différents. Vous pouvez donc choisir celui qui correspond le mieux à l'expérience utilisateur de votre application.

Annonces rectangulaires qui s'affichent en haut ou en bas de l'écran de l'appareil. Les bannières restent à l'écran pendant que 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, elle constitue un excellent point de départ.

Implémenter des bannières

Interstitiel

Annonces plein écran qui couvrent l'interface d'une application jusqu'à ce qu'elle soit fermée par l'utilisateur. Il est préférable de les utiliser lors de pauses naturelles dans le flux d'exécution d'une application, par exemple entre deux niveaux d'un jeu ou juste après la fin d'une tâche.

Implémenter des annonces interstitielles

Natif

Annonces personnalisables qui correspondent à l'apparence de votre application. C'est vous qui décidez de leur emplacement et de leur emplacement, afin que leur mise en page soit plus cohérente avec l'interface de votre application.

Intégrer des annonces natives

Accordé

Annonces qui récompensent les utilisateurs lorsqu'ils regardent de courtes vidéos et interagissent avec des annonces jouables et des enquêtes. Utilisé pour la monétisation des applications sans frais

Implémenter des annonces avec récompense

Ressources supplémentaires

Le dépôt Google Mobile Ads sur GitHub explique comment utiliser les différents formats d'annonces proposés par cette API.