Anzeigenprüftool

Das Anzeigenprüftool ist ein In-App-Overlay, mit dem autorisierte Geräte Testanzeigenanfragen direkt in einer mobilen App in Echtzeit analysieren können. Es ist im Google Mobile Ads SDK Version 20.0.0 und höher enthalten und kann ohne Programmieren aktiviert werden.

Mit dem Anzeigenprüftool in Mobile Ads SDK-Versionen niedriger als 20.2.0 können Sie:

• Anzeigenblöcke prüfen
• Drittanbieteradapter prüfen
• Prüfen, ob Ihre Anzeigen wie erwartet ausgeliefert werden
• Fehler ermitteln und Details zu deren Behebung anzeigen
• Details zur Vermittlung für jedes Werbenetzwerk pro Anfrage aufrufen
• Einzelne Anzeigenquellen für die Vermittlung von Drittanbietern testen
• Prüfen, ob Sie jeden Anzeigenblock für die abfolgebasierte Vermittlung richtig konfiguriert haben
• Integrationen benutzerdefinierter Ereignisse testen

Mit dem Mobile Ads SDK Version 20.2.0 und höher haben Sie außerdem folgende Möglichkeiten:

• Gebotsdetails für jedes Werbenetzwerk pro Anfrage aufrufen
• Details zu Bidding und abfolgebasierter Vermittlung für jedes Werbenetzwerk pro Anfrage ansehen
• Einzelne Anzeigenquellen für Bidding von Drittanbietern oder die abfolgebasierte Vermittlung testen

• Prüfen Sie, ob alle Anzeigenblöcke für Bidding und die Vermittlungsabfolge richtig konfiguriert sind.

In diesem Leitfaden erfahren Sie, wie Sie die verschiedenen Funktionen des Anzeigenprüftools starten und verwenden.

Vorbereitung

Damit Sie das Anzeigenprüftool verwenden können, müssen Sie Folgendes tun:

• Erstellen Sie ein AdMob-Konto und richten Sie eine App ein.

• Führen Sie die Schritte im Startleitfaden aus.

• Verwenden Sie das Google Mobile Ads SDK in der Version 20.0.0 oder höher.

• Fügen Sie Ihr Gerät als Testgerät hinzu. Das Anzeigenprüftool wird nur auf Testgeräten gestartet.

Anzeigenprüftool starten

Sie können das Anzeigenprüftool auf folgende Arten in Ihrer App starten:

1. Verwenden Sie die in der AdMob-Benutzeroberfläche ausgewählte Touch-Geste, wenn Sie ein Testgerät registrieren.
2. Programmatische Verwendung der vorgegebenen API
3. Klicken Sie im Menü zur Fehlerbehebung auf die Schaltfläche „Starten“.

Mit Touch-Gesten starten

Es sind keine Änderungen an Ihrer App erforderlich, um das Anzeigenprüftool mit einer Geste zu starten. Führen Sie einfach die Geste (doppeltes Wischen oder Schütteln) aus, die Sie in AdMob für das Testgerät konfiguriert haben. Weitere Informationen

Nachdem Sie in der AdMob-Benutzeroberfläche eine Touch-Geste festgelegt haben und 15 Minuten warten, bis sie übernommen wird, muss Ihre App eine Anzeigenanfrage an das Google Mobile Ads SDK senden, um die Touch-Geste-Einstellung zu ermitteln. Wenn die angegebene Geste nicht funktioniert, laden Sie eine Anzeige, starten Sie die App neu und testen Sie die Geste noch einmal.

Programmatisch starten

Das Anzeigenprüftool kann auch programmatisch gestartet werden:

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

Diese API funktioniert für Testgeräte, die programmatisch oder in der AdMob-Benutzeroberfläche registriert wurden.

Anzeigenblöcke aufrufen und Fehler beheben

Nach dem Start wird der Hauptbildschirm des Anzeigenprüftools angezeigt. Er enthält eine Liste aller Anzeigenblöcke auf der AdMob-Benutzeroberfläche, die mit Ihrer AdMob-App-ID verknüpft sind und Bidding- oder Vermittlungskonfigurationen haben:

Wir empfehlen, das Google Mobile Ads SDK zu initialisieren, bevor Sie das Anzeigenprüftool verwenden.

