Tools für Creative-Vorschau und ‑Auslieferung

In diesem Leitfaden wird beschrieben, wie Sie die Anzeigenbereitstellung mithilfe der In-App-Vorschau und der Ad Manager-Auslieferungstools debuggen.

Mit der In-App-Vorschau können Sie sich Ihre eigenen Creatives ansehen, die in Ihrer mobilen App gerendert werden. Diese Vorschau ist besonders nützlich, wenn Sie Creatives haben, die mit der App interagieren, ein besonderes Verhalten aufweisen oder für das Rendering auf die App angewiesen sind (einschließlich nativer Creatives und MRAID).

Die Ad Manager-Auslieferungstools enthalten Informationen dazu, welche Anzeigen ausgeliefert wurden. Wenn unerwartete Anzeigen ausgeliefert werden, können Sie mit den Auslieferungstools herausfinden, warum.

Vorbereitung

• Version 10.2.0 oder höher des Google Mobile Ads SDK

• Zugriff auf ein Google Ad Manager-Konto
• Führen Sie die Schritte im Startleitfaden aus.

App vorbereiten

Für das Debugging ist eine Interaktion mit dem Menü für Debugging-Optionen des SDK erforderlich. Wir empfehlen, das Menü zu öffnen, indem Sie die folgende Funktion in Ihre App einfügen und sie basierend auf einer Nutzeraktion auslösen:

public class MainActivity extends AppCompatActivity {

  ...

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this);
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  public void openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID");
  }
}

class MainActivity : AppCompatActivity() {

  ...

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this)
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  fun openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
  }
}

Jeder gültige Anzeigenblock aus Ihrem Ad Manager-Konto reicht aus, um das Menü mit den Debugging-Optionen zu öffnen.

Eine weitere Möglichkeit, das Menü zu öffnen, besteht darin, das Creative mit zwei Fingern lange zu drücken. Das funktioniert jedoch nicht bei allen Anzeigenformaten, z. B. nicht bei nativen Anzeigen. Außerdem müssen Sie darauf achten, dass Sie beim Wischen nicht auf die Anzeige klicken. Der Aufruf der vorherigen Methode ist viel robuster.

Gerät verknüpfen

Nachdem Sie die Möglichkeit zum Öffnen des Menüs mit den Debug-Optionen hinzugefügt haben, führen Sie Ihre App aus und lösen Sie die Funktion aus. Das folgende Menü wird geöffnet:

Wählen Sie Creative Preview aus, um Ihr Gerät zu verknüpfen. Ein Browser wird geöffnet und Sie werden automatisch zu einer Seite weitergeleitet, auf der Sie sich in Ad Manager anmelden können. Geben Sie nach der Anmeldung einen Namen für Ihr Gerät ein, um es in Ihrem Ad Manager-Konto zu registrieren. Klicken Sie dann auf Bestätigen.

An dieser Stelle können Sie prüfen, ob Ihr Gerät in der Ad Manager-Benutzeroberfläche verknüpft wurde. Du kannst auch anderen den Zugriff auf deine Geräte erlauben.

In-App-Vorschau

Folgen Sie der Anleitung unter Creative an ein verknüpftes Gerät senden. Achten Sie darauf, dass das gesendete Creative Teil einer aktiven Werbebuchung ist, die auf die Anzeigenfläche ausgerichtet ist, auf der das Creative ausgeliefert werden soll.

Nachdem Sie ein Creative über die Benutzeroberfläche gesendet haben, rufen Sie das Menü „Optionen zur Fehlerbehebung“ auf Ihrem Gerät noch einmal auf und wählen Sie Creative-Vorschau aus. In diesem Schritt kann das SDK im Ad Manager prüfen, ob die Geräteverknüpfung erfolgreich war, und Informationen zum Creative abrufen, das Sie übertragen haben. Wenn die Geräteverknüpfung zuvor erfolgreich war, wird das Debug-Menü sofort geschlossen. Wenn die Verknüpfung nicht erfolgreich war, werden Sie aufgefordert, Ihr Konto noch einmal zu verknüpfen.

Laden Sie schließlich eine Anzeige für die Anzeigenfläche, für die Sie eine Vorschau sehen möchten, um Ihr Creative zu sehen.

Bereitstellungstools

Folgen Sie der Anleitung unter Auslieferung in Ad Manager prüfen, um Probleme mit der Anzeigenauslieferung zu beheben. Wenn Sie die Schritte erfolgreich ausgeführt haben, wird die Anfrage in der Ad Manager-Benutzeroberfläche angezeigt und Sie können weitere Informationen zur ausgelieferten Anzeige aufrufen.