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 moins19
compileSdkVersion
d'au moins28
Configurer votre application dans votre compte AdMob
Pour enregistrer votre application en tant qu'application AdMob, procédez comme suit:
Connectez-vous ou inscrivez-vous à un compte AdMob.
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
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 sectionsbuildscript
etallprojects
:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
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' }
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>
avecandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Vous trouverez l'ID de votre application dans l' AdMob interface utilisateur. Pourandroid: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 fichierAndroidManifest.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.
Bannière
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.
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.
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.