Segmentar dados de anúncios com posições

Selecione a plataforma: Android (Beta) Novo 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, consulte Sobre posições.

Neste guia, explicamos como definir um ID de posição no Google Mobile Ads SDK e acessar um relatório de performance dos anúncios.

Pré-requisitos

Antes de continuar, faça o seguinte:

  • Siga as etapas em Configurar o Google Mobile Ads SDK.
  • Use a versão 24.5.0 ou mais recente do Google Mobile Ads SDK.
  • 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 o Google Mobile Ads SDK registra uma impressão de anúncio, ele usa o ID de posição mais recente.

Definir um ID de posição no momento do carregamento

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

O exemplo a seguir define um ID de posição para um anúncio intersticial no momento do carregamento:

Kotlin 

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

Substitua os seguintes valores:

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

Definir o ID da 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. O exemplo a seguir define um ID de posição para um anúncio de banner no momento da veiculação:

Kotlin 

private fun showBannerView(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

AdPlacementsSnippets.kt

Java 

public void showBannerView(AdView adView, ViewGroup parentView) {
  adView.setPlacementId(PLACEMENT_ID);
  parentView.addView(adView);
}

AdPlacementsSnippets.java

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:

O exemplo a seguir define o ID de posição para um anúncio intersticial no momento da veiculação:

Kotlin 

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

Anúncios nativos

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

O exemplo a seguir define um ID de posição para um anúncio nativo no momento da veiculação:

Kotlin 

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

AdPlacementsSnippets.kt

Java 

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

AdPlacementsSnippets.java

Visualizar relatório de canal

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.