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 kann ohne Programmieraufwand aktiviert werden.

Mit dem Anzeigenprüftool können Sie:

  • Anzeigenblöcke prüfen
  • Prüfen, ob Ihre Anzeigen wie erwartet ausgeliefert werden
  • Fehler ermitteln und Details zur Behebung abrufen
  • Details zu den einzelnen Bidding-Werbenetzwerken pro Anfrage aufrufen
  • Details zur Vermittlung für jedes Werbenetzwerk pro Anfrage aufrufen
  • Anzeigenquellen für Gebote von Drittanbietern oder abfolgebasierte Vermittlung testen
  • Prüfen, ob Sie jeden Anzeigenblock für Gebote und die abfolgebasierte Vermittlung richtig konfiguriert haben

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

Vorbereitung

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

  • Verwenden Sie das Mobile Ads Flutter-Plug-in in Version 1.3.0 oder höher.

Anzeigenprüftool starten

Das Anzeigenprüftool kann überall in Ihrer App auf folgende Weise gestartet werden:

  1. Verwenden Sie die Schaltfläche „Starten“ im Menü „Debuggen“.
  2. Verwenden Sie die Geste, die Sie in den Einstellungen des Anzeigenprüftools ausgewählt haben.
  3. Programmatische Verwendung der vorgegebenen API

Über das Debug-Menü starten

Sie müssen an Ihrer App keine Änderungen vornehmen, um das Anzeigenprüftool über das Menü zur Fehlerbehebung zu starten. Suchen Sie einfach nach einer Anzeige, die über Ihr Ad Manager-Netzwerk ausgeliefert wird, und halten Sie die Anzeige mit zwei Fingern gedrückt, um das Menü zur Fehlerbehebung zu öffnen. Wählen Sie dann Anzeigenprüftool öffnen aus.

Wenn Sie Ihr Gerät nicht verknüpft haben, werden Sie möglicherweise aufgefordert, sich in Ihrem Ad Manager-Konto anzumelden.

Sie können auch in den Einstellungen zur Fehlerbehebung Einstellungen für das Anzeigenprüftool auswählen und eine Geste auswählen, mit der das Anzeigenprüftool zukünftig geöffnet werden kann, ohne das Menü zur Fehlerbehebung verwenden zu müssen.

Programmatisch starten

Das Anzeigenprüftool kann auch programmatisch gestartet werden:

MobileAds.instance.openAdInspector(
  (AdInspectorError? error) {
    // Error will be non-null if ad inspector closed due to an error.
  });

Diese API funktioniert für Testgeräte, die programmatisch registriert sind.

Anzeigenblöcke aufrufen und Fehler beheben

Nach dem Start wird der Hauptbildschirm des Anzeigenprüftools angezeigt. Er enthält eine Liste aller Anzeigenblöcke, für die auf dem Gerät seit der Aktivierung des Anzeigenprüftools während dieser App-Sitzung Anzeigenanfragen gestellt wurden. Die Liste enthält auch Anzeigenblöcke mit aktivierten Geboten, die chronologisch nach den zuletzt abgeschlossenen Anfragen sortiert sind. Anzeigenblöcke, für die keine Anzeigenanfragen abgeschlossen wurden, sind ausgegraut:

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. Wenn Sie weitere Informationen benötigen, wenden Sie sich an Ihre Drittanbieter-Anzeigenquelle.

Gebotsdetails für einen Anzeigenblock aufrufen

Wenn Sie Bidding noch nicht kennen, lesen Sie die Einführung in Open Bidding.

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 zu den einzelnen Anzeigenquellen in der Bidding-Auktion aufzurufen.

Die Gebote werden so sortiert, dass die umsetzbaren Elemente oben in der Liste angezeigt werden:

  • Oben sehen Sie das Werbenetzwerk, das die Auktion gewonnen hat.

  • Als Nächstes sehen Sie die Werbenetzwerke, bei denen Probleme aufgetreten sind. Folgen Sie am Ende der FAQs zu Geboten den Schritten zur Fehlerbehebung.

  • Dann gibt es die Werbenetzwerke, bei denen keine Anzeigen zurückgegeben wurden oder keine Gebote abgegeben wurden. Dies kann ein Hinweis auf verschiedene Probleme mit der Anzeigenquelle sein, da aufgrund der Einrichtung oder Entscheidungsfindung möglicherweise kein Gebot abgegeben wurde. Weitere Informationen finden Sie in der Einrichtungsanleitung der Anzeigenquelle oder in den häufig gestellten Fragen zu Open Bidding.

  • Am Ende der Liste sehen Sie die Werbenetzwerke, die die Auktion verloren haben.

