Mit dem Anzeigenprüftool können Sie:
- Anzeigenblöcke prüfen
- Prüfen, ob Ihre Anzeigen wie erwartet ausgeliefert werden
- Fehler ermitteln und Details zu deren Behebung anzeigen
- Details zu jedem Open Bidding-Werbenetzwerk pro Anfrage ansehen
- Vermittlungsdetails für jedes Werbenetzwerk pro Anfrage aufrufen
- Einzelne Anzeigenquellen von Drittanbietern für Open Bidding oder abfolgebasierte Vermittlung testen
- Prüfen Sie, ob alle Anzeigenblöcke für Open Bidding und die Vermittlungsabfolge korrekt konfiguriert sind.
In diesem Leitfaden erfahren Sie, wie Sie die verschiedenen Funktionen des Anzeigenprüftools starten und verwenden.
Voraussetzungen
Damit Sie das Anzeigenprüftool verwenden können, müssen Sie Folgendes tun:
- Arbeiten Sie den Startleitfaden durch.
- Verwenden Sie mindestens Version 8.10.0 des Google Mobile Ads SDK.
- Aktivieren Sie den Testmodus oder verknüpfen Sie Ihr Gerät mit Ad Manager. Das Anzeigenprüftool wird nur auf Test- oder verknüpften Geräten gestartet.
Anzeigenprüftool starten
Sie können das Anzeigenprüftool auf folgende Arten in Ihrer App starten:
- Klicken Sie im Menü zur Fehlerbehebung auf die Schaltfläche „Starten“.
- Verwenden Sie die Touch-Geste, die Sie in den Einstellungen des Anzeigenprüftools ausgewählt haben.
- Programmgesteuert mithilfe der bereitgestellten API
Mit Menü zur Fehlerbehebung starten
Es sind keine Änderungen an Ihrer App erforderlich, 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:
Swift
GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
// Error will be non-nil if there was an issue and the inspector was not displayed.
}
Objective-C
[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
completionHandler:^(NSError *error) {
// Error will be non-nil if there was an issue and the inspector was not displayed.
}];
Diese API funktioniert für Testgeräte, die programmatisch oder in der AdMob-Benutzeroberfläche registriert .
Der an diese API übergebene Ansichts-Controller muss bereits vollständig auf dem Bildschirm sichtbar sein (viewDidAppear: wurde aufgerufen). Wenn der übergebene Ansichts-Controller gerade angezeigt wird, z. B. wenn die API in der Funktion viewDidLoad des Ansicht-Controllers aufgerufen wird, schlägt die Darstellung des Anzeigenprüftools fehl.
Anzeigenblöcke aufrufen und Fehler beheben
Nach dem Start wird der Hauptbildschirm des Anzeigenprüftools angezeigt. Er enthält eine Liste aller Anzeigenblöcke das Gerät hat Anzeigenanfragen gesendet, seit das Anzeigenprüftool in dieser App-Sitzung aktiviert wurde. Die Liste enthält auch Anzeigenblöcke, für die Open Bidding aktiviert ist. Diese sind chronologisch geordnet, wobei die am häufigsten abgeschlossenen Anfragen an erster Stelle und diejenigen ohne abgeschlossene Anzeigenanfragen (abgeblendet) angezeigt werden:
Wir empfehlen, das Google Mobile Ads SDK zu initialisieren, bevor Sie das Anzeigenprüftool verwenden.
Details zur Vermittlungsabfolge für einen Anzeigenblock ansehen
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 Offenlegungsindikators erweitert werden, um die Ergebnisse der Vermittlungsabfolge für diese Anfrage zusammen mit etwaigen Fehlern und Latenzen anzuzeigen, die für diese Anfrage relevant waren.
Bei Anzeigenquellen von Drittanbietern werden die 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 mit Open Bidding noch nicht vertraut sind, lesen Sie die Einführung in Open Bidding.
Im SDK-Anfrageprotokoll sind die Open Bidding Anzeigenquellen zu sehen, die in der Anzeigenanfrage aufgerufen werden. Tippen Sie im SDK-Anfrageprotokoll auf einen Anzeigenblock, um die Details der einzelnen Anzeigenquellen in der Open Bidding Auktion aufzurufen.
Die Ergebnisse Open Bidding werden so sortiert, dass sich die umsetzbaren Elemente näher an den Anfang der Liste bringen:
Ganz oben ist das Werbenetzwerk zu sehen, das die Auktion gewonnen hat.
Als Nächstes sehen Sie die Werbenetzwerke, bei denen Probleme auftreten. Weitere Informationen finden Sie in den Schritte zur Fehlerbehebung am Ende der Open Bidding FAQs.
Dann gibt es die Werbenetzwerke, für die keine Anzeigen zurückgegeben wurden oder für die kein Gebot abgegeben wurde. Dies ist ein möglicher Indikator für viele verschiedene Probleme mit der Anzeigenquelle, da sie aufgrund der Einrichtung oder Entscheidung möglicherweise kein Gebot abgegeben hat. Weitere Informationen finden Sie im Einrichtungsleitfaden für die Anzeigenquelle. Alternativ können Sie sich auch Häufig gestellte Fragen zu Open Bidding.
Am Ende der Liste sehen Sie die Werbenetzwerke, die die AuktionOpen Bidding verloren haben.
Die Vermittlungsabfolge kann die Anzeigenquelle, die die AuktionOpen Bidding gewonnen hat, entsprechend ihrem eCPM-Wert platzieren.
Eine Vermittlungsabfolge entsteht, wenn mehrere Ertragsgruppen um dasselbe Inventar konkurrieren. Sie können einer einzelnen Ertragsgruppe bis zu zehn Drittanbieter-Ertragspartner hinzufügen, einschließlich Open Bidding-Ertragspartnern und Vermittlung für Ertragspartner für mobile Apps.
Erweiterte Fehlerbehebung für Anzeigenblöcke
Bei der Fehlerbehebung für Anzeigenblöcke kann es hilfreich sein, die Anzeigenanfrage und -antwort zu analysieren, um herauszufinden, wo ein Fehler auftritt, oder ihn an den Google-Support weiterzugeben, um ihn bei der Fehlerbehebung zu unterstützen. Tippen Sie oben in der Vermittlungsabfolge auf das Menüsymbol und wählen Sie Anzeigenanfragen und -antwort teilen aus, um die vollständige Anzeigenanfrage und -antwort zu exportieren. So müssen Sie Netzwerk-Traces nicht in Ihrer eigenen Anwendung 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.
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 Adaptern von Drittanbietern können Sie auch benutzerdefinierte Ereignisadapter aufrufen. Mit benutzerdefinierten Ereignissen können Publisher Werbenetzwerke verwenden, die Ad Managernicht unterstützt werden. Benutzerdefinierte Ereignisse unterscheiden sich von standardmäßigen Drittanbieteradaptern in der Adapterliste durch ihre eindeutigen Klassennamen. Neben Klassennamen und Informationen zum Status zeigt das Anzeigenprüftool auch die Labels an, die diesen benutzerdefinierten Ereignissen auf derAd Manager -Weboberfläche zugewiesen wurden.
Falls der Adapter nicht gefunden wird oder nicht initialisiert werden kann, finden Sie weitere Informationen unter Anzeigenauslieferung in mobilen Apps prüfen .
Anzeigenblöcke testen
Wenn Sie Ihren Anzeigenblock testen möchten, ohne ihn über die Benutzeroberfläche Ihrer App aufrufen zu müssen, können Sie das Anzeigenprüftool direkt über den Bildschirm mit den Anzeigenblockdetails verwenden. Außerdem können Sie mehrere Anzeigenblöcke gleichzeitig testen, Ihre Testanzeigenanfragen asynchron laden und aufrufen und sogar Tests für einzelne Anzeigenquellen durchführen.
Anzeigentests
Mit den in diesem Abschnitt beschriebenen Anzeigentests im Anzeigenprüftool können Sie die Nutzerfreundlichkeit von Werbeanzeigen überprüfen und Ihre Vermittlungskonfiguration mit Tests für einzelne Anzeigenquellen prüfen.
Wenn Sie den Anzeigenblock testen möchten, tippen Sie oben im Anzeigenprüftool auf die Schaltfläche Testanzeige anfordern, um den Anzeigentest auszulösen. Die Testergebnisse werden dann im SDK-Anfrageprotokoll unter dem Header Angefordert vom Anzeigenprüftool angezeigt.
Einzelne Anzeigenquelle testen
Das Anzeigenprüftool bietet eine Funktion, mit der Anzeigenanfragen in Ihrer App so eingeschränkt werden, dass nur Anzeigen aus einer einzelnen Anzeigenquelle Open Bidding oder abfolgebasierter Vermittlung ausgeliefert werden. So können Sie prüfen, ob Sie den Drittanbieter-Adapter richtig implementiert haben und ob die Anzeigenquelle wie erwartet ausgeliefert wird.
Wenn Sie diese Funktion aktivieren möchten, klicken Sie unten auf dem Bildschirm auf den Schalter Einzelne Anzeigenquelle testen. Daraufhin wird das folgende Dialogfeld zur Auswahl der Anzeigenquelle angezeigt:
Sie müssen das Google Mobile Ads SDK initialisieren, bevor Sie Tests für einzelne Anzeigenquellen ausführen können.
Anschließend können Sie eine einzelne Anzeigenquelle zum Testen auswählen. Nach Auswahl einer Anzeigenquelle wird der folgende Bildschirm angezeigt:
Die Testeinstellung für eine einzelne Anzeigenquelle wird auf alle zukünftigen Anzeigenanfragen in derselben Sitzung angewendet. Sie gilt jedoch nicht für zuvor im Cache gespeicherte Anzeigen in dieser Sitzung, die noch nicht ausgeliefert wurden. Wir empfehlen, den Neustart der App zu erzwingen, wenn Sie einen Test für eine einzelne Anzeigenquelle ausführen. So werden im Cache gespeicherte Anzeigen ungültig, die anstelle der von der ausgewählten Anzeigenquelle ausgelieferten Anfrage ausgeliefert werden 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, wenn der Test einer einzelnen 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 zu testende Anzeigenquelle nicht in der Vermittlungsabfolge für einen Anzeigenblock befindet, wird die Fehlermeldung „Keine Ausführung“ angezeigt.
Beim Test einer einzelnen Anzeigenquelle können Sie auf einen Anzeigenblock tippen, um das zugehörige SDK-Anfrageprotokoll aufzurufen. So erfahren Sie, 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.
Wenn Sie einem Vermittlungsabfolge 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 einer einzelnen 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, den Neustart Ihrer App nach dem Beenden des Tests zu erzwingen, damit im Cache gespeicherte Anzeigen der getesteten Anzeigenquelle ungültig werden.
Gesamte Debugging-Ausgaben kopieren
Das Anzeigenprüftool unterstützt das Kopieren eines JSON-Strings mit den gesamten Debugging-Ausgaben aus dem Tool, einschließlich Details zu IhrerAd Manager -App, den Initialisierungsstatus des Adapters und die Testergebnisse aller Anzeigenblöcke.
Tippen Sie dazu siebenmal auf das App-Symbol, bis die Meldung Copy ad Inspector JSON to Zwischenablage angezeigt wird.