Configurar o URL de transparência de anúncios

Com o URL de transparência de anúncios, você pode personalizar o ícone AdChoices que aparece em determinados anúncios. Por padrão, esse ícone aparece para seus usuários em uma experiência de transparência e controle de anúncios (AT&C) renderizada pelo Google que inclui informações, como o anunciante e o próprio anúncio.

Para isso, faça uma solicitação de anúncio ao SDK dos anúncios para dispositivos móveis do Google e receba uma resposta com o URL de transparência do anúncio. Depois de receber o URL no app, você pode integrar um ícone personalizado que esteja de acordo com o design dos seus anúncios e apresentar sua própria experiência de AT&C aos usuários.

Nesta página, explicamos como solicitar, analisar e validar o URL de transparência do anúncio.

Pré-requisitos

Antes de continuar, faça o seguinte:

  • Configure anúncios nativos no seu app. Para mais detalhes, consulte Anúncios nativos.
  • Solicite acesso à lista de permissões para esse recurso. Para solicitar acesso, entre em contato com seu gerente de contas.
    • Se você não tiver acesso, suas respostas não vão retornar o URL de transparência do anúncio, e o ícone padrão será renderizado conforme o esperado.

Solicitar o URL

Para que o GMA Next-Gen SDK retorne o URL de transparência do anúncio, adicione um parâmetro de solicitação adicional às suas solicitações de anúncios nativos. Esse parâmetro indica que o app está pronto e preparado para processar um ícone personalizado.

Na solicitação, adicione a chave "ad_transparency_url_requested" com o valor "1" ao pacote de extras de rede. Para detalhes sobre extras de rede, consulte setGoogleExtrasBundle .

O exemplo a seguir define essa chave e esse valor para solicitar o URL de transparência do anúncio:

Java 

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin 

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

Substitua AD_UNIT_ID pelo ID do seu bloco de anúncios. Por exemplo, ca-app-pub-3940256099942544/2247696110 para anúncios nativos.

Analisar o URL

Depois de solicitar o URL, você recebe uma resposta de anúncio com o URL de transparência do anúncio no objeto de informações da resposta. Para detalhes sobre o objeto de informações da resposta, consulte Informações da resposta.

É possível acessar o URL de transparência de anúncios na chave "ad_transparency_url" dos extras de resposta. O exemplo a seguir recebe o URL de transparência de anúncios no objeto de informações de resposta:

Java 

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin 

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

Validar o URL

Para testar e validar o URL de transparência do anúncio, verifique se o ícone padrão fornecido pelo Google não aparece no seu anúncio nativo, mas sim o ícone personalizado. Clique no ícone para conferir a experiência de AT&C.

Além disso, verifique se o URL de transparência do anúncio aparece nos extras da resposta no objeto de informações da resposta. Se o URL de transparência do anúncio não aparecer, o ícone padrão do Google será renderizado no lugar do seu ícone personalizado. Confira a seguir um exemplo de URL de transparência de anúncios:

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID