Resumo da linha filtrada

As linhas que não forem agregadas corretamente para proteger a privacidade do usuário final ou que não atenderem a outras verificações de privacidade do Ads Data Hub serão descartadas dos resultados das consultas. É possível configurar um resumo de linha filtrada em consultas de análise para retornar uma única linha que inclui constantes e somas de linhas descartadas. Isso pode ajudar a evitar discrepâncias nos valores dos dados, como o total de impressões ou a contagem de cliques. Um resumo de linha filtrada é ativado por padrão para novas consultas de análise criadas usando a interface. Esses resumos não são usados em consultas de público-alvo. As consultas criadas usando a API não têm um resumo de linha filtrada ativado por padrão.

Importante: recomendamos usar ruído em vez de verificações de diferenças ao gerar seus relatórios. Quando você usa ruído, as linhas não são filtradas devido a verificações de diferenças, o que torna um resumo de linhas filtrado desnecessário. Para saber mais, consulte Injeção de ruído.

Importante: os requisitos de agregação ainda são usados nas colunas do resumo da linha filtrada. Se o resumo tiver menos de 50 usuários ou menos de 2 linhas, ele vai ser filtrado. No entanto, uma mensagem vai aparecer no resumo do status do job informando que houve uma filtração.

Exemplo

No exemplo a seguir, as linhas que contêm as campanhas 124 e 125 são filtradas, já que não atendem ao requisito de agregação de 50 usuários.

ID da campanha	Usuários
123	400
124	45
125	6

No entanto, usando um resumo de linha filtrada, os dados filtrados podem ser combinados para atender ao requisito de agregação de 50 usuários. Este exemplo usa uma soma para calcular os dados filtrados e uma constante para identificar a linha:

• Uma soma que agrega dados filtrados da coluna Users.
• Uma constante, usada para identificar o resumo de linha filtrada, definida como "Resumo da linha filtrada" na coluna Campaign ID.

ID da campanha	Usuários
Resumo da linha filtrada	51
123	400

Modo automático

Recomendamos usar o modo automático. Por padrão, o Ads Data Hub ativa e configura um resumo de linha filtrada para novas consultas criadas usando a interface. Quando você edita a consulta, o ADH ajusta a configuração com base nas colunas selecionadas.

• Para conferir as configurações configuradas automaticamente ao visualizar um relatório, clique em editar Editar. A configuração é exclusiva para leitura.
• Para desativar o modo automático, clique no botão Automático para a posição desativada. A configuração atual é mantida, e o modo automático é desativado. É necessário salvar a consulta para manter a alteração.
• Para ativar o modo automático, clique no botão Automático para ativar a posição. É necessário salvar a consulta para manter a alteração.
• Para alternar o modo automático com a API, use generateFilteredRowSummaryAutomatically.

Modo manual

Recomendamos usar o modo automático. Para adicionar manualmente um resumo de linha filtrada a uma consulta salva ou após desativar o modo automático:

1. No Ads Data Hub, abra a página "Relatórios".
2. Clique no nome do relatório que você quer editar.
3. Clique em edit Editar ao lado de Resumo das linhas filtradas gerado automaticamente.
4. Clique no botão de alternar Automático para a posição "Desativado". Observação: quando o modo automático está desativado, a configuração atual é mantida. Edite ou exclua essas regras conforme necessário.
5. Agrupar uma coluna usando uma soma. Se a soma estiver abaixo dos limites de agregação, o resumo da linha filtrada será descartado.
   1. Clique em Adicionar regra.
   2. Insira o nome da coluna a ser agregada no campo Nome da coluna.
   3. Selecione Soma na lista Tipo.
6. Adicione um rótulo para o resumo da linha filtrada usando uma constante. A constante precisa ser um tipo de dados válido para a coluna escolhida.
   1. Clique em Adicionar.
   2. Decida em qual coluna do resumo de linha filtrado você quer que o identificador apareça e insira o nome dessa coluna no campo Nome da coluna.
   3. Selecione Constante na lista Tipo.
   4. Insira um identificador útil para a linha, como "Resumo da linha filtrada", no campo Especificar constante.
7. Clique em Concluído.
8. Clique em Salvar para confirmar as alterações.

Modo manual com várias tabelas

Recomendamos usar o modo automático. Se você estiver exportando várias tabelas usando a sintaxe in-sql apresentada em Como exportar várias tabelas, adicione um resumo de linha filtrado nas opções da coluna:

CREATE TABLE `myproject.mydataset.mytable` (
    campaign_id INT64 OPTIONS(merge_constant=0),
    ct INT64 OPTIONS(merge_type="SUM")
  )
OPTIONS(privacy_checked_export=true) AS
SELECT campaign_id, COUNT(*) AS ct GROUP BY campaign_id;
    

Isso produz uma tabela de resultados com um resumo de linha filtrado em que campaign_id é 0, e ct é a soma das linhas que foram filtradas do resultado devido às verificações de privacidade.

Estas são as colunas disponíveis para o resumo da linha filtrada:

• merge_type="SUM": gera a soma dos valores filtrados na linha do resumo.
Válido apenas para tipos numéricos.
• merge_constant=<value>: define um valor constante na linha do resumo. Precisa ter o mesmo tipo da coluna.
• As colunas sem opção especificada mostram NULO na linha do resumo.

Só é possível especificar merge_type ou merge_constant. Todas as regras para resumos de linhas filtradas também são usadas aqui, ou seja, se a soma ficar abaixo dos limites de agregação, o resumo da linha filtrada vai ser descartado.