Anzeigenprüftool (Beta)

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 in der -Version des Google Mobile Ads SDK 20.2.0 und höher enthalten und kann ohne Programmieren 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 Sie, ob alle Anzeigenblöcke für Gebote und abfolgebasierte Vermittlung

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:

  • Google verwenden Mobile Ads SDK-Version 20.2.0 oder höher.

Anzeigenprüftool starten

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

  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

Es sind keine Änderungen an Ihrer App erforderlich, um das Anzeigenprüftool über die Fehlerbehebung zu starten menu; suchen Sie nach einer Anzeige aus Ihrem Ad Manager-Netzwerk und halten Sie sie gedrückt, die Anzeige mit zwei Fingern im Menü zur Fehlerbehebung. Wählen Sie dann Anzeigenprüftool öffnen aus.

Wenn Sie Ihre Gerät angezeigt wird, werden Sie möglicherweise gebeten, um sich in Ihrem Ad Manager-Konto anzumelden.

Sie können auch in den Einstellungen zur Fehlerbehebung die Option Einstellungen für das Anzeigenprüftool auswählen und wählen Sie eine Touch-Geste aus, mit der Sie das Anzeigenprüftool zukünftig öffnen können, ohne über das Menü zur Fehlerbehebung.

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 werden. programmatisch.

Anzeigenblöcke aufrufen und Fehler beheben

Daraufhin wird der Hauptbildschirm des Anzeigenprüftools angezeigt. Er enthält eine Liste aller Anzeigenblöcke das Gerät Anzeigenanfragen gesendet hat, da das Anzeigenprüftool in diesem Zeitraum App-Sitzung. Die Liste enthält auch Anzeigenblöcke, für die Bidding aktiviert und sortiert ist chronologisch absteigend nach Datum sortiert zuerst keine abgeschlossenen Anzeigenanfragen (abgedunkelt):

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

Details zur Vermittlungsabfolge für einen Anzeigenblock aufrufen

Sie können einen Anzeigenblock antippen, um sein SDK-Anfrageprotokoll einzusehen. Darin wird die Vermittlungsabfolge erfasst, bis die Anzeige für die letzten Anzeigenanfragen ausgeliefert oder die Abfolge ohne Auslieferung 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 die Fehlermeldungen direkt vom Anzeigenquelle. Weitere Informationen finden Sie bei Ihrer Drittanbieter-Anzeigenquelle.

Gebotsdetails für einen Anzeigenblock aufrufen

Wenn Sie Bidding noch nicht kennen, lesen Sie 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 der einzelnen Anzeigenquellen in der Bidding-Auktion ausgewählt werden.

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 auftreten. Folgen Sie den Schritte zur Fehlerbehebung für die Probleme am Ende der FAQs zu Geboten.

  • Dann gibt es die Werbenetzwerke, bei denen keine Anzeigen zurückgegeben wurden oder keine Gebote abgegeben wurden. Dieses ist ein möglicher Indikator für viele verschiedene Probleme mit der Anzeigenquelle, hat möglicherweise aufgrund der Einrichtung oder Entscheidungsfindung kein Gebot. Weitere Informationen finden Sie im Einrichtungsleitfaden der Anzeigenquelle oder Sie können sich Weitere Informationen zu Open Bidding

  • Am Ende der Liste sehen Sie die Werbenetzwerke, bei denen die Gebotsabgabe verloren gegangen ist. Auktion.

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

Eine Vermittlungsabfolge ist das Ergebnis mehrerer Ertragsgruppen, die um dasselbe Inventar konkurrieren. Sie können bis zu zehn Drittanbieter-Ertragspartner in Ertragsgruppe, einschließlich Bidding-Ertragspartnern und Vermittlung für Mobilgeräte App-Ertragspartnern verfügbar sind.

Erweiterte Fehlerbehebung für Anzeigenblöcke

