Utilisation du service AdMob
Remonter à Création d'une app Android
Les services de publicité vous permettent d'afficher des annonces publicitaires dans vos applications afin d'en tirer des revenus. AdMob (EN) est le service publicitaire de Google pour Android. Cette rubrique explique comment placer des annonces publicitaires AdMob dans vos applications en utilisant FireMonkey.
- Remarque : Les informations suivantes complètent la rubrique principale de la documentation relative au développement Android. Lire Développement d'applications mobiles Android avant de continuer.
Sommaire
Périphériques pris en charge
FireMonkey prend en charge AdMob sur les périphériques s'exécutant sous Android 2.3 ou une version supérieure. Voir aussi Prérequis de plate-forme FireMonkey, Exigences Android.
Prérequis
Avant de pouvoir utiliser le service AdMob, vous devez préparer votre environnement de développement et créer un compte AdMob (EN).
Création d'un bloc d'annonces pour votre application dans AdMob
Pour pouvoir configurer TBannerAd pour qu'il se connecte au service AdMob, vous devez commencer par créer un bloc d'annonces dans AdMob (EN). Lorsque vous configurez votre instance de TBannerAd pour une connexion à AdMob, vous devez copier l'identifiant de votre bloc d'annonces dans la propriété AdUnitID.
Ajout de la prise en charge AdMob à vos apps mobiles
Voici la procédure générale d'ajout d'annonces publicitaires dans vos applications multi-périphériques sur les plates-formes mobiles :
- Ajoutez une instance du composant TBannerAd dans votre application.
- Configurez TBannerAd pour charger une annonce publicitaire à partir d'AdMob.
- Gérez la façon dont votre utilisateur interagit avec cette annonce publicitaire.
Chargement d'une annonce publicitaire
Pour afficher une annonce publicitaire à partir d'AdMob dans votre application, vous devez configurer TBannerAd pour une connexion à AdMob et charger une annonce publicitaire à partir de votre service.
Configuration des données de connexion pour AdMob
Pour se connecter au service AdMob sur Android :
- 1. Créez votre ID de bloc d'annonces.
- 2. Copiez votre ID de bloc d'annonces dans la propriété AdUnitID de TBannerAd dans un événement tel que l'événement OnCreate de votre fiche :
-
- Delphi :
BannerAd1.AdUnitID := 'YourAdUnitID';
- Delphi :
-
- C++ :
BannerAd1->AdUnitID = "YourAdUnitID";
- C++ :
- 3. Accédez à Projet > Options > Liste des droits et sélectionnez Service AdMob. Définissez sa valeur sur
True
.
Chargement d'une annonce publicitaire à partir d'AdMob
Pour charger une annonce publicitaire à partir d'AdMob, appelez LoadAd. La procédure LoadAd est asynchrone, et dès qu'elle prend fin, elle déclenche l'un des événements suivants :
- OnDidFail est déclenché en cas d'erreur. OnDidFail fournit un paramètre,
Error
, qui donne des informations détaillées sur l'erreur ayant empêché la bannière de charger une annonce publicitaire. - OnDidLoad est déclenché en cas de succès de la requête.
Vous choisissez généralement d'appeler LoadAd à partir d'un événement de fiche comme OnShow, pour charger une annonce publicitaire dès que la fiche s'affiche.
Gestion des interactions utilisateur avec les annonces publicitaires
Lorsque votre utilisateur touche une annonce publicitaire, une action est déclenchée. Il s'agit généralement de l'affichage en version plein écran de l'annonce publicitaire ou de l'ouverture d'une URL sur un navigateur Web.
Entre le moment où l'utilisateur touche l'annonce publicitaire et l'exécution de l'action, TBannerAd déclenche son événement OnActionCanBegin. Gérez cet événement de façon à indiquer si vous voulez ou non que l'action se produise.
Vous pouvez aussi choisir d'utiliser votre gestionnaire d'événement OnActionCanBegin pour interrompre l'exécution de certaines fonctionnalités de vos applications, de façon à économiser vos processus de traitement pendant l'action de l'annonce publicitaire. Vous pouvez ensuite définir un gestionnaire d'événement OnActionDidFinish pour reprendre l'exécution de ces fonctionnalités.
Test de vos annonces publicitaires
Pour afficher des annonces publicitaires test dans Android, définissez simplement la propriété TBannerAd.TestMode sur True
.
Problèmes relatifs au chargement d'une annonce publicitaire à partir d'AdMob
Le tableau suivant liste certains problèmes empêchant votre application d'afficher une annonce publicitaire, et les solutions potentielles :
Cause | Description | Recommandation |
---|---|---|
Erreur réseau |
Aucune connectivité réseau au serveur d'annonces publicitaires |
Vérifiez votre connexion au Wi-Fi ou au réseau de données |
Erreur interne du serveur |
Une réponse non valide a été reçue de la part du serveur d'annonces publicitaires |
-- |
Demande d'annonce publicitaire non valide |
Utilisez un ID de bloc valide (AdUnitID) | |
Absence de stock d'annonces publicitaires |
Aucune annonce publicitaire n'est actuellement disponible pour le téléchargement à partir du serveur concerné |
-- |
Propriétés incorrectes des annonces publicitaires | La propriété Visible de TBannerAd est définie sur False
|
Définissez la propriété Visible de TBannerAd sur True
|
La taille fixe de la bannière est trop grande pour la résolution d'écran | Définissez la propriété AdSize de l'annonce publicitaire sur une valeur correcte | |
Configuration incorrecte de l'application |
Les paramètres de configuration du service d'annonces publicitaires de votre application sont incorrects |
Définissez la propriété Service AdMob de votre application (voir l'étape 3) |