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.

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:

1. Fügen Sie Ihrer Anwendung eine Instanz der Komponente TBannerAd hinzu.
2. Konfigurieren Sie TBannerAd so, dass sie eine Werbeanzeige von AdMob lädt.
3. 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';

C++: BannerAd1->AdUnitID = "YourAdUnitID";

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	Falsche AdUnitID oder keine AdUnitID verwendet.	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).

Siehe auch

• Verwenden des iAd-Dienstes