Utilisation du service AdMob

De RAD Studio
Aller à : navigation, rechercher

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.

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 :

  1. Ajoutez une instance du composant TBannerAd dans votre application.
  2. Configurez TBannerAd pour charger une annonce publicitaire à partir d'AdMob.
  3. 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';
C++ : BannerAd1->AdUnitID = "YourAdUnitID";
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

AdUnitID utilisé incorrect ou aucun AdUnitID utilisé

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)

Voir aussi