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 do Chrome 104, com novos mecanismos, funcionalidades e atualizações da API. ao serviço de agregação.

Qual é o público dessas atualizações?

Estas atualizações são úteis se:

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

Se você está começando a usar essa API e/ou ainda não testou vá direto para a introdução ao API.

Atualizações da API Attribution Reporting

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

A maioria das mudanças não requer nenhuma ação. Aqueles que precisam de atualizações para seu implementação foram destacados abaixo.

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

Os cabeçalhos foram unificados. Agora há apenas um cabeçalho para origens e um para acionadores, formatados em JSON.

Para registrar fontes de atribuição, responda a 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.

Esta mudança requer ação. Consulte a 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, faça o seguinte: continuam usando aggregation_keys, mas agora são armazenados como um dicionário JSON 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
 }

Esta mudança requer ação. Consulte a Manual da API (em inglês) para mais informações.

geração de relatórios;

Você pode optar por gerar apenas relatórios agregáveis, que podem ser agregados em relatórios resumidos. Se os filtros não corresponderem a nenhum acionador de evento, nenhum serão gerados relatórios de eventos.

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

A chave de depuração agora deve ser definida nos cabeçalhos de origem e acionador, em vez de com cabeçalhos separados. Saiba mais sobre como depurar .

Registrar fontes de atribuição

As tags de script agora podem ser usadas para registrar fontes de atribuição, assim como para a tag <img>.

Mais atualizações de API

Outras mudanças 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 no registro. de dados.
Cabeçalho Attribution-Reporting-Eligible adicionado à origem de entrada solicitações de registro.
Houve uma pequena alteração em encodeURIComponent.
A chave de orçamento de privacidade foi removida no 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 no relatórios agregáveis. Estamos desenvolvendo suporte para essa mudança na Serviço de agregação. Este documento será atualizado, assim como a registro de mudanças depois que as alterações forem enviadas.

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

Visão geral do ruído na geração de relatórios de resumo
Uma explicação detalhada de 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 testar o épsilon