Verwenden des AdMob-Dienstes
Nach oben zu Erstellen einer Android-App
Werbedienste ermöglichen das Anzeigen von Werbung in Ihren Anwendungen, um damit Einnahmen zu erzielen. AdMob ist der Google-Werbedienst für Android. In diesem Thema wird beschrieben, wie Sie Werbeanzeigen von AdMob in Ihre Anwendungen mit FireMonkey übernehmen.
- Hinweis: Die folgenden Informationen stellen Ergänzungen des Hauptthemas über die Android-Entwicklung in der Dokumentation dar. Lesen Sie deshalb zuerst Mobile Android-Anwendungsentwicklung.
Inhaltsverzeichnis
Unterstützte Geräte
FireMonkey unterstützt AdMob auf Geräten mit Android 2.3 oder später. Siehe auch Plattformvoraussetzungen für FireMonkey, Android-Anforderungen.
Voraussetzungen
Bevor Sie den AdMob-Dienst verwenden können, müssen Sie Ihre Entwicklungsumgebung vorbereiten und ein AdMob-Konto registrieren.
Erstellen eines Anzeigenblocks für Ihre Anwendung in AdMob
Damit TBannerAd für die Herstellung einer Verbindung zum AdMob-Dienst konfiguriert werden kann, müssen Sie zuerst einen Anzeigenblock in AdMob erstellen. Bei der Konfiguration Ihrer Instanz von TBannerAd für die Verbindung mit AdMob müssen Sie die ID Ihres Anzeigenblocks in die Eigenschaft AdUnitID kopieren.
Hinzufügen der AdMob-Unterstützung zu mobilen Apps
Allgemeines Vorgehen beim Hinzufügen von Werbeanzeigen zu geräteübergreifenden Anwendungen auf mobilen Plattformen:
- Fügen Sie Ihrer Anwendung eine Instanz der Komponente TBannerAd hinzu.
- Konfigurieren Sie TBannerAd so, dass sie eine Werbeanzeige von AdMob lädt.
- Behandeln Sie die vom Benutzer mit Werbeanzeigen ausgeführten Interaktionen.
Laden einer Werbeanzeige
Um eine Werbeanzeige von AdMob in Ihrer Anwendung anzuzeigen, müssen Sie TBannerAd für die Verbindung zu AdMob konfigurieren und eine Werbeanzeige von Ihrem Dienst laden.
Konfigurieren der Verbindungsdaten für AdMob
So verbinden Sie den AdMob-Dienst unter Android:
- 1. Erstellen Sie Ihre Anzeigenblock-ID.
- 2. Kopieren Sie für ein Ereignis, wie z. B. OnCreate Ihres Formulars, die Anzeigenblock-ID in die Eigenschaft AdUnitID von TBannerAd:
-
- Delphi:
BannerAd1.AdUnitID := 'YourAdUnitID';
- Delphi:
-
- C++:
BannerAd1->AdUnitID = "YourAdUnitID";
- C++:
- 3. Wählen Sie Projekt > Optionen > Berechtigungsliste und dann AdMob-Dienst aus. Setzen Sie den Wert auf
True
.
Laden einer Werbeanzeige von AdMob
Rufen Sie LoadAd auf, um eine Werbeanzeige von AdMob zu laden. Die Prozedur LoadAd ist asynchron und löst bei Beendigung eines der folgenden Ereignisse aus:
- OnDidFail wird bei einem Fehler ausgelöst. OnDidFail stellt einen Parameter,
Error
, bereit, der detaillierte Informationen über den Fehler enthält, der das Laden der Werbeanzeige in dem Banner verhindert hat. - OnDidLoad wird ausgelöst, wenn die Ladeanforderung erfolgreich ausgeführt wurde.
Rufen Sie LoadAd aus einem Formularereignis, wie z. B. OnShow, auf, um eine Werbeanzeige sofort beim Anzeigen des Formulars einzublenden.
Behandeln von Interaktionen des Benutzers mit Werbeanzeigen
Wenn Ihr Benutzer auf eine Werbeanzeige tippt, wird eine Aktion ausgelöst. Diese Aktion besteht typischerweise aus einer Vollbildversion der Werbeanzeige, oder es wird ein URL in einem Webbrowser geöffnet.
Zwischen dem Tippen auf die Werbeanzeige durch den Benutzer und der ausgelösten Aktion löst TBannerAd das Ereignis OnActionCanBegin aus. Mithilfe dieses Ereignisses können Sie festlegen, ob die Aktion ausgeführt werden soll oder nicht.
Darüber hinaus können Sie mit der Behandlungsroutine für das Ereignis OnActionCanBegin ausgeführte Features Ihrer Anwendungen unterbrechen, um nutzlose Verarbeitungen während einer Werbeaktion zu vermeiden. Dann können Sie eine Ereignisbehandlungsroutine für das Ereignis OnActionDidFinish definieren, in der Sie diese Features Ihrer Anwendung fortsetzen.
Testen der Werbeanzeigen
Zum Anzeigen von Testwerbeanzeigen in Android setzen Sie einfach die Eigenschaft TBannerAd.TestMode auf True
.
Fehlerbehebung beim Laden einer Werbeanzeige von AdMob
Die folgende Tabelle enthält einige Probleme, die verhindern, dass in Ihrer Anwendung eine Werbeanzeige angezeigt wird, und mögliche Lösungen:
Ursache | Beschreibung | Empfehlung |
---|---|---|
Netzwerkfehler |
Keine Netzwerkverbindung zum Werbeserver. |
Überprüfen Sie Ihre WiFi- oder Datenverbindung. |
Interner Serverfehler |
Vom Werbeserver wurde eine ungültige Antwort empfangen. |
-- |
Ungültige Werbeanforderung |
Verwenden Sie eine gültige Block-ID (AdUnitID). | |
Keine Werbeanzeigen vorhanden |
Zurzeit sind auf dem Werbeserver keine Anzeigen zum Herunterladen verfügbar. |
-- |
Falsche Eigenschaften für Werbeanzeigen | Die Eigenschaft Visible von TBannerAd ist auf False gesetzt.
|
Setzen Sie die Eigenschaft Visible von TBannerAd auf True .
|
Die festgelegte Größe des Banners ist zu groß für die Bildschirmauflösung. | Setzen Sie die Eigenschaft Size auf einen passenden Wert. | |
Falsche Anwendungskonfiguration |
Die Konfigurationsparameter für den Werbedienst in Ihrer Anwendung sind falsch. |
Legen Sie die Eigenschaft AdMob Service Ihrer Anwendung fest (siehe Schritt 3). |