Visualização criativa e ferramentas de exibição

Este guia mostra como depurar a veiculação de anúncios usando a visualização no app e as ferramentas de veiculação do Ad Manager.

A visualização no app permite inspecionar os criativos renderizados no app para dispositivos móveis. Essa visualização é especialmente útil se você tiver criativos que interagem com o app, têm um comportamento único ou dependem dele para renderização (incluindo criativos nativos e MRAID).

As ferramentas de exibição do Ad Manager fornecem informações sobre quais anúncios foram exibidos. Portanto, quando anúncios inesperados forem exibidos, use as ferramentas de exibição para descobrir o motivo.

Pré-requisitos

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

Preparar seu app

A depuração requer 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 acionar com base em uma ação do usuário:

Java

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.
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  public void openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID");
  }
}

Kotlin

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.
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  fun openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
  }
}

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

Outra maneira de abrir o menu é fazer um toque longo com dois dedos no criativo, mas isso não funciona para todos os formatos de anúncio, como anúncios nativos, e você precisa ter cuidado para não clicar no anúncio ao tentar deslizar. Chamar o método acima é muito mais robusto.

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

Selecione Visualização de criativo para vincular seu dispositivo. Um navegador é aberto e você é direcionado automaticamente para fazer login no Ad Manager. Depois de fazer login, nomeie o dispositivo para registrá-lo na sua conta do Ad Manager. Em seguida, clique em Verificar.

Nesse ponto, você pode verificar se o dispositivo foi vinculado na interface 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 o dispositivo vinculado. Verifique se o criativo enviado faz parte de um item de linha ativo segmentado para o espaço de anúncio em que você quer o criativo.

Depois de enviar um criativo pela interface, acione o menu de opções de depuração no dispositivo novamente e selecione Visualização de criativos mais uma vez. Essa etapa permite que o SDK verifique o Ad Manager para verificar se a vinculação do dispositivo foi bem-sucedida e para receber algumas informações sobre o criativo que você enviou. Se a vinculação do dispositivo foi concluída anteriormente, o menu de depuração será fechado imediatamente. Se não for sucedido, você vai precisar vincular sua conta novamente.

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

Ferramentas de exibição

Siga as etapas em Inspecionar a exibição no Ad Manager para resolver problemas de exibição de anúncios. Se você concluiu as etapas, a solicitação vai aparecer na interface do Ad Manager, e você poderá conferir mais informações sobre o anúncio veiculado.