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

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

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

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

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

Defina uma prioridade mais alta para as fontes que você 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 a prioridade mais alta é enviado.

Exemplo de código

Altere 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 para relatórios de eventos

Ao contrário das prioridades da fonte, a definição de prioridades 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 visita a página inicial do site do anunciante, depois visita uma página de produto, se inscreve no boletim informativo e finalmente faz a compra.

No entanto, 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 compras.

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

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

Quando uma atribuição for 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 alcançado para essa origem, o navegador vai:

  • 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 prioridade mais baixa para programar o novo relatório. Se o novo relatório for aquele com a prioridade mais baixa, ele será ignorado e não será recebido.

Se nenhuma prioridade for definida, o navegador voltará ao comportamento padrão: qualquer conversão que ocorra depois da terceira conversão de cliques ou da primeira conversão de visualizações é descartada.

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

Próximas etapas

Para informações sobre como configurar origens e gatilhos, consulte: