Creative Preview e Delivery Inspector

Questa guida mostra come eseguire il debug della pubblicazione di annunci utilizzando l'anteprima in-app e lo strumento di controllo della pubblicazione.

L'anteprima in-app ti consente di visualizzare il rendering delle tue creatività all'interno della tua app mobile. Questa anteprima è particolarmente utile per i publisher che hanno creatività che interagiscono con l'app, hanno un comportamento univoco o si basano sull'app per parte del rendering (incluse creatività native e MRAID).

Lo strumento di ispezione della pubblicazione fornisce informazioni sugli annunci pubblicati. Se vengono pubblicati annunci imprevisti, utilizza Delivery Inspector per scoprire perché.

Prerequisiti

  • Versione 7.13.1 o successive di Google Mobile Ads SDK
  • Accesso a un account Google Ad Manager
  • Completa la sezione Inizia.

Preparare l'app

Il debug richiede l'interazione con il menu delle opzioni di debug dell'SDK. Il modo consigliato per aprire il menu è includere la funzione di seguito nella tua app e attivarla in base a un'azione dell'utente:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = DebugOptionsViewController(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];
}

Qualsiasi unità pubblicitaria valida del tuo account Ad Manager è sufficiente per aprire il menu delle opzioni di debug.

Ricevere una notifica quando il menu di debug si chiude

Quando apri il menu delle opzioni di debug in modo programmatico, puoi scegliere di implementare GADDebugOptionsViewControllerDelegate per ricevere una notifica quando il controller di visualizzazione viene chiuso. Per farlo, fai in modo che il tuo corso rispetti i seguenti requisiti:

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

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

Imposta il delegato su GADDebugOptionsViewController:

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];
}

Infine, implementa il delegato:

Swift

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

Objective-C 

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

Dopo aver aggiunto la funzionalità per aprire il menu delle opzioni di debug, esegui l'app e attiva la funzione precedente. Si apre il seguente menu:

Seleziona Creative Preview per collegare il tuo dispositivo. Si apre un browser che ti indirizza automaticamente a un browser per accedere ad Ad Manager. Dopo aver eseguito l'accesso, assegna un nome al dispositivo per registrarlo con il tuo account Ad Manager e fai clic su Verifica.

Il dispositivo è stato collegato correttamente. A questo punto, puoi vedere il dispositivo collegato nel front-end di Ad Manager. Puoi anche consentire ad altri di accedere ai tuoi dispositivi.

Anteprima in-app

Segui i passaggi per inviare una creatività al dispositivo collegato. Assicurati che la creatività push faccia parte di un elemento pubblicitario attivo che ha come target l'area annuncio in cui vuoi visualizzare la creatività.

Dopo aver inviato una creatività dal front-end, attiva di nuovo il menu delle opzioni di debug sul dispositivo e seleziona di nuovo Anteprima creatività. Questo passaggio consente all'SDK di controllare nuovamente Ad Manager per verificare che il collegamento del dispositivo sia andato a buon fine e per ottenere alcune informazioni su quale creatività hai inviato. Se il collegamento dei dispositivi è andato a buon fine in precedenza, il menu di debug si chiude immediatamente. Se non è andato a buon fine, ti viene chiesto di collegare di nuovo il tuo account.

Infine, carica un annuncio per lo spazio che vuoi visualizzare in anteprima per vedere la tua creatività.

Delivery Inspector

Segui i passaggi per iniziare a risolvere i problemi dell'app. Se li completi correttamente, la richiesta verrà visualizzata nel frontend di Ad Manager e potrai visualizzare ulteriori informazioni sull'annuncio pubblicato.