In diesem Leitfaden erfahren Sie, wie Sie die verschiedenen Funktionen des Anzeigenprüftools starten und verwenden.
Vorbereitung
Voraussetzungen für die Verwendung des Anzeigenprüftools:
- Lesen Sie sich den Startleitfaden durch.
- Verwenden Sie das Google Mobile Ads SDK in der Version 9.1.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
Das Anzeigenprüftool kann von überall in Ihrer App auf folgende Weise gestartet werden:
- Verwenden Sie die Geste, die Sie in der AdMob-Benutzeroberfläche bei der Registrierung eines Testgeräts ausgewählt haben.
- Programmatisch über die bereitgestellte API.
- Verwenden Sie die Startschaltfläche 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 haben (und 15 Minuten gewartet haben, bis die Änderung übernommen wurde), muss Ihre App eine Anzeigenanfrage senden, damit das Google Mobile Ads SDK Ihre Gesteneinstellung erkennt. Wenn die von Ihnen festgelegte 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 aufrufen
Sie können einen Anzeigenblock antippen, um sein SDK-Anfrageprotokoll einzusehen. Darin werden die Details der Vermittlungsabfolge bis zu dem Punkt erfasst, an dem die Anzeige für die letzten Anzeigenanfragen ausgeliefert wurde (oder die Abfolge ohne Auslieferung beendet wurde).
Jede Anfrage kann mithilfe des Offenlegungsindikators maximiert werden, um die Ergebnisse der Vermittlungsabfolge für diese Anfrage sowie alle Fehler und Latenzen anzuzeigen, 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 ansehen
Wenn Sie mit Geboten noch nicht vertraut 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 so sortiert, dass die Elemente, für die Maßnahmen erforderlich sind, weiter oben in der Liste angezeigt werden:
An erster Stelle steht das Werbenetzwerk, das die Auktion gewonnen hat.
Als Nächstes werden die Werbenetzwerke mit Problemen aufgeführt. Folgen Sie den Schritten zur Fehlerbehebung.
Dann gibt es noch die Werbenetzwerke, bei denen keine Anzeigen zurückgegeben wurden oder keine Gebote abgegeben wurden. Das kann ein Zeichen für verschiedene Probleme mit der Anzeigenquelle sein, da sie aufgrund ihrer Einrichtung oder Entscheidungsfindung möglicherweise keine Gebote abgegeben hat. Sie können die Einrichtungsanleitung der Anzeigenquelle lesen oder sich direkt an die Anzeigenquelle wenden, um Support zu erhalten.
Am Ende der Liste stehen 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, können Anzeigen ausgeliefert werden. Weitere Informationen zur Funktionsweise von Bidding mit einer Vermittlungsabfolge finden Sie in 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, die Anzeigenanfrage und die Antwort zu untersuchen, um festzustellen, wo ein Fehler auftritt, oder sie an den Google-Support weiterzugeben, um die Fehlerbehebung zu unterstützen. Tippen Sie oben in der Vermittlungskette 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 für den Anfragestring auf die Option Drittanbieter-Bidding-Parameter tippen. Hier finden Sie Details dazu, bei welchen Bidding-Parametern von Drittanbietern möglicherweise Probleme auftreten. So können Sie Fehler in Ihrer App beheben oder prüfen, ob ein Werbenetzwerk seine Signale erfolgreich erfasst.
Verfügbare Adapter ansehen
Klicken Sie auf den Tab Adapter, um eine Liste aller Drittanbieteradapter aufzurufen, die mit den Anzeigenquellen in den Bidding- oder Vermittlungskonfigurationen in Ihrer App verknüpft sind. Maximieren Sie dann die Karten, um den Initialisierungsstatus und die SDK-Versionen zu sehen. Neben unterstützten Drittanbieteradaptern können Sie auch Adapter für benutzerdefinierte Ereignisse aufrufen.
Mit benutzerdefinierten Ereignissen können Publisher Werbenetzwerke verwenden, die von AdMob nicht unterstützt werden. Benutzerdefinierte Ereignisse unterscheiden sich von Standardadaptern von Drittanbietern in der Adapterliste durch ihre eindeutigen Klassennamen. Das Anzeigenprüftool liefert nicht nur Informationen zum Klassennamen und Status, sondern zeigt auch die Labels an, die diesen benutzerdefinierten Ereignissen in der AdMob-Weboberfläche zugewiesen sind.
Wenn der Adapter nicht gefunden wird oder nicht initialisiert werden kann, finden Sie weitere Informationen unter Mithilfe des Anzeigenprüftools gefundene Probleme beheben.
Anzeigenblöcke testen
Wenn Sie Ihren Anzeigenblock testen möchten, ohne ihn in der Benutzeroberfläche Ihrer App aufrufen zu müssen, können Sie das im Anzeigenprüftool direkt auf dem Bildschirm mit den Details zum Anzeigenblock tun. 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 grundlegende Nutzerfreundlichkeit von Werbeanzeigen zu überprüfen und Ihre Vermittlungskonfiguration zu validieren, wenn Sie sie mit Tests für einzelne Anzeigenquellen verwenden.
Wenn Sie Ihren Anzeigenblock testen möchten, tippen Sie oben auf dem Bildschirm des Anzeigenprüftools auf Testanzeige anfordern, um den Anzeigentest im Anzeigenprüftool zu starten. Die Testergebnisse werden dann im SDK-Anfrageprotokoll unter der Überschrift Vom Anzeigenprüftool angefordert angezeigt.
Tests einzelner Anzeigenquellen
Das Anzeigenprüftool bietet eine Funktion, mit der Sie Anzeigenanfragen in Ihrer App so einschränken können, dass nur Anzeigen aus einer einzigen Bidding- oder abfolgebasierten Vermittlungsanzeigenquelle 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. 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. Sie 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 anstelle der ausgewählten Anzeigenquelle ausgeliefert werden könnten, die eine Anfrage erhält.
Nach dem Neustart der App werden bei allen Anzeigenblock-Placements nur Anzeigen aus dem ausgewählten Werbenetzwerk 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 eine Anzeige nicht laden konnte, wird eine Fehlermeldung angezeigt, in der der Fehler beschrieben wird.
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 für eine einzelne Anzeigenquelle beenden
Wenn Sie den Test beenden möchten, deaktivieren Sie den Schalter:
Anschließend wird eine Bestätigungsmeldung über dem folgenden Neustartbildschirm 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 löschen.
Datenschutzeinstellungen für die Fehlerbehebung
Voraussetzungen: Google Mobile Ads SDK, Version 9.6.0 oder höher
Mit dem Anzeigenprüftool können Sie die folgenden Datenschutzsignale aufrufen, 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 im Anzeigenprüftool einen Anzeigentest durchgeführt haben, tippen Sie im SDK-Anfrageprotokoll auf das Menüsymbol der Anfrage. Wählen Sie als Nächstes die Option Datenschutzsignale aus.
Auf dem Bildschirm Datenschutzsignale werden die in der Anzeigenanfrage übergebenen Datenschutzsignale angezeigt.
Weitere Informationen zum AC-String finden Sie in der technischen Google-Spezifikation „Zusätzliche Einwilligung“. Wenn Sie detaillierte Einwilligungsinformationen im TC-String sehen möchten, z. B. die CMP-ID und die Liste der Anbieter-IDs mit Einwilligung, die mit dem IAB verknüpft sind, klicken Sie auf Decodieren, um den IAB GPP Encoder / Decoder zu öffnen.
Wenn Fehler auftreten, folgen Sie den Schritten unter Datenschutzprobleme verstehen, um sie zu beheben.
Vollständige Debugging-Ausgaben kopieren
Das Anzeigenprüftool unterstützt das Kopieren eines JSON-Strings, der die gesamten Debugging-Ausgaben des Tools enthält, einschließlich Details zu Ihrer AdMob-App, Adapterinitialisierungsstatus und Testergebnissen aller Anzeigenblöcke.
Tippen Sie dazu siebenmal auf das App-Symbol, bis die Meldung JSON-Datei des Anzeigenprüftools in die Zwischenablage kopiert angezeigt wird.