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 d'au moins 19
- compileSdkVersion égal à 28 ou plus

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.1.0'
}
```
Ajoutez votre Ad Manager ID d'application (identifié dans l'UIAd Manager) 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". Votre ID d'application est disponible dans l' Ad Manager UI. Pour android:value, insérez votre propre Ad Manager 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 Ad Manager 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"/>

        <-- 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, 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 propres à la requête (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.Ad Manager 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.

Google Ad Manager propose deux méthodes pour intégrer des annonces natives: les styles natifs et l'affichage personnalisé.

Les styles natifs ont été conçus pour faciliter au maximum l'implémentation des annonces natives. C'est un excellent choix si vous débutez avec ce format. L'affichage personnalisé a été conçu pour vous offrir une plus grande liberté de création des présentations.

Implémenter des annonces natives

Implémenter des styles natifs

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.