Formatos de anúncios nativos personalizados de tipo de display e o Open Measurement

Este guia explica como integrar formatos de anúncios nativos personalizados com a medição aberta.

Pré-requisitos

Antes de continuar, faça o seguinte:

• Leia Open Measurement com o SDK de anúncios para dispositivos móveis.
• Integre formatos de anúncio nativo personalizados.
• Configure um provedor de visibilidade e atribua-o ao seu item de linha.
• Insira o nome do parceiro ao criar um formato personalizado na interface do Ad Manager.

Integração

Se você planeja usar a medição aberta com formatos de anúncios nativos personalizados que não contêm um recurso de vídeo, será responsável por chamar as APIs de medição aberta.

Se você estiver usando formatos de anúncio nativo personalizados com um recurso de vídeo, não será necessário seguir este guia. O SDK dos anúncios para dispositivos móveis rastreia a visibilidade do recurso de vídeo em seu nome.

Importante: para que os resultados da medição de anúncios nativos personalizados do tipo display sejam certificados pelo IAB, você precisa ter uma certificação como provedor de medição pelo IAB Tech Lab.

Registre sua visualização e comece a medir

Para ativar a medição aberta em um anúncio nativo personalizado, primeiro mostre o anúncio e depois registre sua visualização de anúncio personalizada com o objeto DisplayOpenMeasurement associado ao anúncio nativo personalizado. O objeto DisplayOpenMeasurement fornece o método setView() para registrar sua visualização de contêiner com a medição aberta.

Você também precisa informar explicitamente ao SDK para começar a medir seu anúncio. Para isso, chame o método start() no objeto DisplayOpenMeasurement do seu anúncio nativo personalizado. O método start() precisa ser chamado na linha de execução principal, e as chamadas subsequentes não têm efeito.

Veja o resultado:

Kotlin

@MainThread
private fun displayCustomNativeAd(
  customNativeAd: CustomNativeAd,
  nativeAdViewContainer: FrameLayout,
) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  val displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement()
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer)
    displayOpenMeasurement.start()
  }
}

Java

@MainThread
private void displayCustomNativeAd(
    CustomNativeAd customNativeAd, FrameLayout nativeAdViewContainer) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  DisplayOpenMeasurement displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer);
    displayOpenMeasurement.start();
  }
}

Mostre o anúncio antes de registrar a visualização. A exibição do seu anúncio é abordada em Formatos de anúncios nativos personalizados.

O layout nativeAdViewContainer é o contêiner do anúncio nativo personalizado e precisa conter todos os recursos dentro da caixa delimitadora da visualização.

Importante: chame destroy() no anúncio nativo personalizado quando terminar de usar o anúncio, por exemplo, depois de remover a referência do objeto ou destruir a atividade. Isso garante que o evento sessionFinish da IAB seja acionado.

Certificar com o IAB

Depois que você lançar o app, vai começar a receber dados de medição. No entanto, eles não serão certificados até que você conclua o processo de certificação da IAB.