Como usar um correlator personalizado com o SDK de anúncios para dispositivos móveis

Alguns apps exigem que duas solicitações de anúncio sejam correlacionadas.

O SDK dos anúncios para dispositivos móveis do Google não permite correlacionar duas solicitações, o que dificulta evitar que o mesmo criativo seja veiculado em duas solicitações de anúncio semelhantes. As solicitações de anúncios correlacionadas também são necessárias para os recursos de bloqueio de via e exclusão competitiva no Ad Manager.

Um valor de correlator é um número inteiro aleatório sem sinal, com 16 caracteres de comprimento, que é representado como uma string. Por padrão, o SDK do GMA gera um novo correlator com cada solicitação de anúncio, o que significa que nenhuma solicitação é correlacionada.

Para correlacionar duas solicitações, substitua manualmente o correlacionador gerado pelo SDK do GMA e aplique o mesmo correlacionador a várias solicitações de anúncio. Para usar esse recurso, gere seu próprio correlator aleatório. Confira exemplos de como transmitir seu próprio correlator:

Java

Bundle extras = new Bundle();
String correlator = "2510196024846425"; // make randomly - should be 16 digits.
extras.putString("correlator", correlator);
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

Kotlin

val extras = Bundle()
val correlator = "2510196024846425" // make randomly - should be 16 digits.
extras.putString("correlator", correlator)
val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

A vida útil do correlator é de 30 segundos. Solicitações feitas com mais de 30 segundos de intervalo não serão consideradas correlacionadas pelo servidor.

Práticas recomendadas

O uso do correlator personalizado dá ao Ad Manager o contexto necessário para evitar a seleção do mesmo criativo, mas as solicitações de anúncio precisam ser feitas sequencialmente: faça uma solicitação de anúncio, receba a resposta e faça a próxima solicitação.

É possível fazer isso várias vezes, mas quanto mais chamadas você fizer, mais recursos serão consumidos. É melhor limitar a 3 a 5 solicitações sequenciais. É possível fazer outras chamadas à medida que o usuário rola a página para baixo.

Como o correlator expira após 30 segundos, não é necessário gerar um novo valor para a mesma visualização de página longa. Gere um novo correlator no início de cada nova visualização de página de longa duração. Se você não precisar mais desse comportamento, pare de transmitir seu próprio correlator.

Para evitar que os anúncios retornados sejam veiculados em chamadas subsequentes após o vencimento do correlator, considere adicionar um limite de frequência de um anúncio a cada 5 a 10 minutos. O horário selecionado precisa coincidir com o uso normal do app. Os limites de frequência podem ser excluídos se você não renderizar os anúncios. Portanto, se você fizer uma solicitação de anúncio, mas não renderizar o anúncio e fizer outras chamadas, poderá receber o mesmo anúncio.