Este guia explica como integrar formatos de anúncios nativos personalizados com de medida.
Pré-requisitos
- SDK dos anúncios para dispositivos móveis do Google versão 18.1.1 ou mais recente.
- Leia Open Measurement com o SDK de anúncios para dispositivos móveis.
- Integrar anúncios nativos personalizados formatos.
- Configurar uma visibilidade fornecedor e atribuí-lo ao seu item de linha.
- Insira o nome do parceiro ao criar uma formato na IU do Ad Manager.
Integração
Se você planeja usar a medição aberta com formatos de anúncios nativos personalizados que não contiverem um recurso de vídeo, você será responsável por chamar a função APIs de medição. Open Measurement para anúncio nativo personalizado de tipo de display formatos compatíveis somente com o SDK dos anúncios para dispositivos móveis versão 18.1.1 e posteriores.
Se você estiver usando formatos de anúncios nativos 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.
Carregar um anúncio
O carregamento de um anúncio é o mesmo, quer você use ou não o Open Measurement. Aqui está
Um método que demonstra como solicitar um NativeCustomFormatAd:
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomFormatAd("YOUR-TEMPLATE-ID",
new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomFormatAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomFormatAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
Registre sua visualização e comece a medir
Para ativar o Open Measurement em um NativeCustomFormatAd, registre seu
visualização de anúncio com o objeto DisplayOpenMeasurement associado ao
NativeCustomFormatAd: O objeto DisplayOpenMeasurement fornece o
setView() para registrar a visualização do contêiner com o Open Measurement.
Você também precisa instruir explicitamente o SDK a começar a medir o anúncio. Para fazer isso,
chame o método start() no objeto DisplayOpenMeasurement do
NativeCustomFormatAd. 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:
public void registerOpenMeasurementAndShowAd(NativeCustomFormatAd ad) {
...
// Show ad
...
displayCustomFormatAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();
}
Você deve exibir o anúncio antes de registrar sua visualização. Exibindo seu anúncio está incluído nos anúncios nativos personalizados Formatos.
O layout customTemplateAdFrame é o contêiner do anúncio da
NativeCustomFormatAd e precisa conter todos os recursos dentro da caixa delimitadora de
a visualização.
Certificação 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 Processo de certificação do IAB.