Cette page a été traduite par l'API Cloud Translation.

Commencer

L'intégration du SDK Google Mobile Ads à une application est 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 (vidéo native ou avec récompense, par exemple) et suivre les étapes d'implémentation.

Avant de commencer

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

Conditions requises pour l'application

Utiliser Android Studio 3.2 ou version ultérieure
Assurez-vous que le fichier de compilation de votre application utilise les valeurs suivantes :
- minSdkVersion sur 19 ou plus
- compileSdkVersion sur 28 ou plus

Configurer votre application dans votre compte AdMob

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

Connectez-vous à un compte AdMob ou créez-en un.
Enregistrez votre application auprès d'AdMob. Cette étape permet de créer une application AdMob avec un ID d'application AdMob unique, plus loin dans ce guide.

Configurer votre application

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()
    }
}

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.4.0'
}
```
Ajoutez votre AdMob ID d'application 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 votre ID d'application dans l' AdMob interface Web. Pour android:value, insérez votre propre AdMob ID d'application, placé entre guillemets.
```
<manifest>
  <application>
    
    <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 l'ID AdMob de l'application, et non l'ID 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, si vous n'ajoutez pas la balise <meta-data> comme indiqué ci-dessus, le message d'erreur suivant s'affiche:
```
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 le SDK Google Mobile Ads version 20.4.0 ou ultérieure, 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 lorsqu'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"/>

   
   <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, y compris 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 rappelle un écouteur d'achèvement dès que l'initialisation est 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 via 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, tels que tagForChildDirectedTreatment ou tag_for_under_age_of_consent, ou prenez les mesures nécessaires 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 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, afin de vous assurer que tous les adaptateurs de médiation sont initialisés.

Sélectionnez un format d'annonce

Le SDK Google Mobile Ads est importé et vous êtes prêt à intégrer une annonce.AdMob propose différents formats d'annonces. 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 lorsque les utilisateurs interagissent avec l'application. Elles peuvent s'actualiser automatiquement au bout d'un certain temps. Si vous faites vos premiers pas dans la publicité mobile, c'est un bon point de départ.

Implémenter des bannières

Interstitiel

Annonces en plein écran qui couvrent l'interface d'une application jusqu'à ce qu'elles soient fermées par l'utilisateur. Ils sont particulièrement adaptés à des 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. Vous choisissez où et comment les afficher pour mieux adapter leur mise en page à la conception de celle-ci.

Intégrer des annonces natives

Accordé

Annonces qui récompensent les utilisateurs pour avoir regardé des vidéos courtes, et interagi avec des annonces jouables et des enquêtes. Permet de monétiser les applications sans frais.

Implémenter des annonces avec récompense

Ressources supplémentaires

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