Este guia mostra como depurar a veiculação de anúncios usando a visualização no aplicativo e as ferramentas de exibição do Ad Manager.
A visualização no app permite inspecionar seus próprios criativos renderizados no seu app para dispositivos móveis. Essa visualização é especialmente útil se você tem criativos que interagem com o app, têm um comportamento único ou dependem dele para alguma 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
- Versão 10.2.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
- Acesso a uma conta do Google Ad Manager.
- Conclua o curso 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 seu app e acioná-la 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 é pressionar e manter pressionado com dois dedos o criativo, mas isso não funciona para todos os formatos de anúncio, como os anúncios nativos. Além disso, tenha 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 acione a função acima. O seguinte menu é aberto:
Selecione Creative Preview para vincular seu dispositivo. Um navegador será aberto e levará você automaticamente a uma tela para fazer login no Ad Manager. Depois de fazer login, nomeie o dispositivo para registrá-lo com sua conta do Ad Manager. Em seguida, clique em Verificar.
Nesse ponto, é possível verificar se o dispositivo está 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 ao seu dispositivo vinculado. Confira se o criativo enviado faz parte de um item de linha ativo segmentado para o espaço do anúncio em que você quer o criativo.
Depois de enviar o criativo a partir da interface, acione o menu de opções de depuração no seu dispositivo novamente e selecione Creative Preview mais uma vez. Essa etapa permite que o SDK verifique o Ad Manager para conferir se a vinculação do dispositivo foi concluída e coletar algumas informações sobre o criativo que você enviou. Se a vinculação de dispositivos tiver sido bem-sucedida, o menu de depuração será fechado imediatamente. Se não der certo, será solicitado que você vincule sua conta novamente.
Por fim, carregue um anúncio para o espaço que você quer visualizar para ver seu 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 essas etapas forem concluídas, a solicitação vai aparecer na interface do Ad Manager e você poderá conferir mais informações sobre o anúncio que foi veiculado.
