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 próprios 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 do app 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.
Vincular seu dispositivo
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.