[Obsolete] Guia de migração (Chrome 92): API Conversion Measurement para a API Attribution Reporting

A API Conversion Measurement será alterada no Chrome 92.

O que muda?

Seguir as mudanças da proposta de API nos primeiros meses de 2021, a implementação da API no Chrome está evoluindo. Veja o que muda:

  • O nome da API e da política de permissões.
  • Os nomes de atributos HTML e URLs .well-known.
  • O formato dos relatórios. Os relatórios agora são enviados como JSON no corpo da solicitação.
  • O conteúdo dos relatórios credit foi removido, junto com relatórios que não teriam crédito.

O que permanece inalterado no Chrome 92 é o conjunto de recursos compatíveis: relatórios de eventos, somente para cliques. Vamos receber atualizações sobre isso. Depois dessa mudança, outras atualizações e recursos serão lançados em versões futuras do Chrome.

Quando essas mudanças entrarão em vigor?

Essas mudanças entram em vigor a partir do Chrome 92, estável em 20 de julho de 2021. O Chrome 92 Beta foi lançado em 3 de junho de 2021.

O que você deve fazer?

Se você estava executando um teste de origem ou implementou uma demonstração para essa API, você tem dois opções:

  • Opção 1 (recomendada): migre seu código agora ou nas próximas semanas, de preferência antes meados de julho de 2021. Dessa forma, sua base de código vai estar pronta para mudanças futuras e continuam funcionando para os clientes do Chrome mais recentes.
  • Opção 2: aguardar que mais atualizações e recursos sejam lançados em versões futuras do Chrome e fazer todas as mudanças necessárias no código de uma só vez.

Migrar

Exemplo de migração

Confira um exemplo de migração de um pequeno app de demonstração nesta solicitação de envio (rascunho).

Atualizar o código da política de permissões

Código legado Novo código
allow='conversion-measurement' allow='attribution-reporting'

Atualizar o código de detecção de recursos

Código legado Novo código
document.featurePolicy.features()
.includes('conversion-measurement')		 document.featurePolicy.features()
.includes('attribution-reporting')

Atualizar os atributos HTML

Código legado Novo código
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

Atualizar argumentos window.open()

Uma fonte de atribuição pode ser registrada para navegações iniciadas pelo window.open(). Atualize essas chamadas se você estiver usando window.open() para registrar fontes de atribuição.

Seu novo código deve ser semelhante a este (a renomeação segue os atributos HTML renomeação):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

Atualizar o URL e o parâmetro da chamada de registro

Código legado Novo código
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Atualizar o código do endpoint de relatórios

Código legado Novo código
Solicitações esperadas do navegador .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Relatórios recebidos Enviado como parâmetros de URL. Enviado como JSON no corpo da solicitação.

Os dados do relatório são incluídos no corpo da solicitação como um objeto JSON com o seguintes chaves:
source_event_id: antes impression-data, o ID do evento de 64 bits definido na fonte de atribuição.
trigger_data: antes conversion-data, o conjunto de dados de 3 bits no acionador de atribuição. redirecionamento.

⚠️ O item credit foi removido.

Attribution Reporting: todos os recursos

Consulte API Attribution Reporting.