In diesem Leitfaden wird gezeigt, wie Sie die verschiedenen Funktionen in der Anzeigenprüfung starten und verwenden.
Vorbereitung
Voraussetzungen für die Verwendung des Anzeigenprüftools:
- Arbeiten Sie den Startleitfaden durch.
- Verwenden Sie das Google Mobile Ads SDK in der Version 9.1.0 oder höher.
- Gerät als Testgerät hinzufügen Das Anzeigenprüftool wird nur auf Testgeräten gestartet.
Anzeigenprüftool starten
Das Anzeigenprüftool kann an beliebiger Stelle in Ihrer App auf folgende Weise gestartet werden:
- Verwenden Sie die Geste, die Sie in der AdMob-Benutzeroberfläche ausgewählt haben, wenn Sie ein Testgerät registrieren.
- Programmatisch über die bereitgestellte API.
- Verwenden Sie den Start-Button im Menü zur Fehlerbehebung.
Mit Gesten starten
Sie müssen keine Änderungen an Ihrer App vornehmen, um das Anzeigenprüftool mit einer Geste zu starten. Führen Sie einfach die Geste (doppelte Drehung oder Schütteln des Handgelenks) aus, die Sie in AdMob für dieses Testgerät konfiguriert haben. Weitere Informationen
Nachdem Sie eine Geste in der AdMob-Benutzeroberfläche festgelegt und 15 Minuten gewartet haben, bis die Änderung übernommen wurde, muss Ihre App eine Anzeigenanfrage senden, damit das Google Mobile Ads SDK Ihre Gesteneinstellung erfährt. Wenn die angegebene Geste nicht funktioniert, versuchen Sie, eine Anzeige zu laden, starten Sie die App neu und testen Sie die Geste noch einmal.
Programmatisch starten
Das Anzeigenprüftool kann auch programmatisch gestartet werden:
Diese API funktioniert für Testgeräte, die programmatisch oder über die 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 in der AdMob-Benutzeroberfläche, die mit Ihrer AdMob-App-ID verknüpft sind und für die Bidding- oder Vermittlungskonfigurationen vorhanden sind:
Wir empfehlen, das Google Mobile Ads SDK zu initialisieren, bevor Sie das Anzeigenprüftool verwenden.
Details zur Vermittlungsabfolge für einen Anzeigenblock ansehen
Sie können einen Anzeigenblock antippen, um sein SDK-Anfrageprotokoll einzusehen. Darin werden die Details zur Vermittlungsabfolge für die letzten Anzeigenanfragen erfasst, bis die Anzeige ausgeliefert oder die Abfolge ohne Auslieferung beendet wurde.
Jede Anfrage kann über das Offenlegungssymbol maximiert werden, um die Ergebnisse der Vermittlungsabfolge für diese Anfrage sowie alle Fehler und Latenzen anzuzeigen, die für diese Anfrage gelten.
Bei Anzeigenquellen von Drittanbietern werden Fehlermeldungen direkt von der Anzeigenquelle gesendet. Weitere Informationen finden Sie bei Ihrer Drittanbieter-Anzeigenquelle.
Gebotsdetails für einen Anzeigenblock ansehen
Wenn Sie neu bei Geboten sind, lesen Sie die Übersicht.
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 Bidding-Ergebnisse werden sortiert, damit die umsetzbaren Elemente weiter oben in der Liste angezeigt werden:
Oben sehen Sie das Werbenetzwerk, das die Auktion gewonnen hat.
Als Nächstes werden die Werbenetzwerke mit Problemen aufgeführt. Folgen Sie dazu dieser Anleitung.
Dann gibt es noch die Werbenetzwerke, bei denen keine Anzeigen zurückgegeben oder keine Gebote abgegeben wurden. Dies kann ein Zeichen für verschiedene Probleme mit der Anzeigenquelle sein, da sie aufgrund ihrer Einrichtung oder Entscheidungsfindung möglicherweise kein Gebot abgegeben hat. Sie können sich den Einrichtungsleitfaden der Anzeigenquelle ansehen oder sich direkt an die Anzeigenquelle wenden.
Ganz unten in der Liste finden Sie die Werbenetzwerke, die die Bidding-Auktion verloren haben.
In der Vermittlungsabfolge kann die Anzeigenquelle, die die Bidding-Auktion gewonnen hat, entsprechend ihrem eCPM-Wert platziert werden.
Wenn eine Anzeigenquelle in der Vermittlungsabfolge aufgerufen wird, kann sie Anzeigen bereitstellen. Weitere Informationen zur Funktionsweise von Bidding mit der Vermittlungsabfolge finden Sie unter Beispiel 2 und Beispiel 3 für Bidding- und abfolgebasierte Anzeigenquellen in einer Vermittlungsgruppe.
Erweiterte Fehlerbehebung bei Anzeigenblöcken
Bei der Fehlerbehebung für Anzeigenblöcke kann es hilfreich sein, sich die Anzeigenanfrage und -antwort genauer anzusehen, um herauszufinden, wo ein Fehler auftritt. Sie können diese Informationen auch mit dem Google-Support teilen, um die Fehlersuche zu erleichtern. Tippen Sie oben in der Wasserfallkette auf das Menüsymbol 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 für Ihre eigene App ausführen.
Außerdem können Sie decodierte Bidding-Parameter von Drittanbietern aufrufen, indem Sie im selben Menü wie der Anfragestring auf die Option Drittanbieter-Bidding-Parameter tippen. So erhalten Sie Informationen dazu, bei welchen Bidding-Parametern von Drittanbietern möglicherweise Probleme auftreten. Das kann Ihnen helfen, Fehler in Ihrer App zu beheben oder zu prüfen, ob ein Netzwerk seine Signale richtig erfasst.
Verfügbare Adapter ansehen
Klicken Sie auf den Tab Adapter, um eine Liste aller Drittanbieteradapter aufzurufen, die den Anzeigenquellen in den Bidding- oder Vermittlungskonfigurationen in Ihrer App zugeordnet sind. Maximieren Sie dann die Karten, um die Initialisierungsstatus und SDK-Versionen aufzurufen. Neben unterstützten Drittanbieteradaptern können Sie auch benutzerdefinierte Ereignisadapter aufrufen.
Mit benutzerdefinierten Ereignissen können Publisher Werbenetzwerke verwenden, die von AdMob nicht unterstützt werden. Benutzerdefinierte Ereignisse lassen sich in der Adapterliste anhand ihrer eindeutigen Klassennamen von Standardadaptern von Drittanbietern unterscheiden. 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 wird oder die Initialisierung fehlschlägt, finden Sie weitere Informationen unter Mithilfe des Anzeigenprüftools gefundene Probleme beheben.
Anzeigenblöcke testen
Wenn Sie Ihren Anzeigenblock testen möchten, ohne in der Benutzeroberfläche Ihrer App zu ihm navigieren zu müssen, können Sie das Anzeigenprüftool direkt über den Detailbildschirm des Anzeigenblocks verwenden. 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 Ihre grundlegende Nutzerfreundlichkeit von Werbeanzeigen zu überprüfen und Ihre Vermittlungskonfiguration zu validieren, wenn sie mit Tests für einzelne Anzeigenquellen verwendet werden.
Wenn Sie bereit sind, Ihren Anzeigenblock zu testen, tippen Sie oben auf dem Bildschirm des Anzeigenprüftools auf die Schaltfläche Testanzeige anfordern, um den Anzeigentest des Anzeigenprüftools zu starten. Die Testergebnisse werden dann im SDK-Anfrageprotokoll unter dem Header Requested from ad inspector (Über den Anzeigenprüftool angefordert) angezeigt.
Tests einzelner Anzeigenquellen
Mit dem Anzeigenprüftool können Sie Anzeigenanfragen in Ihrer App so einschränken, dass nur Anzeigen aus einer einzelnen Bidding- oder abfolgebasierten Vermittlungs-Anzeigenquelle ausgeliefert werden. So lässt sich feststellen, ob Sie den Drittanbieteradapter richtig implementiert haben und ob die Anzeigenquelle wie erwartet ausgeliefert wird.
Aktivieren Sie dazu unten auf dem Bildschirm den Schalter Einzelne Anzeigenquelle testen. Das folgende Dialogfeld zur Auswahl der Anzeigenquelle wird 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. Nachdem eine Anzeigenquelle ausgewählt wurde, 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 im Cache gespeicherte Anzeigen in dieser Sitzung, die noch nicht ausgeliefert wurden. Es wird empfohlen, einen Neustart der App zu erzwingen, wenn Sie einen Test für eine einzelne Anzeigenquelle durchführen. Dadurch werden alle im Cache gespeicherten Anzeigen ungültig, die möglicherweise ausgeliefert werden, anstatt dass die ausgewählte Anzeigenquelle eine Anfrage erhält.
Nach dem Neustart der App werden bei allen Anzeigenblock-Placements nur Anzeigen aus dem ausgewählten Netzwerk ausgeliefert. Wenn Sie das Anzeigenprüftool starten, während ein Test für eine einzelne Anzeigenquelle aktiv ist, wird die aktive Testanzeigenquelle angezeigt:
Im Einzeltestmodus für eine Anzeigenquelle wird davon ausgegangen, dass alle Anzeigenanfragen mit der ausgewählten Anzeigenquelle ausgeführt werden. Dabei spielt es keine Rolle, ob die Anzeigenquelle für Bidding 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.
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 laden konnte, wird eine Fehlermeldung mit einer Beschreibung des Fehlers angezeigt.
Wenn Sie einer Vermittlungsabfolge mehrere Instanzen der ausgewählten Anzeigenquelle hinzugefügt haben, 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 für eine einzelne Anzeigenquelle beenden
So beenden Sie den Test:
Über dem folgenden Neustartbildschirm wird dann eine Bestätigungsmeldung angezeigt:
Wir empfehlen, nach dem Beenden des Tests einen Neustart der App zu erzwingen, um alle im Cache gespeicherten Anzeigen für die getestete Anzeigenquelle zu invalidieren.
Datenschutzeinstellungen debuggen
Voraussetzungen: Google Mobile Ads SDK Version 9.6.0 oder höher
Mit dem Anzeigenprüftool können Sie die folgenden Datenschutzsignale ansehen, die im Rahmen der Integration des IAB Europe TCF für Publisher in der Anzeigenanfrage übergeben werden:
- Die DSGVO gilt (
IABTCF_gdprApplies) - String für zusätzliche Einwilligung (
IABTCF_AddtlConsent) - TC-String (
IABTCF_TCString)
Nachdem Sie eine Anzeige geladen oder Anzeigentests im Anzeigenprüftool durchgeführt haben, tippen Sie im SDK-Anfragelog auf das Dreipunkt-Menü der Anfrage. Wählen Sie dann die Option Datenschutzsignale aus.
Auf dem Bildschirm Datenschutzsignale werden die Datenschutzsignale angezeigt, die in der Anzeigenanfrage übergeben wurden.
Weitere Informationen zur technischen Google-Spezifikation „Zusätzliche Einwilligung“ Wenn Sie detaillierte Einwilligungsdaten im TC-String aufrufen möchten, z. B. die CMP-ID und die Liste der Einwilligungs-Anbieter-IDs, die mit dem IAB verknüpft sind, klicken Sie auf Decodieren, um den IAB GPP Encoder / Decoder zu öffnen.
Wenn Fehler auftreten, folgen Sie der Anleitung unter Datenschutzprobleme verstehen.
Vollständige Debugging-Ausgaben kopieren
Mit dem Anzeigenprüftool können Sie einen JSON-String kopieren, der die gesamten Debugging-Ausgaben des Tools enthält, einschließlich Details zu Ihrer AdMob-App, Adapterinitialisierungsstatus und Testergebnisse aller Anzeigenblöcke.
Tippen Sie dazu sieben Mal auf das App-Symbol, bis die Meldung JSON für Anzeigenprüfung in die Zwischenablage kopiert angezeigt wird.