In diesem Leitfaden wird beschrieben, wie Sie die verschiedenen Funktionen im Anzeigenprüftool starten und verwenden.
Vorbereitung
Voraussetzungen für die Verwendung des Anzeigenprüftools:
- Führen Sie die Schritte im Startleitfaden aus.
- Verwenden Sie das Google Mobile Ads SDK Version 9.1.0 oder höher.
- Fügen Sie Ihr Gerät als Testgerät hinzu. Das Anzeigenprüftool kann nur auf Testgeräten gestartet werden.
Anzeigenprüftool starten
Das Anzeigenprüftool kann auf folgende Arten von überall in Ihrer App gestartet werden:
- Verwenden Sie die Geste, die Sie in der AdMob-Benutzeroberfläche beim Registrieren eines Testgerätsausgewählt haben.
- Programmatisch über die bereitgestellte API.
- Verwenden Sie die Schaltfläche zum Starten im Debug-Menü.
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 aus, die Sie in AdMob für dieses Testgerät konfiguriert haben (doppelte Drehung oder Schütteln des Handgelenks). Weitere Informationen
Nachdem Sie in der AdMob-Benutzeroberfläche eine Touchgeste festgelegt haben (und 15 Minuten gewartet haben, bis sie übernommen wurde), muss Ihre App eine Anzeigenanfrage senden, damit das Google Mobile Ads SDK Ihre Gesteneinstellung erfährt. Wenn die von Ihnen angegebene Touchgeste nicht funktioniert, versuchen Sie, eine Anzeige zu laden, starten Sie die App neu und testen Sie die Touchgeste noch einmal.
Programmatisch starten
Das Anzeigenprüftool kann auch programmatisch gestartet werden:
Diese API funktioniert für Testgeräte, die programmatisch oder in der AdMob-Benutzeroberfläche registriert wurden.
Anzeigenblöcke ansehen und Fehler beheben
Nach dem Start wird der Hauptbildschirm des Anzeigenprüftools angezeigt. Er enthält eine Liste aller Anzeigen blöcke in der AdMob-Benutzeroberfläche, die mit Ihrer AdMob-App-ID verknüpft sind und Bidding- oder Vermittlungs konfigurationen haben:
Wir empfehlen, das Google Mobile Ads SDK zu initialisieren, bevor Sie das Anzeigen prüftool verwenden.
Details zur Vermittlungsabfolge für einen Anzeigenblock ansehen
Tippen Sie auf einen Anzeigenblock, um sein SDK-Anfrageprotokoll aufzurufen. Darin werden die Details zur Vermittlungsabfolge erfasst, bis die Anzeige für die letzten Anzeigenanfragen ausgeliefert oder die Abfolge ohne Auslieferung beendet wurde.
Jede Anfrage kann mit dem Offenlegungsindikator erweitert werden, um die Ergebnisse der Vermittlungsabfolge für diese Anfrage sowie alle Fehler und Latenzen anzuzeigen, die für diese Anfrage relevant waren.
Bei Anzeigenquellen von Drittanbietern werden Fehlermeldungen direkt von der Anzeigenquelle gesendet. Weitere Informationen finden Sie bei Ihrer Drittanbieter-Anzeigenquelle.
Bidding-Details für einen Anzeigenblock ansehen
Wenn Sie noch keine Erfahrung mit Bidding haben, 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 sind so sortiert, dass die umsetzbaren Elemente weiter oben in der Liste stehen:
Ganz oben steht das Werbenetzwerk, das die Auktion gewonnen hat.
Als Nächstes werden die Werbenetzwerke mit Problemen aufgeführt. Sie können die Schritte zur Fehlerbehebung für die Probleme ausführen.
Dann folgen 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. Möglicherweise wurde aufgrund der Einrichtung oder Entscheidungsfindung kein Gebot abgegeben. Sie können den Einrichtungsleitfaden der Anzeigen quelle lesen oder sich direkt an die Anzeigenquelle wenden, um Unterstützung zu erhalten.
Ganz unten in 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, kann sie Anzeigen bereitstellen. Weitere Informationen zur Funktionsweise von Bidding mit der Vermittlungsabfolge finden Sie in Beispiel 2 und Beispiel 3 unter Bidding und abfolgebasierte 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 genauer zu untersuchen, um herauszufinden, wo ein Fehler auftritt. Sie können die Informationen auch an den Google-Support weitergeben, um bei der Fehlerbehebung zu helfen. 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 sparen Sie sich die Mühe, Netzwerk-Traces in Ihrer eigenen App auszuführen.
Außerdem können Sie decodierte Bidding-Parameter von Drittanbietern aufrufen. Tippen Sie dazu im selben Menü wie den Anfragestring auf die Option Drittanbieter-Bidding-Parameter. Hier finden Sie Details zu den Bidding-Parametern von Drittanbietern, bei denen möglicherweise Probleme auftreten. So können Sie Fehler in Ihrer App beheben oder überprüfen, ob ein Netzwerk seine Signale erfolgreich erfasst.
Verfügbare Adapter ansehen
Klicken Sie auf den Tab Adapter. Dort sehen Sie eine Liste aller Drittanbieter-Adapter, die mit den Anzeigenquellen in den Bidding- oder Vermittlungskonfigurationen in Ihrer App verknüpft sind. Erweitern Sie dann die Karten, um die Initialisierungsstatus und SDK-Versionen aufzurufen. Neben unterstützten Drittanbieter-Adaptern können Sie auch Adapter für benutzerdefinierte Ereignisse ansehen.
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 Standard-Drittanbieter-Adaptern unterscheiden. Neben dem Klassennamen und dem Status werden im Anzeigenprüftool auch die Labels angezeigt, die diesen benutzerdefinierten Ereignissen in der AdMob-Weboberfläche zugewiesen wurden.
Wenn der Adapter nicht gefunden wird oder die Initialisierung fehlschlägt, finden Sie weitere Informationen unter Fehlerbehebung bei Problemen, die mit dem Anzeigenprüftool gefunden wurden.
Anzeigenblöcke testen
Wenn Sie Ihren Anzeigenblock testen möchten, ohne in der Benutzeroberfläche Ihrer App dorthin navigieren zu müssen, können Sie das Anzeigenprüftool direkt auf dem Detailbildschirm des Anzeigenblocks verwenden. Außerdem können Sie mehrere Anzeigenblöcke gleichzeitig testen, Ihre Test-Anzeigenanfragen asynchron laden und ansehen und sogar Tests für einzelne Anzeigenquellen durchführen.
Anzeigentests
Die in diesem Abschnitt beschriebenen Anzeigentests des Anzeigenprüftools sind ein nützliches Tool, um die grundlegende Nutzerfreundlichkeit von Werbeanzeigen zu überprüfen und Ihre Vermittlungskonfiguration zu validieren, wenn sie mit Tests für einzelne Anzeigenquellen verwendet werden.
Wenn Sie Ihren Anzeigenblock testen möchten, tippen Sie oben auf dem Bildschirm des Anzeigenprüftools auf die Schaltfläche Testanzeige anfordern , um den Anzeigentest des Anzeigenprüftools auszulösen. Die Testergebnisse werden dann im SDK-Anfrageprotokoll unter der Überschrift Über das Anzeigenprüftool angefordert angezeigt.
Tests für einzelne Anzeigenquellen
Das Anzeigenprüftool bietet eine Funktion, mit der Anzeigenanfragen in Ihrer App so eingeschränkt werden können, dass nur Anzeigen aus einer einzelnen Bidding- oder abfolgebasierte Vermittlungs-Anzeigenquelle ausgeliefert werden. So lässt sich feststellen, ob Sie den Drittanbieter-Adapter richtig implementiert haben und ob die Anzeigenquelle wie erwartet ausgeliefert wird.
Aktivieren Sie diese Funktion, indem Sie unten auf dem Bildschirm den Schalter Einzelne Anzeigenquelle testen aktivieren. 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 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. 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 anwenden, um alle im Cache gespeicherten Anzeigen zu löschen, die ausgeliefert werden könnten, anstatt dass Ihre 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.
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 ausgeliefert oder die Abfolge ohne Auslieferung beendet wurde.
Test für eine einzelne Anzeigenquelle beenden
Wenn Sie den Test beenden möchten, deaktivieren Sie den Schalter:
Daraufhin wird über dem folgenden Neustartbildschirm eine Bestätigungsnachricht angezeigt:
Wir empfehlen, einen Neustart der App zu erzwingen, nachdem Sie den Test beendet haben, um alle im Cache gespeicherten Anzeigen für die getestete Anzeigenquelle zu löschen.
Fehlerbehebung bei Datenschutzeinstellungen
Voraussetzungen: Google Mobile Ads SDK Version 9.6.0 oder höher
Mit dem Anzeigenprüftool können Sie die folgenden Datenschutzeinstellungen ansehen, die im Rahmen der Publisher-Integration mit dem IAB Europe TCF in der Anzeigenanfrage übergeben werden:
- DSGVO gilt (
IABTCF_gdprApplies) - AC-String (
IABTCF_AddtlConsent) - TC-String (
IABTCF_TCString)
Nachdem Sie eine Anzeige geladen oder Anzeigentests im Anzeigenprüftool durchgeführt haben, tippen Sie im SDK-Anfrageprotokoll unter SDK-Anfrageprotokollauf das Menüsymbol für die 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 zum AC-String finden Sie in der 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-IDs von Anbietern, 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 beheben.
Vollständige Debugging-Ausgaben kopieren
Das Anzeigenprüftool unterstützt das Kopieren eines JSON-Strings, der die vollständigen Debugging-Ausgaben des Tools enthält, einschließlich Details zu Ihrer AdMob-App, Initialisierungsstatus der Adapter und Testergebnisse aller Anzeigenblöcke.
Tippen Sie dazu sieben Mal auf das App-Symbol, bis die Meldung Anzeigenprüftool-JSON in die Zwischenablage kopiert angezeigt wird.