Creative Preview e Inspetor de exibição

Este guia mostra como depurar a veiculação de anúncios usando a visualização no app e o Inspetor de exibição.

A visualização no aplicativo permite que você veja seus próprios criativos renderizados no seu app para dispositivos móveis. Essa visualização é útil principalmente para editores com criativos que interagem com o app, têm um comportamento único ou dependem do app para renderizar parte da renderização (incluindo criativos nativos e MRAID).

O Inspetor de exibição (link em inglês) fornece informações sobre quais anúncios foram exibidos. Quando anúncios inesperados forem exibidos, use o Inspetor de exibição para descobrir o motivo.

Pré-requisitos

• Versão 7.13.1 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
• Acesso a uma conta do Google Ad Manager
• Concluir Começar

Preparar seu app

A depuração exige interação com o menu de opções de depuração do SDK. A maneira recomendada de abrir o menu é incluir a função abaixo no app e acioná-la com base em uma ação do usuário:

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

Qualquer bloco de anúncios válido da sua conta do Ad Manager é suficiente para abrir o menu de opções de depuração.

Observação :outra maneira de abrir o menu é deslizar o dedo sobre o criativo. No entanto, isso não funciona para todos os formatos de anúncios, por exemplo, anúncios nativos, e é preciso ter cuidado para não clicar no anúncio ao tentar deslizar o dedo. Chamar o método acima é muito mais eficiente.

Receber uma notificação quando o menu de depuração fechar

Ao abrir o menu de opções de depuração de forma programática, você pode implementar GADDebugOptionsViewControllerDelegate para receber uma notificação quando o controlador de visualização for dispensado. Para fazer isso, faça com que a classe esteja em conformidade com o delegado:

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

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

Defina o delegado no 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];
}

Por fim, implemente o delegado:

Swift

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

Objective-C

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

Vincular seu dispositivo

Depois de adicionar o recurso para abrir o menu de opções de depuração, execute o app e acione a função acima. O menu a seguir é aberto:

Selecione Creative Preview para vincular o dispositivo. Um navegador se abre e direciona você automaticamente a outro para fazer login no Ad Manager. Depois de fazer login, dê um nome ao dispositivo para registrá-lo na conta do Ad Manager e clique em Verificar.

Observação: SFSafariViewController é aberto no iOS 9 e versões mais recentes, enquanto Safari é aberto no iOS 8 e versões anteriores.

Seu dispositivo foi vinculado. Nesse ponto, é possível ver seu dispositivo vinculado no front-end do Ad Manager. Você também pode permitir que outras pessoas acessem seus dispositivos.

Visualização no app

Siga as etapas para enviar um criativo para seu dispositivo vinculado. Confira se o criativo enviado faz parte de um item de linha ativo segmentado para o espaço de anúncio em que você quer visualizá-lo.

Depois de enviar o criativo pelo front-end, acione novamente o menu de opções de depuração no seu dispositivo e selecione Creative Preview. Essa etapa permite que o SDK verifique o Ad Manager novamente para conferir se a vinculação do dispositivo foi concluída e coletar algumas informações sobre qual criativo você enviou. Se a vinculação do dispositivo tiver sido bem-sucedida, o menu de depuração será fechado imediatamente. Se ela não for bem-sucedida, será solicitado que você vincule a conta novamente.

Por fim, carregue um anúncio no espaço que você quer visualizar para conferir seu criativo.

Inspetor de exibição

Siga as etapas em Iniciar solução de problemas no app para resolver problemas no seu app. Se você concluir as etapas, a solicitação será exibida no front-end do Ad Manager, e você poderá ver mais informações sobre o anúncio que foi veiculado.