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 12.9.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.

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

Swift

private func loadInterstitial() async {
  do {
    let interstitial = try await InterstitialAd.load(
      with: "adUnitID", request: Request())
    interstitial.placementID = adPlacementID
    print("Placement ID set to: \(interstitial.placementID)")
  } catch {
    print("Failed to load interstitial ad with error: \(error.localizedDescription)")
  }
}
AdPlacementsSnippets.swift

Objective-C

- (void)loadInterstitial {
  GADRequest *request = [GADRequest request];
  request.placementID = adPlacementID;
  [GADInterstitialAd loadWithAdUnitID:"adUnitID"
                              request:request
                    completionHandler:^(GADInterstitialAd *ad, NSError *error) {
                      if (!error) {
                        NSLog(@"Placement ID: %lld", ad.placementID);
                        return;
                      }
                    }];
}
AdPlacementsSnippets.m

Substitua os seguintes valores:

  • adUnitID pelo ID do bloco de anúncios.
  • adPlacementID 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. No exemplo a seguir, um ID de posição é definido para um anúncio de banner no momento da exibição:

Swift

private func showBanner(_ bannerView: BannerView) {
  bannerView.placementID = adPlacementID
  view.addSubview(bannerView)
}
AdPlacementsSnippets.swift

Objective-C

- (void)showBannerView:(GADBannerView *)bannerView {
  bannerView.placementID = adPlacementID;
  [self.view addSubview:bannerView];
}
AdPlacementsSnippets.m

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:

Swift

private func showInterstitial(_ ad: InterstitialAd) {
  ad.placementID = adPlacementID
  ad.present(from: self)
}
AdPlacementsSnippets.swift

Objective-C

- (void)showAd:(GADInterstitialAd *)ad {
  ad.placementID = adPlacementID;
  [ad presentFromRootViewController:self];
}
AdPlacementsSnippets.m

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.

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

Swift

private func configureView(_ nativeAdView: NativeAdView, withAd nativeAd: NativeAd) {
  nativeAd.placementID = adPlacementID
  nativeAdView.nativeAd = nativeAd
}
AdPlacementsSnippets.swift

Objective-C

- (void)configureView:(GADNativeAdView *)nativeAdView withNativeAd:(GADNativeAd *)nativeAd {
  nativeAd.placementID = adPlacementID;
  nativeAdView.nativeAd = nativeAd;
}
AdPlacementsSnippets.m

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.