Die Vermittlungsabfolge kann die Anzeigenquelle, die die Bidding-Auktion gewonnen hat, entsprechend ihrem eCPM-Wert platzieren.

Eine Vermittlungsabfolge ist das Ergebnis mehrerer Ertragsgruppen, die um dasselbe Inventar konkurrieren. Sie können einer einzelnen Ertragsgruppe bis zu zehn Drittanbieter-Ertragspartner hinzufügen, einschließlich Bidding-Ertragspartnern und der Vermittlung für Ertragspartner für mobile Apps.

Erweiterte Fehlerbehebung für Anzeigenblöcke

Bei der Fehlerbehebung bei Anzeigenblöcken kann es hilfreich sein, die Anzeigenanfrage und ‑antwort zu prüfen, um die Ursache zu ermitteln, oder sie dem Google-Support zur Verfügung zu stellen, um die Fehlerbehebung zu unterstützen. Tippen Sie oben in der Vermittlungsabfolge auf das Dreistrich-Menü und wählen Sie Anzeigenanfrage und -antwort teilen aus, um die vollständige Anzeigenanfrage und -antwort zu exportieren. So müssen Sie keine Netzwerk-Traces in Ihrer eigenen App ausführen.

Außerdem können Sie decodierte Gebotsparameter von Drittanbietern aufrufen. Tippen Sie dazu im Menü des Anfragestrings auf die Option Drittanbieter-Gebotsparameter. 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.

Android
iOS

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 Ad Manager 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 Ad Manager-Weboberfläche zugewiesen sind.

Wenn der Adapter nicht gefunden oder nicht initialisiert wird, finden Sie unter Auslieferung von Anzeigen in mobilen Apps prüfen weitere Informationen.

Android
iOS

Anzeigenblöcke testen

Wenn Sie Ihren Anzeigenblock testen möchten, ohne ihn in der Benutzeroberfläche Ihrer App aufrufen zu müssen, unterstützt das Anzeigenprüftool dies direkt auf dem Detailbildschirm des Anzeigenblocks. Außerdem können Sie mehrere Anzeigenblöcke gleichzeitig testen, Ihre Testanzeigenanfragen asynchron laden und ansehen und sogar Tests für einzelne Anzeigenquellen durchführen.

Anzeigentests

Die in diesem Abschnitt beschriebenen Anzeigentests im Anzeigenprüftool sind ein hervorragendes Tool, um die Anzeigenbereitstellung und die Vermittlungskonfiguration zu überprüfen, wenn sie mit Tests einzelner Anzeigenquellen kombiniert werden.

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.

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 lässt sich feststellen, ob Sie den Adapter des Drittanbieters 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 Einstellung für den Test einer einzelnen Anzeigenquelle gilt für alle zukünftigen Anzeigenanfragen, die Sie in derselben Sitzung stellen. Das gilt jedoch nicht für zuvor in dieser Sitzung im Cache gespeicherte Anzeigen, die noch nicht ausgeliefert wurden. Wenn Sie einen Test für eine einzelne Anzeigenquelle durchführen, sollten Sie die App neu starten, um alle im Cache gespeicherten Anzeigen ungültig zu machen, die statt der ausgewählten Anzeigenquelle eine Anfrage erhalten könnten.

Nach dem Neustart Ihrer App wird über alle Anzeigenblock-Placements versucht, nur eine Anzeige aus dem ausgewählten Werbenetzwerk zu schalten. 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 Anzeigenquelle, die Sie testen möchten, 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 keine Anzeige geladen hat, wird eine Fehlermeldung angezeigt.

Wenn Sie einem Vermittlungs-Wasserfall mehrere Instanzen der ausgewählten Anzeigenquelle hinzugefügt haben, wird jede Instanz des Aufrufs an die Anzeigenquelle im Vermittlungsabfolge angezeigt, bis die Anzeige gefüllt oder die Abfolge ohne Füllung beendet wurde.

Test für einzelne Anzeigenquelle beenden

Wenn du den Test beenden möchtest, stelle den Schalter auf „Aus“:

Anschließend wird auf dem folgenden Neustartbildschirm eine Bestätigungsmeldung angezeigt:

Wir empfehlen, die App nach dem Beenden des Tests neu zu starten, um alle im Cache gespeicherten Anzeigen für die getestete Anzeigenquelle ungültig zu machen.

Gesamte Debugging-Ausgaben kopieren

Der Anzeigenprüfer unterstützt das Kopieren eines JSON-Strings, der den gesamten Debugging-Output aus dem Tool enthält, einschließlich Details Ihrer Ad Manager-App, des Adapter-Initialisierungsstatus und der 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.