Verwenden des iAd-Dienstes

Nach oben zu Erstellen von iOS-Apps

Werbedienste ermöglichen das Anzeigen von Werbung in Ihren Anwendungen, um damit Einnahmen zu erzielen. iAd ist der Apple-Werbedienst für iOS. In diesem Thema wird beschrieben, wie Sie Werbeanzeigen von iAd in Ihre Anwendungen mit FireMonkey übernehmen.

Hinweis: Lesen Sie deshalb zuerst Mobile iOS-Anwendungsentwicklung. Die folgenden Informationen stellen Ergänzungen des Hauptthemas zur iOS-Entwicklung in der Dokumentation dar.

Unterstützte Geräte

FireMonkey unterstützt iAd auf allen unterstützten iOS-Geräten.

Grundvoraussetzungen

Folgende Voraussetzungen müssen vor der Nutzung des iAd-Dienstes zusätzlich zum Vorbereiten Ihrer Entwicklungsumgebung erfüllt sein:

• Sie müssen darauf vorbereitet sein, eine Codesignierung Ihrer iOS-Anwendungen durchzuführen. Siehe Mobile iOS-Anwendungsentwicklung, Vorbereiten der Codesignierung von Anwendungen.
  • Beim Erstellen einer App-ID für Ihre Anwendung müssen Sie eine explizite App-ID verwenden, die für eine einzelne Anwendung spezifisch ist, zum Beispiel: com.mycompany.myapp. App-IDs mit Platzhaltern, wie com.mycompany.*, sind nicht zulässig.
• Sie benötigen einen gültigen "iAd App Network"-Vertrag mit Apple. Befolgen Sie die unter iAd App Network beschriebenen Schritte.

Konfigurieren Ihre Anwendung für iAd in iTunes Connect

1. Sie müssen zuerst einen Eintrag für Ihre Anwendung in iTunes Connect erstellen, um den iAd-Dienst in Ihrer Anwendung nutzen und testen zu können.
2. Öffnen Sie danach das Modul Manage Your Apps von iTunes Connect, und öffnen Sie die Seite "App Summary" Ihrer Anwendung.
3. Klicken Sie rechts auf der Seite "App Summary" auf Set Up iAd Network.
4. Klicken Sie dann auf Enable iAds und auf Save.

Hinzufügen von iAd-Unterstützung zu mobilen Apps

Allgemeines Vorgehen beim Hinzufügen von iAd-Werbeanzeigen zu geräteübergreifenden Anwendungen auf iOS:

1. Fügen Sie Ihrer Anwendung eine Instanz der Komponente TBannerAd hinzu.
2. Konfigurieren Sie die Komponente TBannerAd so, dass sie eine Werbeanzeige von iAd lädt.
3. Behandeln Sie die vom Benutzer mit dieser Werbeanzeige ausgeführten Interaktionen.

Laden einer Werbeanzeige

Um eine Werbeanzeige von Ihrem Werbedienst in Ihrer Anwendung anzuzeigen, laden Sie eine Werbeanzeige von Ihrem Dienst.

Laden von Werbeanzeigen von Ihrem Werbedienst

Rufen Sie LoadAd auf, um eine Werbeanzeige von Ihrem Werbedienst 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.

Beliebiges Abbrechen einer Werbeaktion

Wenn Ihr Benutzer auf eine Werbeanzeige tippt, wird eine Aktion ausgelöst. Diese Aktion besteht typischerweise entweder aus einer Vollbildversion der Werbeanzeige, oder es wird ein URL in einem Webbrowser geöffnet. Siehe Behandeln von Interaktionen des Benutzers mit Werbeanzeigen.

Wenn Ihre Anwendung die Aufmerksamkeit Ihres Benutzers erfordert, können Sie jederzeit überprüfen, ob eine Werbeaktion ausgeführt wird, und diese beenden:

Delphi:

if MyBannerAd.IsActionInProgress then
    MyBannerAd.CancelAction;

C++:

if (MyBannerAd->IsActionInProgress())
    MyBannerAd->CancelAction();

Hinweis: Das Beenden von Werbeaktionen wirkt sich auf Ihre Einnahmen aus der Werbung aus. Weitere Informationen finden Sie in der Apple-Dokumentation.

Testen Ihrer iAds

Der iAd-Dienst zeigt Test- oder reale Werbeanzeigen automatisch an. Dies ist von der Art der Erzeugung Ihrer Anwendung abhängig:

• Wenn Sie Ihre Anwendung für die Ad-hoc-Weitergabe bereitstellen oder Ihre Anwendung einfach nur ausführen, handelt es sich bei den Werbeanzeigen um Testwerbung.
• Wenn Sie Ihre Anwendung für die Übermittlung an den App Store bereitstellen, handelt es sich bei den Werbeanzeigen um reale Werbung.

Fehlerbehebung beim Laden einer Werbeanzeige von iAd

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.	--
Keine Werbeanzeigen vorhanden	Zurzeit sind auf dem Werbeserver keine Anzeigen zum Herunterladen verfügbar.	--
Falsche Anwendungskonfiguration	Die Konfigurationsparameter für den Werbedienst in Ihrer Anwendung sind falsch.	Konfigurieren Sie Ihre Anwendung für iAd in iTunes Connect.

Siehe auch

• Verwenden des AdMob-Dienstes