Esta página foi traduzida pela API Cloud Translation.

Atualizações dos Relatórios de atribuição em junho de 2022

A proposta da Attribution Reporting vai mudar para a versão 104 do Chrome, com novos mecanismos de API, funcionalidades e atualizações no serviço de agregação.

Para quem são essas atualizações?

Estas atualizações são para você se:

Você já está familiarizado com a API, por exemplo, se estiver observando ou participando das discussões no repositório WICG e quiser entender as alterações feitas na API.
Você está usando a API Attribution Reporting em uma demonstração ou planeja fazer um teste de origem.

Se você está começando a usar essa API e/ou ainda não fez testes, vá diretamente para a introdução à API.

Atualizações da API Attribution Reporting

A demonstração da API Attribution Reporting foi atualizada para refletir as mudanças mais recentes na API Attribution Reporting do lado do cliente.

A maioria das mudanças não requer ação. Aquelas que exigem atualizações para sua implementação foram destacadas abaixo.

(Ação necessária) Cabeçalhos unificados para registro

Os cabeçalhos foram unificados. Agora há apenas um cabeçalho para origens e outro para gatilhos, formatado em JSON.

Para registrar fontes de atribuição, responda às solicitações de registro com o cabeçalho Attribution-Reporting-Register-Source.
Para concluir o registro do acionador, defina o cabeçalho Attribution-Reporting-Register-Trigger.

Essa mudança requer uma ação. Consulte o guia do desenvolvedor de API para mais informações.

(Ação necessária) As chaves de agregação agora são um dicionário

Para registrar fontes de atribuição, continue a usar aggregation_keys, mas agora ele está armazenado como um dicionário JSON em vez de uma lista.

Exemplo:

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

Essa mudança requer uma ação. Consulte o manual da API para mais informações.

geração de relatórios;

É possível gerar apenas relatórios agregáveis, que podem ser agregados em relatórios de resumo. Se os filtros não corresponderem a nenhum acionador de evento, nenhum relatório de evento será gerado.

Configuração unificada da chave de depuração

A chave de depuração agora será definida nos cabeçalhos da fonte e do acionador, e não com cabeçalhos separados. Saiba mais sobre como depurar relatórios.

Registrar fontes de atribuição

As tags de script agora podem ser usadas para registrar fontes de atribuição, de forma semelhante ao suporte para a tag <img>.

Mais atualizações da API

Outras alterações que foram feitas e citadas no manual da API incluem:

As origens podem ser registradas com APIs de solicitação JavaScript.
window.registerSource foi removido.
Agora é opcional incluir um valor para attributionsrc ao registrar fontes.
O cabeçalho Attribution-Reporting-Eligible foi adicionado às solicitações de registro de origem recebidas.
Houve uma pequena alteração em encodeURIComponent.
A chave do orçamento de privacidade foi removida do campo shared_info nos relatórios agregáveis.

Suporte para o serviço de agregação

No Chrome 104, pretendemos atualizar o formato de algumas informações dentro de relatórios agregáveis. No momento, estamos oferecendo suporte a essa mudança no serviço de agregação. Este documento e o registro de alterações serão atualizados depois que as alterações forem enviadas.

Reunimos um documento com dicas e estratégias práticas para gerar relatórios de resumo. Há vários insights, incluindo:

Visão geral do ruído na geração de relatórios resumidos
Uma explicação detalhada sobre dimensões, chaves e valores
Chaves de agregação na prática, incluindo um mapa da estrutura de chaves
Valores agregáveis na prática e implicações do orçamento de contribuição
Guia para experimentos com épsilon