Bei der Fehlerbehebung für Anzeigenblöcke kann es hilfreich sein, die Anzeigenanfrage und die Reaktion darauf zu prüfen, wo ein Fehler auftritt, oder ihn mit Google zu teilen Unterstützung bei der Fehlerbehebung. Tippe oben im Wasserfall auf das Menüsymbol und wählen Sie Anzeigenanfrage und -antwort teilen aus, um die vollständige Anzeigenanfrage und Antwort. So müssen Sie keine Netzwerk-Traces auf Ihrem eigenen App.

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, bei denen Probleme auftreten könnten. So können Sie Ihre 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 Adapter von Drittanbietern aufzurufen. mit den Anzeigenquellen in den Gebots- oder Vermittlungskonfigurationen Ihrer App. Maximieren Sie dann die Karten, um ihren Initialisierungsstatus und SDK-Versionen anzusehen. Neben unterstützten Drittanbieteradaptern können Sie sich auch Adapter für benutzerdefinierte Ereignisse ansehen. Mit benutzerdefinierten Ereignissen Publisher nutzen Werbenetzwerke, Ad Manager nicht unterstützt wird. Benutzerdefinierte Ereignisse unterscheiden sich von standardmäßigen Drittanbieter-Ereignissen. Adapter in der Adapterliste nach ihren eindeutigen Klassennamen an. Zusätzlich zu mit Kursnamen und -statusinformationen, wird im Anzeigenprüftool auch der die diesen benutzerdefinierten Ereignissen in der Ad Manager Web-UI.

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

Anzeigenblöcke testen

Wenn Sie Ihren Anzeigenblock testen möchten, ohne in Ihrem App-Benutzeroberfläche wird dies vom Anzeigenprüftool direkt auf dem Detailbildschirm des Anzeigenblocks unterstützt. Außerdem können Sie mehrere Anzeigenblöcke gleichzeitig testen, und Ihre Testanzeigenanfragen 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 den Anzeigenblock testen möchten, tippen Sie auf die Schaltfläche Testanzeige anfordern unter oben auf dem Bildschirm, um den Anzeigentest auszulösen. Testen werden die Ergebnisse im SDK-Anfrageprotokoll unter der Kopfzeile Angefordert aus dem Anzeigenprüftool.

Das Anzeigenprüftool in Ihrer App verwenden

Tests einzelner Anzeigenquellen

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.

Sie können diese Funktion aktivieren, indem Sie oben rechts den Schalter Test einer einzelnen Anzeigenquelle unten auf dem Bildschirm. Daraufhin wird das folgende Dialogfeld zur Auswahl der Anzeigenquelle angezeigt:

Sie müssen die Google Mobile-Anzeige initialisieren SDK bevor Sie einzelne Anzeigenquellen testen können.

Sie können dann eine einzelne Anzeigenquelle zum Testen auswählen. Nachdem Sie eine Anzeigenquelle ausgewählt haben, 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. Wir empfehlen, den Neustart der App zu erzwingen wenn Sie einen Test für eine einzelne Anzeigenquelle ausführen, um im Cache gespeicherte Anzeigen ungültig zu machen, die statt einer Anfrage über die ausgewählte Anzeigenquelle bereitgestellt werden.

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 auszuführen. Dabei spielt es keine Rolle, ob die Anzeigenquelle für Bidding oder 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.

Sie können beim Test einer einzelnen Anzeigenquelle auf einen Anzeigenblock tippen, um sein 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 mit einer Beschreibung des Fehlers angezeigt.

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, nach dem Beenden des Tests einen Neustart Ihrer App zu erzwingen, um alle im Cache gespeicherten Anzeigen für die getestete Anzeigenquelle ungültig 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 IhrerAd Manager App, des Adapterinitialisierungsstatus und der Testergebnisse aller Anzeigenblöcke.

Tippen Sie dazu siebenmal auf das App-Symbol, bis die Meldung Anzeige kopierte Anzeige erscheint. Inspector-JSON in die Zwischenablage einfügen.