Commencer

L'intégration du SDK Google Mobile Ads dans une application constitue la première étape pour diffuser des annonces et générer des revenus. Une fois le SDK intégré, vous pouvez choisir un format d'annonce (par exemple, vidéo native ou avec récompense) et suivre les étapes indiquées.

Avant de commencer

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

Prérequis pour l'application

  • Utilisez Android Studio 3.2 ou version ultérieure

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

    • minSdkVersion d'au moins 19
    • compileSdkVersion d'au moins 28

Configurer votre application dans votre compte AdMob

Pour enregistrer votre application en tant qu'application AdMob, procédez comme suit:

  1. Connectez-vous ou inscrivez-vous à 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, nécessaire plus loin 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 les sections buildscript et allprojects:

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

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

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

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

  3. Ajoutez l' AdMob identifiant de votre application (identifié dans l'interface utilisateurAdMob) au fichier AndroidManifest.xml de votre application. Pour ce faire, ajoutez un tag <meta-data> avec android:name="com.google.android.gms.ads.APPLICATION_ID". Vous trouverez l'ID de votre application dans l' AdMob interface utilisateur. Pour android:value, insérez votre propre AdMob ID d'application, entouré 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'exemple d'ID d'application présenté ci-dessus.

    Notez également que l'échec de l'ajout de la balise <meta-data> comme indiqué ci-dessus entraîne le plantage du 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 une version ultérieure du SDK Google Mobile Ads, vous pouvez ignorer cette étape, car le SDK déclare automatiquement l'autorisation com.google.android.gms.permission.AD_ID et peut accéder à l'identifiant publicitaire dès qu'il est disponible.

    Pour les applications qui utilisent la version 20.3.0 (ou une version antérieure) du SDK Google Mobile Ads et 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 les annonces, demandez à votre application d'initialiser le SDK Google Mobile Ads en appelant MobileAds.initialize(), qui initialise le SDK et rappelle un écouteur d'achèvement 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 indicateurs spécifiques aux demandes (comme tagForChildDirectedTreatment ou tag_for_under_age_of_consent) ou prenez les mesures nécessaires avant de charger les 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 d'activité principale (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. Ainsi, tous les adaptateurs de médiation seront initialisés.

Sélectionnez un format d'annonce

Le SDK Google Mobile Ads est à présent importé et vous êtes prêt à intégrer une annonce. AdMob proposant différents formats d'annonces, vous pouvez choisir celui qui convient 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 affichées à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement au bout d'un certain temps. Si vous découvrez la publicité pour mobile, c'est un bon point de départ.

Ajouter des bannières

Interstitiel

Annonces plein écran qui couvrent l'interface d'une application jusqu'à ce que l'utilisateur la ferme. Elles sont particulièrement adaptées aux pauses naturelles dans le processus d'exécution d'une application, par exemple entre deux niveaux d'un jeu ou juste après la fin d'une tâche.

Ajouter des annonces interstitielles

Natifs

Annonces personnalisables qui s'adaptent à l'aspect général de votre application. Vous décidez où et où elles sont placées, afin que la mise en page soit plus cohérente avec la conception de l'application.

Intégrer des annonces natives

Accordé

Annonces qui récompensent les utilisateurs qui regardent des vidéos courtes, et qui interagissent avec des annonces jouables et des enquêtes. Permet de monétiser des applications offertes.

Intégrer des annonces avec récompense

Autres ressources

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