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 Open Measurement.

Pré-requisitos

Antes de continuar, faça o seguinte:

• Leia a página Open Measurement com o SDK dos Anúncios para Dispositivos Móveis.
• Integre formatos de anúncios nativos 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 Open Measurement com formatos de anúncios nativos personalizados que não contêm um recurso de vídeo, será responsável por chamar as APIs da Open Measurement.

Se você estiver usando formatos de anúncios nativos personalizados com um recurso de vídeo, não precisará seguir este guia. O SDK dos Anúncios para Dispositivos Móveis rastreia a visibilidade do recurso de vídeo em seu nome.

**Ponto principal**: para que os resultados da medição de anúncios nativos personalizados do tipo display sejam certificados pelo IAB, você precisa ser certificado como provedor de medição pelo IAB Tech Lab.

Registre sua visualização e comece a medir

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

Você também precisa informar explicitamente ao SDK para começar a medir seu anúncio. Para fazer 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()
  }
}
OpenMeasurementSnippets.kt

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();
  }
}
OpenMeasurementSnippets.java

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

O nativeAdViewContainer layout é o contêiner de anúncios para o 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 do IAB seja acionado.

Certifique-se com o IAB

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