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

A API Conversion Measurement está mudando no Chrome 92.

O que muda?

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

  • O nome da API e da política de permissões.
  • Os nomes dos atributos HTML e os 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, assim como os relatórios que teriam 0 crédito.

O conjunto de recursos compatíveis não mudou no Chrome 92: relatórios de evento, apenas para cliques. Aguarde mais informações. Depois dessa mudança, outras atualizações e recursos serão lançados em versões futuras do Chrome.

Quando essas mudanças vão entrar em vigor?

Essas mudanças vão entrar em vigor a partir do Chrome 92, versão estável de 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, tem duas opções:

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

Migrar

Exemplo de migração

Confira um exemplo de migração para um pequeno app de demonstração neste pull request (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 por window.open(). Atualize essas chamadas se você estiver usando window.open() para registrar fontes de atribuição.

O novo código vai ficar assim (essa renomeação segue a renomeação de atributos HTML):

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 de entrada 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 as seguintes chaves:
source_event_id: anteriormente impression-data, o ID de evento de 64 bits definido na origem de atribuição.
trigger_data: anteriormente conversion-data, o conjunto de dados de 3 bits no redirecionamento do acionador de atribuição.

⚠️ credit foi removido.

Relatórios de atribuição: todos os recursos

Consulte Relatórios de atribuição.