Details zur Vermittlungsabfolge für einen Anzeigenblock aufrufen

Tippen Sie auf einen Anzeigenblock, um das zugehörige SDK-Anfrageprotokoll aufzurufen. Es enthält Details zur Vermittlungsabfolge bis zu dem Zeitpunkt, an dem die Anzeige für die letzten Anzeigenanfragen ausgeliefert oder die Vermittlungsabfolge ohne Ausführung beendet wurde.

Jede Anfrage kann mithilfe des entsprechenden Indikators maximiert werden, um die Ergebnisse der Vermittlungsabfolge für diese Anfrage sowie alle Fehler und Latenzen zu sehen, die für diese Anfrage aufgetreten sind.

Bei Anzeigenquellen von Drittanbietern werden Fehlermeldungen direkt von der Anzeigenquelle gesendet. Weitere Informationen finden Sie bei Ihrer Drittanbieter-Anzeigenquelle.

Gebotsdetails für einen Anzeigenblock aufrufen

Voraussetzungen: Google Mobile Ads SDK 20.2.0 oder höher

Wenn Sie die Gebotseinstellung noch nicht kennen, lesen Sie den Überblick.

Im SDK-Anfrageprotokoll sehen Sie die Bidding-Anzeigenquellen, die in der Anzeigenanfrage aufgerufen werden. Tippen Sie im SDK-Anfrageprotokoll auf einen Anzeigenblock, um die Details der einzelnen Anzeigenquellen in der Bidding-Auktion aufzurufen.

Die Gebotsergebnisse werden so sortiert, dass die umsetzbaren Elemente in der Liste näher an den Anfang der Liste kommen:

• Ganz oben ist das Werbenetzwerk zu sehen, das die Auktion gewonnen hat.

• Als Nächstes sehen Sie die Werbenetzwerke, bei denen Probleme aufgetreten sind. Folge den Schritten zur Fehlerbehebung.

• Dann gibt es die Werbenetzwerke, bei denen keine Anzeigen zurückgegeben wurden oder keine Gebote abgegeben wurden. Dies ist ein möglicher Indikator für viele verschiedene Probleme mit der Anzeigenquelle, da sie aufgrund der Einrichtung oder Entscheidung möglicherweise kein Gebot abgegeben hat. Weitere Informationen finden Sie im Einrichtungsleitfaden für die Anzeigenquelle oder wenden Sie sich direkt an die Anzeigenquelle.

• Ganz unten in der Liste finden Sie die Anzeigennetzwerke, die die Bidding-Auktion verloren haben.

  

In der Vermittlungsabfolge kann die Anzeigenquelle, die die Bidding-Auktion gewonnen hat, gemäß ihrem eCPM-Wert platziert werden.

Wenn eine Anzeigenquelle in der Vermittlungsabfolge aufgerufen wird, kann sie Anzeigen ausliefern. Weitere Informationen zur Funktionsweise von Bidding in der Vermittlungsabfolge finden Sie in Beispiel 2 und Beispiel 3 zu Bidding- und abfolgebasierten Anzeigenquellen in einer Vermittlungsgruppe.

Erweiterte Fehlerbehebung für Anzeigenblöcke

Bei der Fehlerbehebung für Anzeigenblöcke kann es hilfreich sein, die Anzeigenanfrage und -antwort zu analysieren, um herauszufinden, wo ein Fehler auftritt, oder ihn an den Google-Support weiterzugeben, um ihn bei der Fehlerbehebung zu unterstützen. Tippen Sie oben in der Vermittlungsabfolge auf das Menüsymbol und wählen Sie Anzeigenanfragen und -antwort teilen aus, um die vollständige Anzeigenanfrage und -antwort zu exportieren. So müssen Sie Netzwerk-Traces nicht in Ihrer eigenen Anwendung ausführen.

Hinweis :Sie können die Anzeigenantwort erst exportieren, wenn Sie das Testgerät in der AdMob-Benutzeroberfläche hinzugefügt haben.

