Creative-Vorschau und Auslieferungsprüfung

In diesem Leitfaden erfahren Sie, wie Sie Fehler bei der Anzeigenbereitstellung mithilfe der In-App-Vorschau und der Auslieferungsprüfung beheben.

In der In-App-Vorschau sehen Sie Ihre eigenen Creatives, die in Ihrer mobilen App gerendert werden. Diese Vorschau eignet sich besonders für Publisher, deren Creatives mit der App interagieren, eine besondere Funktionsweise haben oder deren Rendering von der App abhängig ist (einschließlich nativer Creatives und MRAID).

Mit der Auslieferungsprüfung erfahren Sie, welche Anzeigen ausgeliefert wurden. Wenn unerwartete Anzeigen ausgeliefert werden, können Sie mit der Auslieferungsprüfung den Grund dafür ermitteln.

Voraussetzungen

• Google Mobile Ads SDK: Version 7.13.1 oder höher
• Zugriff auf ein Google Ad Manager-Konto
• Schließen Sie den Startleitfaden ab.

App vorbereiten

Für die Fehlerbehebung ist eine Interaktion mit dem Menü mit Fehlerbehebungsoptionen des SDK erforderlich. Die empfohlene Methode zum Öffnen des Menüs besteht darin, die unten aufgeführte Funktion in Ihre App aufzunehmen und sie je nach Nutzeraktion auszulösen:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

Das Menü mit Fehlerbehebungsoptionen kann von jedem gültigen Anzeigenblock in Ihrem Ad Manager-Konto geöffnet werden.

Hinweis :Eine weitere Möglichkeit zum Öffnen des Menüs besteht in einer Wischgeste auf dem Creative. Das funktioniert jedoch nicht bei allen Anzeigenformaten, z. B. bei nativen Anzeigen. Sie dürfen außerdem nicht auf die Anzeige klicken, wenn Sie wischen möchten. Ein Aufruf der Methode oben ist wesentlich robuster.

Benachrichtigung erhalten, wenn das Menü zur Fehlerbehebung geschlossen wird

Wenn Sie das Menü mit Fehlerbehebungsoptionen programmatisch öffnen, können Sie GADDebugOptionsViewControllerDelegate implementieren, damit Sie benachrichtigt werden, wenn der Ansichts-Controller geschlossen wird. Dazu muss Ihre Klasse dem Delegaten entsprechen:

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

@import GoogleMobileAds;
 
@interface ViewController : UIViewController <GADDebugOptionsViewControllerDelegate> {
}
 
@end

Legen Sie den Bevollmächtigten auf Ihrem GADDebugOptionsViewController fest:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  debugOptionsViewController.delegate = self
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  debugOptionsViewController.delegate = self;
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

Implementieren Sie schließlich den Delegaten:

Swift

func debugOptionsViewControllerDidDismiss(controller: GADDebugOptionsViewController) {
  print("Debug options view controller dismissed.")
}

Objective-C

- (void)debugOptionsViewControllerDidDismiss:(GADDebugOptionsViewController *)controller {
  NSLog(@"Debug options view controller dismissed.");
}

Gerät verknüpfen

Nachdem Sie die Funktion zum Öffnen des Menüs mit Fehlerbehebungsoptionen hinzugefügt haben, führen Sie die Anwendung aus und lösen die Funktion oben aus. Das folgende Menü wird geöffnet:

Wählen Sie Creative Preview (Creative-Vorschau) aus, um Ihr Gerät zu verknüpfen. Daraufhin wird ein Browser geöffnet, in dem Sie sich in Ad Manager anmelden können. Geben Sie nach erfolgreicher Anmeldung Ihrem Gerät einen Namen, um es mit Ihrem Ad Manager-Konto zu registrieren, und klicken Sie auf Bestätigen.

Hinweis: SFSafariViewController wird unter iOS 9 und höher geöffnet, Safari unter iOS 8 und niedriger.

Dein Gerät ist jetzt verknüpft. Nun wird im Ad Manager-Front-End Ihr Gerät als verknüpft angezeigt. Sie können auch anderen den Zugriff auf Ihre Geräte erlauben.

In-App-Vorschau

Führen Sie die Schritte aus, um ein Creative an ein verknüpftes Gerät zu senden. Das gesendete Creative muss Teil einer aktiven Werbebuchung sein, die auf die Anzeigenfläche ausgerichtet ist, auf der Sie das Creative sehen möchten.

Nachdem Sie ein Creative über das Front-End gesendet haben, lösen Sie das Menü mit Fehlerbehebungsoptionen auf Ihrem Gerät noch einmal aus und wählen Sie Creative Preview aus. Auf diese Weise kann das SDK noch einmal in Ad Manager prüfen, ob die Geräteverknüpfung erfolgreich war und Informationen dazu erhalten, welches Creative gesendet wurde. Wenn die Geräteverknüpfung zuvor erfolgreich war, wird das Menü zur Fehlerbehebung sofort geschlossen. Wenn sie nicht erfolgreich war, werden Sie aufgefordert, Ihr Konto noch einmal zu verknüpfen.

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

Auslieferungsprüfung

Folgen Sie der Anleitung unter Mit der Fehlerbehebung in Apps beginnen, um Fehler in Ihrer App zu beheben. Wenn Sie die Schritte erfolgreich ausführen, wird die Anfrage im Ad Manager-Front-End angezeigt und Sie können weitere Informationen zur ausgelieferten Anzeige aufrufen.