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 (vidéo native ou avec récompense, par exemple) et suivre les étapes correspondantes.

Avant de commencer

Pour préparer votre application, suivez les étapes décrites dans les sections suivantes.

Prérequis pour les applications

  • 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 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 créez un compte AdMob.

  2. Enregistrez votre application avec AdMob. Cette étape crée une application AdMob avec un ID d'application AdMob, nécessaire plus tard dans ce guide.

Configurer votre application

  1. Dans votre fichier build.gradle au niveau du projet, incluez le dépôt Maven 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.0.0'
    }
    
  3. Ajoutez l' AdMob ID de votre application (identifié dans l'interface utilisateurAdMob) 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 se trouve dans l'UI. AdMob 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 l'ID AdMob de votre application réel, et non celui indiqué ci-dessus. Si vous souhaitez juste 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, génère 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, car le SDK déclare automatiquement l'autorisation com.google.android.gms.permission.AD_ID et peut accéder à l'identifiant publicitaire chaque fois 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, y compris sur la manière de 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 de lecture complète une fois l'initialisation terminée (ou après un délai d'inactivité de 30 secondes). Cette opération ne doit être effectuée qu'une seule fois, idéalement lors du lancement de l'application.

Le SDK Google Mobile Ads ou les SDK des partenaires de médiation peuvent précharger les annonces sur MobileAds.initialize(). Si vous avez besoin d'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 d'autres mesures avant de charger les 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é 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'exécution soit appelé avant de charger les annonces, car cela garantit l'initialisation de tous les adaptateurs de médiation.

Sélectionnez un format d'annonce

Le SDK Google Mobile Ads est importé et vous pouvez intégrer une annonce.AdMob Il existe différents formats d'annonces, vous pouvez donc choisir celui qui correspond le mieux à l'expérience utilisateur que vous proposez.

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 n'avez jamais utilisé la publicité mobile, cela représente un bon point de départ.

Bannières

Interstitiel

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

Intégrer des annonces interstitielles

Natifs

Annonces personnalisables qui s'adaptent à l'apparence de votre application. Vous choisissez leur emplacement et leur emplacement, de sorte qu'elles correspondent mieux au design de votre application.

Intégrer des annonces natives

Avec récompense

Annonces qui récompensent les utilisateurs pour le visionnage de courtes vidéos et l'interaction 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.