Sie können sich auch decodierte Bidding-Parameter von Drittanbietern ansehen. Tippen Sie dazu im selben Menü wie der Anfragestring auf die Option Drittanbieter-Bidding-Parameter. Hier finden Sie Details zu den Gebotsparametern von Drittanbietern, die möglicherweise Probleme haben. So können Sie Fehler in Ihrer App beheben oder prüfen, ob ein Netzwerk seine Signale erfolgreich erfasst.

Verfügbare Adapter ansehen

Klicken Sie auf den Tab Adapter, um eine Liste aller Drittanbieteradapter aufzurufen, die den Anzeigenquellen in den Gebots- oder Vermittlungskonfigurationen Ihrer App zugeordnet sind. Maximieren Sie dann die Karten, um ihren Initialisierungsstatus und ihre SDK-Versionen zu sehen. Neben unterstützten Drittanbieteradaptern können Sie sich auch Adapter für benutzerdefinierte Ereignisse ansehen. Mit benutzerdefinierten Ereignissen können Publisher Werbenetzwerke verwenden, die von AdMob nicht unterstützt werden. Benutzerdefinierte Ereignisse unterscheiden sich von standardmäßigen Drittanbieteradaptern in der Adapterliste durch ihre eindeutigen Klassennamen. Neben dem Klassennamen und Statusinformationen werden im Anzeigenprüftool auch die Labels angezeigt, die diesen benutzerdefinierten Ereignissen in der AdMob-Weboberfläche zugewiesen sind.

Wenn der Adapter nicht gefunden oder nicht initialisiert wird, finden Sie unter Mithilfe des Anzeigenprüftools gefundene Probleme beheben weitere Informationen.

Hinweis: Frühere Implementierungen benutzerdefinierter Ereignisse vor API-Version 20.0.0, die veralteten APIs untergeordnet sind, werden nicht initialisiert und im Anzeigenprüftool als Problem gefunden angezeigt. Wenn diese Warnung im Anzeigenprüftool angezeigt wird, obwohl die Integration der benutzerdefinierten Ereignisse funktioniert, prüfen Sie, ob in Ihrer App eingestellte Schnittstellen wie CustomEventBanner verwendet werden, und ersetzen Sie sie durch die neue Klasse Adapter.

Anzeigenblöcke testen

Wenn Sie Ihren Anzeigenblock testen möchten, ohne ihn über die Benutzeroberfläche Ihrer App aufrufen zu müssen, können Sie das Anzeigenprüftool direkt über den Bildschirm mit den Anzeigenblockdetails verwenden. Außerdem können Sie mehrere Anzeigenblöcke gleichzeitig testen, Ihre Testanzeigenanfragen asynchron laden und aufrufen und sogar Tests für einzelne Anzeigenquellen durchführen.

Wichtig: Wenn Sie einen dieser Ad Inspector-Tests ausführen, enthalten Ihre Anfragen nicht alle Parameter, die sie enthalten würden, wenn sie über die Benutzeroberfläche Ihrer App ausgelöst würden. Dazu gehören unter anderem die Konfiguration für Inhalte für Kinder, das benutzerdefinierte Targeting, Netzwerk-Extras und verschiedene Größen. Da diese Anfragen eher begrenzt sind, empfehlen wir den Test möglichst über die UI Ihrer App.

Anzeigentests

Mit den in diesem Abschnitt beschriebenen Anzeigentests im Anzeigenprüftool können Sie die Nutzerfreundlichkeit von Werbeanzeigen überprüfen und Ihre Vermittlungskonfiguration mit Tests für einzelne Anzeigenquellen prüfen.

Wenn Sie Ihren Anzeigenblock testen möchten, tippen Sie oben auf dem Anzeigenprüftool-Bildschirm auf die Schaltfläche Testanzeige anfordern, um den Anzeigentest im Anzeigenprüftool zu starten. Die Testergebnisse werden dann im SDK-Anfrageprotokoll unter dem Header Angefordert vom Anzeigenprüftool angezeigt.

Hinweis: Wenn Sie die Funktion Testanzeige anfordern verwenden möchten, initialisieren Sie das Google Mobile Ads SDK mit einem Activity-Kontext.

Weitere Informationen zur Verwendung des Anzeigenprüftools in Ihrer App

Einzelne Anzeigenquelle testen

