Creative Preview e Delivery Inspector

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

L'anteprima in-app ti consente di visualizzare le tue creatività visualizzate all'interno dell'app mobile. Questa anteprima è particolarmente utile per i publisher con creatività che interagiscono con l'app, che hanno un comportamento univoco o che si affidano all'app per parte del rendering (tra cui creatività native e MRAID).

Lo strumento Delivery Inspector fornisce informazioni su quali annunci sono stati pubblicati. Quando vengono pubblicati annunci imprevisti, utilizza Delivery Inspector per scoprire perché.

Prerequisiti

  • Versione 7.13.1 o successive dell'SDK Google Mobile Ads
  • Accesso a un account Google Ad Manager
  • Completa la procedura 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 riportata di seguito nell'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 = 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];
}

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

Ricevi una notifica quando si chiude il menu di debug

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 ignorato. Per farlo, rendi il corso conforme al delegato:

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 riportata sopra. Si apre il seguente menu:

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

Hai collegato il tuo dispositivo. A questo punto, puoi vedere il dispositivo collegato nel frontend di Ad Manager. Puoi anche consentire ad altri di accedere ai tuoi dispositivi.

Anteprima in-app

Segui la procedura per inviare una creatività al dispositivo collegato. Assicurati che la creatività trasferita faccia parte di un elemento pubblicitario attivo indirizzato all'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 dei dispositivi sia riuscito e per ottenere alcune informazioni sulla creatività inviata. Se in precedenza il collegamento del dispositivo è andato a buon fine, il menu di debug si chiude immediatamente. Se l'operazione non è andata a buon fine, ti verrà chiesto di collegare nuovamente l'account.

Infine, carica un annuncio per l'area in cui vuoi visualizzare l'anteprima per vedere la creatività.

Delivery Inspector

Segui i passaggi per iniziare la risoluzione dei problemi con l'app per risolvere i problemi della tua app. Se completi correttamente i passaggi, la richiesta verrà visualizzata nel frontend di Ad Manager e potrai visualizzare ulteriori informazioni sull'annuncio pubblicato.