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

A API Conversion Measurement vai mudar no Chrome 92.

O que está mudando?

Após as mudanças da proposta de API nos primeiros meses de 2021, a implementação da API no Chrome está evoluindo. Veja quais são as novidades:

  • O nome da API e o nome da política de permissões.
  • Os nomes dos 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, bem como os 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, apenas para cliques. Aguarde atualizações sobre isso. Após essa 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, que está estável em 20 de julho de 2021. A versão Beta do Chrome 92 foi lançada em 3 de junho de 2021.

O que você deve fazer?

Se você estiver executando um teste de origem ou tiver implementado uma demonstração para essa API, terá 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 novos do Chrome.
  • Opção 2: aguarde o lançamento de mais atualizações e recursos nas próximas versões 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 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.

O novo código será semelhante ao mostrado a seguir. 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 sua 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 as chaves a seguir:
source_event_id: anteriormente impression-data, o ID do evento de 64 bits definido na fonte 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.

Attribution Reporting: todos os recursos

Consulte Relatórios de atribuição.