Das Anzeigenprüftool bietet eine Funktion, mit der Anzeigenanfragen in Ihrer App so eingeschränkt werden können, dass nur Anzeigen aus einer einzigen Anzeigenquelle mit Bidding oder abfolgebasierter Vermittlung ausgeliefert werden. So können Sie prüfen, ob Sie den Drittanbieteradapter richtig implementiert haben und ob die Anzeigenquelle wie erwartet ausgeliefert wird.

Wenn Sie diese Funktion aktivieren möchten, aktivieren Sie unten auf dem Bildschirm die Option Einzelne Anzeigenquelle testen. Daraufhin wird das folgende Dialogfeld zur Auswahl der Anzeigenquelle angezeigt:

Bevor Sie Tests für einzelne Anzeigenquellen ausführen können, müssen Sie das Google Mobile Ads SDK initialisieren.

Anschließend können Sie eine einzelne Anzeigenquelle zum Testen auswählen. Nach Auswahl einer Anzeigenquelle wird der folgende Bildschirm angezeigt:

Die Testeinstellung für eine einzelne Anzeigenquelle wird auf alle zukünftigen Anzeigenanfragen in derselben Sitzung angewendet. Das gilt jedoch nicht für zuvor in dieser Sitzung im Cache gespeicherte Anzeigen, die noch nicht ausgeliefert wurden. Wir empfehlen, den Neustart der App zu erzwingen, wenn Sie einen Test für eine einzelne Anzeigenquelle ausführen. So werden im Cache gespeicherte Anzeigen ungültig, die anstelle der von der ausgewählten Anzeigenquelle ausgelieferten Anfrage ausgeliefert werden könnten.

Nach dem Neustart Ihrer App wird bei allen Anzeigenblock-Placements versucht, nur eine Anzeige aus dem ausgewählten Netzwerk auszuliefern. Wenn Sie das Anzeigenprüftool starten, während ein Test für eine einzelne Anzeigenquelle aktiv ist, wird die aktive Testanzeigenquelle angezeigt:

Im Testmodus für eine einzelne Anzeigenquelle wird versucht, alle Anzeigenanfragen mit der ausgewählten Anzeigenquelle zu füllen, unabhängig davon, ob diese Anzeigenquelle für Gebote oder die Vermittlung für den angeforderten Anzeigenblock konfiguriert wurde. Wenn sich die zu testende Anzeigenquelle nicht in der Vermittlungsabfolge für einen Anzeigenblock befindet, wird die Fehlermeldung „Keine Ausführung“ angezeigt.

Bei einem Test einer einzelnen Anzeigenquelle können Sie auf einen Anzeigenblock tippen, um das zugehörige SDK-Anfrageprotokoll aufzurufen. Damit können Sie feststellen, ob die Anzeigenanfragen von der Anzeigenquelle ausgeführt wurden, nachdem der Test einer einzelnen Anzeigenquelle aktiviert wurde. Wenn die Anzeigenquelle eine Anzeige nicht laden konnte, erscheint eine Fehlermeldung, die den Fehler beschreibt.

Haben Sie einer Vermittlungsabfolge mehrere Instanzen der ausgewählten Anzeigenquelle hinzugefügt, wird jeder einzelne Aufruf an die Anzeigenquelle in der Vermittlungsabfolge angezeigt, bis die Anzeige ausgeführt oder die Abfolge ohne Ausführung beendet wurde.

Test einer einzelnen Anzeigenquelle beenden

Wenn Sie den Test beenden möchten, deaktivieren Sie den Schalter:

Daraufhin wird auf dem folgenden Neustartbildschirm eine Bestätigungsmeldung angezeigt:

Wir empfehlen, den Neustart Ihrer App nach dem Beenden des Tests zu erzwingen, damit im Cache gespeicherte Anzeigen der getesteten Anzeigenquelle ungültig werden.

Vollständige Debug-Ausgaben kopieren

Der Anzeigenprüfer unterstützt das Kopieren eines JSON-Strings, der den gesamten Debug-Output aus dem Tool enthält, einschließlich Details Ihrer AdMob-App, Adapterinitialisierungsstatus und Testergebnisse aller Anzeigenblöcke.

Tippen Sie dazu siebenmal auf das App-Symbol, bis die Meldung JSON-Datei des Anzeigenprüfers in die Zwischenablage kopiert angezeigt wird.