Priorizar cliques, visualizações ou conversões específicas

Configure a API para priorizar origens ou acionadores específicos.

Priorizar cliques ou visualizações específicos para relatórios agregáveis ou no nível do evento

Usando as prioridades do lado da origem, é possível mudar o comportamento padrão da API Attribution Reporting. Por padrão, o modelo de atribuição é o de último toque, ou seja, uma conversão é atribuída ao evento de origem correspondente mais recente. Para relatórios de eventos e agregáveis, você pode ajustar esse comportamento.

Para mudar a prioridade padrão, adicione a chave priority ao cabeçalho de registro de origem.

Defina uma prioridade mais alta para as fontes que você quer priorizar. Valores maiores indicam uma prioridade maior. Por exemplo, um evento de origem com priority 2 tem precedência sobre uma origem com priority 1.

Somente o relatório que corresponde ao evento de origem com a maior prioridade é enviado.

Exemplo de código

Mude a atribuição para selecionar origens menos recentes (primeiro clique):

const currentTimestamp = Date.now();
const priority = -currentTimestamp;

res.set(
  "Attribution-Reporting-Register-Source",
  JSON.stringify({
    // … all usual fields for that header
    priority: `${priority}`
  })
);

Priorizar conversões específicas nos relatórios do evento

Ao contrário das prioridades do lado da fonte, a configuração das prioridades do lado do acionador está disponível apenas para relatórios de eventos.

Suponha que um usuário clique em um anúncio e faça uma conversão quatro vezes: ele acessa a página inicial do site do anunciante, depois uma página de produto, se inscreve na newsletter e, por fim, faz uma compra.

No entanto, devido ao limite de três relatórios para cliques, todos os relatórios subsequentes após a inscrição (terceira conversão) são descartados por padrão, incluindo o relatório de compra.

Em vez disso, configure a API para receber relatórios sobre as conversões que você considera mais importantes, por exemplo, o relatório de compras.

Para fazer isso, adicione a chave priority ao cabeçalho de registro do acionador e defina uma prioridade mais alta para as conversões que você quer priorizar.

Quando uma atribuição é acionada para um determinado evento de origem, se o número máximo de atribuições (três para cliques, uma para visualizações) tiver sido atingido para essa origem, o navegador vai:

  • Compare a prioridade do novo relatório com as prioridades dos relatórios programados existentes para a mesma origem.

  • Exclua o relatório com a prioridade mais baixa para programar o novo. Se o novo relatório tiver a prioridade mais baixa, ele será ignorado e você não vai recebê-lo.

Se nenhuma prioridade for definida, o navegador vai voltar ao comportamento padrão: qualquer conversão que ocorra após a terceira conversão de cliques ou a primeira conversão de visualizações será descartada.

Analise o exemplo de código: priorizar conversões do tipo finalização de compra

Próximas etapas

Para informações sobre como definir origens e acionadores, consulte: