Usar um correlacionador personalizado com o SDK dos anúncios para dispositivos móveis do Google

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 a prevenção da veiculação do mesmo criativo para duas solicitações de anúncio semelhantes. As solicitações de anúncios correlacionadas também são necessárias para recursos de bloqueio de estradas e exclusão competitiva no Ad Manager.

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

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

Swift

var correlator = "2510196024846425" // make randomly - should be 16 digits.
let request = AdManagerRequest()
let extras = Extras()
extras.additionalParameters = ["correlator": correlator];
request.register(extras)

Objective-C

NSString *correlator = @"2510196024846425" // make randomly - should be 16 digits.
DRPRequest *request = [[GAMRequest alloc] init];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{ @"correlator": correlator};
[request registerExtras:extras];

A vida útil do correlacionador é de 30 segundos. As solicitações feitas com mais de 30 segundos de diferença não serão consideradas correlacionadas pelo servidor.

Práticas recomendadas

O uso do correlacionador personalizado vai fornecer 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.

Você pode fazer isso várias vezes, mas quanto mais chamadas fizer, mais recursos vai consumir. É recomendável limitar a 3 a 5 solicitações sequenciais. Você pode fazer outras chamadas à medida que o usuário rola a página para baixo.

Como o correlacionador 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 correlacionador 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 correlacionador.

Para evitar que os anúncios retornados sejam veiculados em chamadas subsequentes após a expiração do correlacionador, 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 típico do seu app. Os limites de frequência podem ser removidos 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.