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

Commencer

L'intégration du SDK Google Mobile Ads dans 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 (annonce native ou vidéo avec récompense, par exemple) et suivre les étapes de mise en œuvre.

Avant de commencer

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

Conditions requises pour l'application

Utilisez Android Studio version 3.2 ou ultérieure
Assurez-vous que le fichier de compilation de votre application utilise les valeurs suivantes :
- minSdkVersion d'au moins 19
- compileSdkVersion égal à 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 à votre 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. Vous en aurez besoin ultérieurement 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 les 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, généralement app/build.gradle:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:21.5.0'
}
```
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 votre ID d'application dans l' AdMob interface utilisateur. Pour android:value, insérez votre propre AdMob ID d'application 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 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 du tag <meta-data> comme indiqué ci-dessus entraîne un plantage avec le message suivant:
```
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 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 qui ciblent Android 13, vous devez ajouter l'autorisation com.google.android.gms.permission.AD_ID dans le fichier AndroidManifest.xml afin 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 savoir 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 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 de médiation partenaires lors de l'appel de MobileAds.initialize(). Si vous devez obtenir le consentement des utilisateurs de l'Espace économique européen (EEE), définir des indicateurs propres à la demande (tels que tagForChildDirectedTreatment ou tag_for_under_age_of_consent) ou prendre d'autres mesures avant de charger des annonces, assurez-vous d'effectuer cette opération avant d'initialiser le SDK Google Mobile Ads.

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

Exemple d'activité 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 d'appeler le gestionnaire d'achèvement avant de charger les annonces. De cette manière, 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 Il existe différents formats d'annonces. Vous pouvez donc 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 à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement après un certain temps. Si vous découvrez 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'à sa fermeture par l'utilisateur. Elles sont particulièrement adaptées aux 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

Ces annonces personnalisables reprennent le style de votre application. Vous décidez où et comment elles sont placées afin que la mise en page soit plus cohérente avec le design de votre application.

Implémenter 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. 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.