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() |
document.featurePolicy.features() |
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.