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

Configure a API para priorizar acionadores ou fontes específicas.

Priorizar cliques ou visualizações específicas para relatórios agregáveis ou de evento

Com as prioridades da fonte, é possível mudar o comportamento padrão da API Attribution Reporting. Por padrão, o modelo de atribuição é de último toque, o que significa que uma conversão é atribuída ao evento de origem correspondente mais recente. Para relatórios agregáveis e de eventos, é possível ajustar esse comportamento.

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

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

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

Exemplo de código

Mude a atribuição para selecionar fontes 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 para relatórios de eventos

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

Suponha que um usuário clique em um anúncio e converta quatro vezes: ele acessa a página inicial do site do anunciante, visita a página de um produto, se inscreve na newsletter e finalmente faz uma compra.

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

Em vez disso, é possível configurar a API para receber relatórios sobre as conversões que você considera mais importantes (por exemplo, o relatório de compras).

Para 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 e uma para visualizações) tiver sido atingido para essa origem, o navegador:

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

  • Exclua o relatório com a menor prioridade para programar o novo relatório. Se o novo relatório tiver a menor prioridade, ele será ignorado, e você não o receberá.

Se nenhuma prioridade for definida, o navegador 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.

Confira o código de exemplo: priorizar conversões do tipo "comprar"

Próximas etapas

Para informações sobre a configuração de origens e acionadores, consulte: