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

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

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

Com 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 último toque, ou seja, uma conversão é atribuída ao evento de origem correspondente mais recente. É possível ajustar esse comportamento nos relatórios de eventos e agregáveis.

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

Defina uma prioridade maior para as fontes que você quer priorizar. Valores maiores indicam uma prioridade mais alta. Por exemplo, um evento de origem com um priority de 2 tem precedência sobre uma origem com um priority de 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 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 no nível do evento

Ao contrário das prioridades do lado da origem, 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 faça quatro conversões: ele visita 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, 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, você pode configurar a API para receber relatórios de conversões que considera mais importantes, como o relatório de compras.

Para isso, adicione a chave priority ao cabeçalho de registro do gatilho 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 atuais para a mesma fonte.

  • Exclua o relatório com a menor prioridade para programar o novo. Se a nova denúncia for a de menor prioridade, ela será ignorada e você não vai recebê-la.

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

Analise o exemplo de código: prioritize conversions of type checkout

Próximas etapas

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