Este guia explica como integrar formatos de anúncios nativos personalizados com medição aberta.
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.
- Integre formatos de anúncios nativos personalizados.
- Configure um provedor de visibilidade e o atribua ao seu item de linha.
- Insira o nome do seu parceiro ao criar um formato personalizado na IU do Ad Manager.
Integração
Se você planeja usar o Open Measurement com formatos de anúncios nativos personalizados que não contêm um recurso de vídeo, você será responsável por chamar as APIs Open Measurement. A medição aberta para formatos de anúncios nativos personalizados de tipo de display só é compatível com o SDK dos anúncios para dispositivos móveis versão 18.1.1 e versões mais recentes.
Se você estiver usando formatos de anúncios nativos personalizados com um recurso de vídeo, não precisará seguir este guia. O SDK de anúncios para dispositivos móveis rastreia a visibilidade do recurso de vídeo em seu nome.
Agora, vamos ver como usar a medição aberta com NativeCustomTemplateAd
. Em geral, é necessário alertar o SDK dos anúncios para dispositivos móveis quando você quer iniciar a medição de visibilidade e registrar a visualização personalizada do anúncio.
Carregar um anúncio
O processo para carregar um anúncio é o mesmo, quer você use o Open Measurement. Confira
um método que demonstra como solicitar um NativeCustomTemplateAd
:
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomTemplateAd("YOUR-TEMPLATE-ID",
new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
@Override
public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomTemplateAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomTemplateAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
Registre sua visualização e comece a medir
Para ativar o Open Measurement em uma NativeCustomTemplateAd
, registre a visualização de anúncio
personalizada com o objeto DisplayOpenMeasurement
associado ao
NativeCustomTemplateAd
. O objeto DisplayOpenMeasurement
fornece o
método setView()
para registrar a visualização de contêiner com medição aberta.
Também é necessário informar explicitamente ao SDK para começar a medir seu anúncio. Para fazer isso,
chame o método start()
no objeto DisplayOpenMeasurement
da
NativeCustomTemplateAd
. O método start()
precisa ser chamado na linha de execução
principal. As chamadas subsequentes não terão efeito.
Veja o resultado:
public void registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {
...
// Show ad
...
displayCustomTemplateAd(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 seu 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 customTemplateAdFrame
é o contêiner de anúncios da
NativeCustomTemplateAd
e precisa conter todos os recursos dentro da caixa delimitadora da
visualização.
Certificar com o IAB
Depois de lançar o app, você vai começar a receber dados de medição. No entanto, eles não serão certificados até que o processo de certificação do IAB seja concluído.