Anzeigenprüftool

Anzeigenprüftool ist ein In-App-Overlay, mit dem autorisierte Geräte Testanzeigenanfragen direkt in einer mobilen App analysieren können. Der Dienst kann ohne Programmierkenntnisse aktiviert werden.

Bei mobilen Anzeigen Unity 7.0.0 und höher haben Sie folgende Möglichkeiten:

  • Anzeigenblöcke prüfen
  • Drittanbieteradapter prüfen
  • Prüfen, ob Ihre Anzeigen wie erwartet ausgeliefert werden
  • Fehler ermitteln und Details zu deren Behebung anzeigen
  • Details zu Bidding und abfolgebasierter Vermittlung für jedes Werbenetzwerk pro Anfrage ansehen
  • Einzelne Bidding- und Vermittlungsanzeigenquellen von Drittanbietern testen

  • Alle Anzeigenblöcke für Bidding und die Vermittlungsabfolge müssen richtig konfiguriert sein.

  • Integrationen benutzerdefinierter Ereignisse testen

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:

  • Verwenden Sie mindestens Unity Version des Mobile Ads-Plug-ins7.0.0 .

Anzeigenprüftool starten

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

  1. Verwenden Sie die in der AdMob-Benutzeroberfläche ausgewählte Touch-Geste, wenn Sie ein Testgerät registrieren.
  2. Programmgesteuert mithilfe der bereitgestellten API
  3. Klicken Sie im Menü zur Fehlerbehebung auf die Schaltfläche „Starten“.

Mit Touch-Gesten starten

Es sind keine Änderungen an Ihrer App erforderlich, um das Anzeigenprüftool mit einer Geste zu starten. Führen Sie einfach die Geste (doppeltes Wischen oder Schütteln) aus, die Sie in AdMob für das Testgerät konfiguriert haben. Weitere Informationen

Nachdem Sie in der AdMob-Benutzeroberfläche eine Touch-Geste festgelegt haben und 15 Minuten warten, bis sie übernommen wird, muss Ihre App eine Anzeigenanfrage an das Google Mobile Ads SDK senden, um die Touch-Geste-Einstellung zu ermitteln. Wenn die von Ihnen angegebene Geste nicht funktioniert, versuchen Sie, eine Anzeige zu laden, die App neu zu starten und die Geste noch einmal zu testen.

Programmatisch starten

Das Anzeigenprüftool kann auch programmatisch gestartet werden:

public void OnButtonClick() {
  MobileAds.OpenAdInspector(error => {
    // Error will be set 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 wurden.

Anzeigenblöcke aufrufen und Fehler beheben

Nach dem Start wird der Hauptbildschirm des Anzeigenprüftools angezeigt. Er enthält eine Liste aller Anzeigenblöckeauf der AdMob-Benutzeroberfläche, die Ihrer AdMob-App-ID mit Bidding- oder Vermittlungskonfigurationen zugeordnet sind:

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 Bidding noch nicht kennen, sollten Sie zuerst die Übersicht lesen.

Im SDK-Anfrageprotokoll sind die 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 bidding Auktion aufzurufen.

Die Ergebnisse 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 Schritten zur Fehlerbehebung.

  • 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 direkt an die Anzeigenquelle wenden, um Unterstützung zu erhalten.

  • Am Ende der Liste sehen Sie die Werbenetzwerke, die die Auktionbidding verloren haben.

Die Vermittlungsabfolge kann die Anzeigenquelle, die die Auktionbidding gewonnen hat, entsprechend ihrem eCPM-Wert platzieren.

Wenn eine Anzeigenquelle in der Vermittlungsabfolge aufgerufen wird, kann sie Anzeigen ausliefern. Weitere Informationen zur Funktionsweise von Bidding mit der Vermittlungsabfolge finden Sie unter Beispiel 2 und Beispiel 3 zu Bidding- und abfolgebasierten 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 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.

Android
iOS

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 AdMobnicht 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 derAdMob -Weboberfläche zugewiesen wurden.

Falls der Adapter nicht gefunden wird oder nicht initialisiert werden kann, finden Sie weitere Informationen unter Probleme mit dem Anzeigenprüftool beheben .

Android
iOS

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.

Informationen zur Verwendung des Anzeigenprüftools in Ihrer App

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 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:

Android
iOS

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 IhrerAdMob -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.