Segmentar dados de anúncios com posições

Selecionar plataforma: Android New-selected Android iOS

Para segmentar os dados dos relatórios de performance dos anúncios, use o recurso de posições de anúncios. As posições permitem segmentar dados de impressão em um relatório sem precisar de outros blocos de anúncios. Para usar o recurso de posições, você precisa de um ID de posição. Para mais detalhes sobre posições, consulte Sobre as posições.

Este guia explica como definir um ID de posição em GMA Next-Gen SDK e acessar um relatório de performance dos anúncios.

Pré-requisitos

Antes de continuar, faça o seguinte:

  • Conclua a configuração GMA Next-Gen SDK.
  • Tenha a versão GMA Next-Gen SDK ou mais recente.
  • Acesse o recurso de ID de posição. Para solicitar acesso, entre em contato com seu gerente de contas.
  • Crie um ID de posição para seu app.

Definir um ID de posição

Para segmentar os dados de performance do seu anúncio, defina um ID de posição de uma das seguintes maneiras:

  • Ao carregar o anúncio.
  • Antes de mostrar o anúncio.

Você pode atualizar o ID de posição conforme necessário. Quando GMA Next-Gen SDK registra uma impressão de anúncio, ele usa o ID de posição mais recente.

Definir um ID de posição no tempo de carregamento

Esta seção aborda a definição de um ID de posição no tempo de carregamento. Esse fluxo de trabalho se aplica a todos os formatos de anúncio.

No exemplo a seguir, um ID de posição é definido para um anúncio intersticial no momento do carregamento:

Kotlin 

private fun loadInterstitial() {
  val adRequest = AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    adRequest,
    object : AdLoadCallback<InterstitialAd> {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

Java 

private void loadInterstitial() {
  AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      adRequest,
      new AdLoadCallback<>() {
        @Override
        public void onAdLoaded(InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

Substitua os seguintes valores:

  • AD_UNIT_ID pelo ID do bloco de anúncios.
  • PLACEMENT_ID pelo ID de posição.

Definir o ID de posição no momento da veiculação

Nesta seção, abordamos a definição de um ID de posição no momento da veiculação para todos os formatos de anúncio. Selecione os formatos de anúncio preferidos nas seguintes seções:

Para anúncios de banner, defina o ID de posição antes de colocar a visualização do anúncio na hierarquia de visualização. No exemplo a seguir, um ID de posição é definido para um anúncio de banner no momento da exibição:

Kotlin 

private fun showBannerView(ad: BannerAd, parentView: ViewGroup, activity: Activity) {
  ad.placementId = PLACEMENT_ID
  parentView.addView(ad.getView(activity))
}

Java 

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}

Anúncios de tela cheia

Para formatos de anúncio de tela cheia, você define o ID de posição antes de mostrar um anúncio. Esse fluxo de trabalho se aplica aos seguintes formatos:

No exemplo a seguir, o ID de posição é definido para um anúncio intersticial no momento da exibição:

Kotlin 

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}

Java 

private void showAd(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}

Anúncios nativos

Para anúncios nativos, defina o ID de posição depois de carregar um anúncio nativo e antes de registrar o anúncio na visualização de anúncio.

No exemplo a seguir, um ID de posição é definido para um anúncio nativo no momento da exibição:

Kotlin 

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd, mediaView: MediaView) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.registerNativeAd(nativeAd, mediaView)
}

Java 

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd, MediaView mediaView) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.registerNativeAd(nativeAd, mediaView);
}

Acessar o relatório de posições

Depois de definir o ID de posição, você vai encontrar um relatório da dimensão desse ID na interface da AdMob. Para acessar o relatório, siga as instruções em Visualizar suas posições.